ADK Python 快速入门¶
本指南将向你介绍如何开始使用 Agent Development Kit (ADK) for Python。在开始之前，请确保你已安装以下软件：
- Python 3.10 或更高版本
- 用于安装包的
pip
安装¶
运行以下命令安装 ADK：
推荐：创建并激活 Python 虚拟环境
创建一个 Python 虚拟环境：
激活 Python 虚拟环境：
创建智能体项目¶
运行 adk create 命令启动一个新的智能体项目。
探索智能体项目¶
创建的智能体项目具有以下结构，其中 agent.py 文件包含智能体的主要控制代码。
更新你的智能体项目¶
agent.py 文件包含一个 root_agent 定义，这是 ADK 智能体的唯一必需元素。你还可以为智能体定义要使用的工具。更新生成的 agent.py 代码，添加一个 get_current_time 工具供智能体使用，如以下代码所示：
from google.adk.agents.llm_agent import Agent
# 模拟工具实现
def get_current_time(city: str) -> dict:
"""返回指定城市的当前时间。"""
return {"status": "success", "city": city, "time": "10:30 AM"}
root_agent = Agent(
model='gemini-flash-latest',
name='root_agent',
description="报告指定城市的当前时间。",
instruction="你是一个有用的助手，可以报告城市的当前时间。使用 'get_current_time' 工具来实现。",
tools=[get_current_time],
)
设置你的 API 密钥¶
此项目使用需要 API 密钥的 Gemini API。如果你还没有 Gemini API 密钥，请在 Google AI Studio 的 API 密钥 页面创建一个。
在终端窗口中，将你的 API 密钥写入 .env 文件中作为环境变量：
在 ADK 中使用其他 AI 模型
ADK 支持使用多种生成式 AI 模型。有关在 ADK 智能体中配置其他模型的更多信息，请参阅模型与身份验证。
运行你的智能体¶
你可以使用 adk run 命令通过交互式命令行界面运行你的 ADK 智能体，或使用 adk web 命令通过 ADK Web 用户界面运行。两个选项都允许你测试和与智能体交互。
使用命令行界面运行¶
使用 adk run 命令行工具运行你的智能体。
使用网页界面运行¶
ADK 框架提供了你可以用来测试和与智能体交互的网页界面。你可以使用以下命令启动网页界面：
Note
从包含你的 my_agent/ 文件夹的父目录运行此命令。例如，如果你的智能体位于 agents/my_agent/ 内，则从 agents/ 目录运行 adk web。
此命令启动一个带有智能体聊天界面的 Web 服务器。你可以在 http://localhost:8000 访问网页界面。在左上角选择智能体并键入请求。
注意：ADK Web 仅限开发使用
ADK Web 不适用于生产部署。你应该仅将 ADK Web 用于开发和调试目的。
下一步：构建你的智能体¶
现在你已经安装了 ADK 并运行了你的第一个智能体，尝试使用我们的构建指南来构建你自己的智能体：