Skip to content

ADK 的 Enterprise Web Search 工具

Supported in ADKPython v1.9.0TypeScript v1.5.0

Google Cloud Enterprise Web Search 能够通过网络信息为 ADK 智能体提供事实依据，同时保持企业合规性和来源控制。该工具专为企业级工作负载设计，确保基础数据符合组织的安全和合规策略。

Enterprise Web Search 与 Agent Search 的区别

Enterprise Web Search 与 Agent Search 不同。Agent Search 查询已索引的私有数据存储，而 Enterprise Web Search 则检索合规的公共网络数据。

特定服务条款

使用 Enterprise Web Search 工具时，你有义务遵守 Google 的特定服务条款，包括在界面中正确显示搜索建议和所需的 Google 标识。

使用场景

  • 企业基础信息：为智能体提供最新的网络信息，同时保持组织合规标准。
  • 受控网络访问：确保智能体在进行研究、市场情报或客户支持任务时查询可信赖的网络来源。
  • 受监管的工作流：在需要严格审计和数据治理的环境中部署基础信息检索能力。

前置条件

  • 拥有启用了 Agent Search 的 Google Cloud Platform 访问权限。
  • 已配置 GCP 项目，并具有 Gemini 模型所需的权限。
  • 必须设置环境变量 GOOGLE_GENAI_USE_ENTERPRISE=TRUE。
  • 已安装 google-adk 包（Python）或 @google/adk 包（TypeScript）：
pip install google-adk

npm install @google/adk

与智能体配合使用

以下示例展示了如何使用预实例化的 enterprise_web_search 工具配置 ADK 智能体：

from google.adk.agents import Agent
from google.adk.tools import enterprise_web_search

root_agent = Agent(
    model="gemini-flash-latest",
    name="enterprise_search_agent",
    instruction="使用符合企业合规要求的网页搜索结果准确回答用户问题。",
    tools=[enterprise_web_search],
)

import { LlmAgent, ENTERPRISE_WEB_SEARCH } from "@google/adk";

const rootAgent = new LlmAgent({
  model: "gemini-flash-latest",
  name: "enterprise_search_agent",
  instruction: "使用符合企业合规要求的网页搜索结果准确回答用户问题。",
  tools: [ENTERPRISE_WEB_SEARCH],
});

export { rootAgent };

选择指导

  • 对于需要在任意 Gemini 模型上实现广泛网络覆盖的通用应用，请使用标准 Google Search。
  • 在构建需要合规控制、来源审计且部署在 Gemini 2+ 模型上的企业智能体时，请使用 Enterprise Web Search。

更多资源