phaseo:web_search。模型会决定何时搜索、编写查询,并可在一次请求中多次搜索。
Phaseo 会向模型返回 URL、标题、摘要片段、高亮内容以及可选的页面文本,帮助模型生成有依据的回复。
TinyFish Search 可作为可选的托管搜索引擎使用。受支持的路由仍可通过
engine: "native" 使用提供商原生搜索。工作方式
- 将
{ "type": "phaseo:web_search" }添加到tools。 - 模型判断是否需要搜索,并发出查询。
- Phaseo 使用已配置的搜索引擎执行搜索。
- 搜索结果会作为工具上下文返回给模型。
- 模型生成最终回复,并可按需再次搜索。
快速开始
配置
搜索引擎选择
engine: "native" 只能用于工具声明。如果模型在已发出的网关搜索调用中传入 engine: "native",Phaseo 会返回工具错误,因为必须在发送上游请求之前选择原生工具。
TinyFish Search
在 Phaseo 网关运行时密钥中配置TINYFISH_API_KEY 以启用引擎,然后在工具参数中选择它:
language 提供语言区域提示,page 选择 0 到 10 的结果页。TinyFish 支持两种域名筛选列表;Phaseo 将其转换为搜索运算符。结果包含 URL、标题和摘要/高亮片段。模型需要更完整的结果文本时,请使用 phaseo:web_fetch。
域名过滤
如果答案必须来自一组受控来源,请使用allowed_domains:
excluded_domains。
Perplexity 和 Firecrawl 在一次搜索调用中接受 allowed_domains 或 excluded_domains,不能同时使用两者。Perplexity 每个请求最多接受 20 个域名筛选条件,并将排除域名转换为其拒绝列表格式。 TinyFish 将两个数组转换为查询中的 site: 和 -site: 运算符。
TinyFish Search 在其公开计划中免费,因此 Phaseo 不会对 engine: "tinyfish" 增加提供商使用费;正常的 Phaseo 请求和令牌定价仍然适用。
Responses API
同一工具格式也适用于/v1/responses:
用量与定价
网页搜索调用会增加以下计数:server_tool_web_search_requests 和 server_tool_web_search_extra_results。如果模型价格卡定义了该计量项,供应商原生搜索用量可使用 native_web_search_requests。