内置工具

内置工具

Google ADK 提供了功能强大的预构建工具，这些工具经过优化，具备卓越的性能和可靠性。它们可与 Gemini 模型无缝集成，并提供诸如网页搜索和代码执行等关键功能。

你将学到的内容

• 搜索工具：用于实时获取信息的网页搜索功能
• 代码执行工具：安全的 Python 代码执行环境
• 工具局限性：了解何时使用内置工具而非自定义工具
• 最佳实践：优化内置工具的使用方式

核心概念：内置工具

内置工具是 Google ADK 的原生功能，具有以下特点：

• 高性能：针对速度和可靠性进行了优化
• 安全性：内置安全机制和沙箱隔离
• Gemini 集成：与 Google 模型深度集成
• 免维护：无需维护自定义代码

重要限制

• ⚠️ 仅限 Gemini 模型：内置工具仅适用于 Gemini 模型
• ⚠️ 单一工具类型：同一智能体中不可混用内置工具与自定义工具
• ⚠️ 定制化有限：功能固定，无法修改行为

可用的内置工具

1. 搜索工具

• 用途：用于实时获取信息的网页搜索功能
• 应用场景：新闻、事实、时事、研究
• 优势：结果快速、准确、最新

2. 代码执行工具

• 用途：安全地执行 Python 代码
• 应用场景：计算、数据处理、算法实现
• 优势：安全的沙箱环境

3. RAG 工具（高级）

• 用途：检索增强生成
• 应用场景：文档搜索、知识库
• 优势：高效的信息检索能力

教程示例

本子示例包含两个实用实现：

搜索智能体

位置：./search_agent/

• 实现网页搜索功能
• 处理实时信息查询
• 展示搜索结果的处理过程

代码执行智能体

位置：./code_exec_agent/

• 安全地执行 Python 代码
• 进行数学计算
• 动态处理数据

项目结构

1_builtin_tools/
├── README.md                    # This file - built-in tools guide
├── search_agent/               # Web search implementation
│   ├── __init__.py            # Makes it a Python package
│   ├── agent.py               # Search agent with Search Tool
├── code_exec_agent/           # Code execution implementation
│   ├── __init__.py            # Makes it a Python package
│   ├── agent.py               # Code execution agent
└── requirements.txt           # Dependencies for built-in tools
└── .env.example              # Example API key configuration
​

学习目标

完成本子示例后，你将掌握：

• ✅ 如何高效使用 Google ADK 的搜索工具
• ✅ 如何通过内置工具安全地执行代码
• ✅ 何时选择内置工具而非自定义解决方案
• ✅ 内置工具的局限性和最佳实践

开始使用

1. 设置你的环境：

   cd 4_1_builtin_tools
   
   # Copy the environment template
   cp env.example .env
   
   # Edit .env and add your Google AI API key
   # Get your API key from: https://aistudio.google.com/
   ​

2. 安装依赖项：

   # Install required packages
   pip install -r requirements.txt
   ​

3. 运行智能体：

   # Start the ADK web interface
   adk web
   
   # In the web interface, select either:
   # - search_agent: For trying web search capabilities
   # - code_exec_agent: For testing code execution features
   ​

专业提示

• 用于实时数据：非常适合当前的信息需求
• 充分利用 Gemini 集成：内置工具专为 Gemini 优化
• 简单更佳：如果内置工具足够，不要过度复杂化自定义工具
• 充分测试：在投入生产前务必充分理解工具的行为

常见应用场景

搜索工具的应用场景

• 新闻更新：获取主题的最新资讯
• 事实核查：验证信息的准确性
• 研究工作：收集各类主题的信息
• 市场数据：获取当前价格和趋势

代码执行的应用场景

• 数学计算：处理复杂的计算任务
• 数据分析：处理并分析数据
• 算法实现：测试代码逻辑
• 可视化：生成图表和图形

重要提示

• 模型依赖：仅适用于 Gemini 模型
• 禁止混用：不可与自定义工具混合使用
• 生产就绪：内置工具已达到企业级应用标准
• 速率限制：请注意使用中的速率限制

免责声明：
本文档采用基于机器的 AI 翻译服务进行翻译。尽管我们力求准确，但请注意，自动翻译可能存在错误或不准确之处。应以原文语言版本的原始文档作为权威依据。如需获取关键信息，建议使用专业的人工翻译。对于因使用本翻译而产生的任何误解或误读，我们概不负责。