> ## Documentation Index
> Fetch the complete documentation index at: https://phaseo.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 调试网络搜索请求

> 验证网络搜索请求、确认提供商支持情况，并检查返回的搜索结果和引用。

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

## 1. 明确表达搜索意图

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

检查是否包含：

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

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

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

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

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

## 3. 检查使用量计数器

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

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

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

## 4. 检查搜索结果部分

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

该部分会显示：

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

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

## 5. 区分以下情况

目前已支持原生搜索和提供商能力检查。搜索回退计划是单独的功能。

调试时请区分：

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

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

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

比较不同请求的：

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

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

## 相关内容

* [路由与回退](../guides/routing-and-fallbacks.mdx)
* [示例](../guides/examples.mdx)
* [TypeScript SDK](../sdk-reference/typescript/overview.mdx)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.