为 Agent 开启联网搜索
联网搜索让 Agent 在回答问题或执行任务时，可以查询公开网页资料，并按需读取网页正文。它适合需要最新资料、外部公开信息或网页内容核验的场景，例如政策查询、行业资料收集、公开产品信息对比和网页内容摘要。
联网搜索不是知识库的替代品。知识库适合沉淀企业内部资料、制度文件和长期可复用内容；联网搜索适合临时查询公开网页，尤其是资料会频繁变化、暂时不适合入库的内容。
先准备联网搜索服务商
在 Agent 使用联网搜索前，需要先创建可用的联网搜索服务商，例如 Tavily。服务商通常需要配置 API Key、默认搜索参数和网页抓取参数。
建议按下面原则配置服务商：
- API Key 使用环境变量保存，不要写入提示词或页面文本。
- 根据业务场景设置合理的搜索深度、超时时间和最大结果数。
- 如果 Agent 经常需要总结网页正文，开启网页正文提取能力。
- 如果只需要搜索结果摘要，可以不开启正文提取，降低调用成本和响应时间。
服务商创建完成后，才能在 Agent 的联网搜索配置中选择。
在 Agent 中启用联网搜索
打开目标 Agent 编辑器，进入 运行与安全 -> 联网搜索，按需开启以下能力：
- 联网搜索：让 Agent 可以根据用户问题搜索公开网页。
- 网页读取：让 Agent 可以读取指定网页正文，适合对搜索结果、用户给出的 URL 或工具返回的 URL 做进一步核验。
启用后，Agent 在运行时会根据任务需要选择是否搜索或读取网页。开发者应在 System Prompts 中说明何时必须联网查询，何时优先使用知识库或业务数据。
配置搜索范围和返回内容
联网搜索配置通常包含以下项目：
| 配置项 | 作用 | 建议 |
|---|---|---|
| 搜索服务商 | 选择当前 Agent 使用哪个联网搜索服务 | 选择已经配置好 API Key 的服务商 |
| 最大结果数 | 控制每次搜索返回多少条候选结果 | 常见问答 3-5 条，资料调研可适当增大 |
| 时效范围 | 限制搜索结果的新鲜度 | 需要最新资料时选择更近范围，不要求时效时可放宽 |
| 语言区域 | 影响搜索结果语言和地域倾向 | 面向中文用户时选择中文或中国区域 |
| 是否抓取正文 | 搜索后是否进一步读取网页正文 | 需要核验原文、总结网页时开启 |
| 正文抓取页数 | 控制最多读取多少个搜索结果网页 | 建议从 1-3 页开始，避免上下文过大 |
| 正文长度限制 | 控制网页正文进入 Agent 上下文的最大长度 | 根据模型上下文和任务复杂度设置 |
如果 Agent 只需要回答“有哪些公开资料”，可以只开启搜索。如果 Agent 需要依据网页原文做总结、对比或引用，建议同时开启网页读取。
和知识库、文件空间如何分工
| 能力 | 适合内容 | 典型用途 |
|---|---|---|
| 联网搜索 | 公开网页、最新资料、临时外部信息 | 搜索新闻、政策、公开产品资料 |
| 知识库 | 企业资料、产品手册、制度文件、长期复用知识 | 基于内部资料稳定问答 |
| 文件空间 | 用户上传文件、Agent 生成文件、团队共享文件 | 读取附件、生成报告、保存中间产物 |
如果某类公开资料会被反复使用，建议将其整理后加入知识库；如果只是一次性调研或需要最新网页内容，使用联网搜索更合适。
编写提示词时说明联网边界
联网搜索开启后，Agent 并不会每轮都自动搜索。开发者需要在 System Prompts 中说明搜索策略，例如：
当用户询问公开网页资料、最新政策、近期市场信息或指定 URL 内容时，先使用联网搜索或网页读取核验资料，再回答。
当问题可以直接由知识库、业务数据或当前对话上下文回答时，不要联网搜索。
回答涉及网页资料时，优先说明资料来源和查询时间。
这样可以减少无意义搜索，也能让 Agent 在资料可能过期时主动核验。
安全与使用建议
- 不要把 API Key 写入 Agent 提示词、欢迎语或预置问题。
- 不要让 Agent 根据用户输入临时切换服务商，服务商应由开发者配置决定。
- 涉及内部制度、客户资料、合同和运营数据时，优先使用知识库、数据模型或文件空间，不要把内部资料作为搜索关键词发送到公开搜索服务。
- 读取用户提供的 URL 前，建议让 Agent 先说明将读取公开网页内容；涉及登录态、内网页面或敏感链接时不要读取。
- 搜索结果只能说明公开网页返回了什么，不能替代业务系统中的权限校验和数据核验。
典型场景
- 政策咨询：先联网搜索最新政策，再结合知识库中的内部制度回答。
- 竞品资料收集：搜索公开产品页面，读取网页正文后整理对比表。
- 网页摘要：用户提供 URL，Agent 读取正文并生成摘要。
- 资料核验：对用户提到的公开信息进行搜索确认，再给出谨慎回答。