借助 Google 搜索工具，智能体可以根据网络上的最新信息生成回答，从而有效地将对话与现实世界的数据相关联。 此工具非常适合需要世界知识、时事或广泛主题的场景。
配置
创建工具时，请配置以下设置：
- 名称：工具实例的显示名称（例如：
search_web）。 - 说明： 工具用途的简要说明。推理智能体会根据此说明来决定何时调用该工具。
- 排除的网域：要从搜索结果中排除的网域列表（最多 2,000 个）。 例如：“www.example.com”或“example.com”
- 首选网域：用于限制搜索结果的网域列表（最多 20 个）。 例如：“www.example.com”或“example.com”
- 上下文网址： 要提取以用于接地上下文的具体网址（最多 20 个）。 模型会直接使用这些网页中的内容。 例如：“example.com/page/path”
- 模态：
自定义智能体如何处理和总结不同模态的搜索结果：
- 文本提示：用于在文本对话中处理搜索结果的指令。
- 语音提示：用于在语音对话中处理搜索结果的指令（例如，保持回答简洁自然，避免朗读原始网址）。
设置优先级
网域和网址设置按以下顺序应用：
- 排除的网域：优先级最高。即使网域列在上下文网址或首选网域中，也会被排除。
- 上下文网址：除非排除相应网域，否则系统会提取内容。
- 首选网域：优先级最低。
运行时上下文网址
除了在工具配置中提供上下文网址外，您还可以指示智能体在运行时动态注入网址。
例如，您可以在代理指令中添加以下内容：
none
If the user query is about x, look into these urls url1, url2, url3 using
the 'Product Information Search' tool.
引用和文内引用
当智能体使用 Google 搜索工具依托网页内容生成回答时，运行时回答会在 SessionOutput.citations 中包含引用元数据，以便将生成的陈述追溯到网页来源。
引用元数据包含两个主要组成部分：
- 引用块 (
cited_chunks)：用于提供依据的源文档列表，包括来源uri、网页title、摘要text和requires_attribution指标。 - 内嵌引用 (
inline_citations)：响应文本中直接映射到cited_chunk_indices的精确字节范围偏移量（start_index和end_index）。您可以在客户端应用中使用内嵌引用来呈现交互式上标徽章、脚注或内嵌链接，这些链接锚定到代理的回答中的特定声明。
署名要求
从网络接地返回的引用可能需要注明原始来源：
- 检查每个
CitedChunk上的requires_attribution字段。 - 如果
requires_attribution为true，您的客户端应用必须向最终用户显示来源归因信息并链接到来源 URI。