教程1：你的第一个ADK代理

教程 1：你的第一个 ADK 代理

欢迎来到 Google ADK 之旅的第一步！本教程将向你介绍使用 Google 的 Agent Development Kit 创建一个简单 AI 代理的基本概念。

你将学到的内容

• 基础代理创建：如何创建你的第一个 ADK 代理
• ADK 工作流程：理解代理的生命周期
• 简单的文本处理：基本的输入/输出处理
• 代理配置：必要的参数和设置

核心概念：什么是 ADK 代理？

ADK 代理是一种可编程的 AI 助手，它可以：

• 处理用户输入（文本、图片等）
• 使用 AI 模型（如 Gemini）来理解和回应
• 根据你的指令执行特定任务
• 返回结构化或非结构化的响应

把它想象成一个利用 AI 处理复杂任务的智能函数。

关键组件

1. LlmAgent 类

ADK 中创建 AI 代理的主要构建模块：

from google.adk.agents import LlmAgent
​

2. 必要参数

• name: Unique identifier for your agent
• model: The AI model to use (e.g., "gemini-3-flash-preview")
• description: What your agent does
• instruction：你的代理应如何表现

3. 基本工作流程

1. 输入：用户发送消息
2. 处理：代理使用 AI 模型理解并回应
3. 输出：代理返回响应

教程概览

在本教程中，我们将创建一个创意写作代理，它能够：

• 帮助用户构思故事点子和角色
• 提供写作提示和灵感
• 协助规划情节结构和节奏
• 展示 ADK 的基本功能

项目结构

1_starter_agent/
├── README.md              # This file - concept explanation
├── requirements.txt       # Dependencies
└── creative_writing_agent/ # Agent implementation
    ├── __init__.py       # Makes it a Python package
    └── agent.py          # Main agent code
​

学习目标

完成本教程后，你将掌握：

• ✅ 如何创建一个基础 ADK 代理
• ✅ 必要的代理参数及其用途
• ✅ 如何运行和测试你的代理
• ✅ ADK 的基本工作流程和生命周期

开始使用

1. 设置你的环境：

   # Make sure you have 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: creative_writing_agent
   ​

4. 测试你的代理：

   • 尝试请求故事点子：“我想写一个关于魔法森林的故事”
   • 获取角色帮助：“帮我为我的科幻故事创造一个主角”
   • 请求写作提示：“给我一个创意写作提示”
   • 询问情节建议：“我该如何安排故事的高潮？”

下一步

完成本教程后，你将准备好：

• 教程 2：模型无关代理 —— 创建能与不同 AI 模型协作的代理
• 教程 3：结构化输出代理 —— 学习如何创建类型安全、结构化的响应
• 教程 4：工具使用代理 —— 为你的代理添加自定义工具和功能

专业小贴士

• 从简单开始：先从基础功能入手，逐步增加复杂性
• 多加测试：使用 ADK 的网页界面测试你的代理
• 仔细阅读说明：清晰的说明有助于代理更好地运行
• 大胆尝试：试试不同的模型和参数，看看它们的差异

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