调试网络搜索请求

如果网络搜索请求的行为与预期不符，请使用本指南确认 Phaseo 是否已接受请求、是否正确路由，以及是否返回了正常的搜索结果。

​

1. 明确表达搜索意图

不要只依赖提示词措辞。请在请求中直接加入搜索设置，让 Phaseo 知道你要使用网络搜索。 检查是否包含：

• tools 中的原生搜索工具
• 端点支持时使用的 web_search_options

​

2. 确认是否有兼容的提供商

如果请求被阻止或路由结果与预期不同，请检查请求详情中的：

• 候选提供商详情
• 提供商启用详情
• 路由说明

这样可以确认提供商列表是否因缺少搜索支持而被缩小。

​

3. 检查使用量计数器

成功的搜索请求应显示与搜索相关的使用量指标，例如：

• 请求的原生网络搜索工具
• 网络搜索结果
• 引用

这是确认请求确实使用了搜索的最快方式。

​

4. 检查搜索结果部分

对于成功的请求，请打开请求详情对话框，找到网络搜索可观测性部分。 该部分会显示：

• 是否使用了原生搜索
• 规范化后的结果数量
• 规范化后的引用数量
• 提取出的结果记录
• 提取出的引用记录

无需查看原始负载，即可比较不同提供商的行为。

​

5. 区分以下情况

目前已支持原生搜索和提供商能力检查。搜索回退计划是单独的功能。 调试时请区分：

1. 原生搜索请求已被接受并路由。
2. 请求已被接受，但没有兼容的提供商可用。
3. 请求已成功，但返回的引用质量较差或数量较少。

这些是不同的问题，应分别排查。

​

6. 结果异常时要比较哪些内容

比较不同请求的：

• 模型 ID
• 实际选中的提供商
• 请求的搜索选项
• 结果数量
• 引用数量
• 路由详情

如果结果质量因提供商而异，规范化日志仍应能体现这一点。

​

相关内容

• 路由与回退
• 示例
• TypeScript SDK