带结构化输出的电子邮件生成代理

本教程演示如何使用 Google 的 ADK（代理开发套件）框架实现结构化输出。此示例采用电子邮件生成代理，展示如何借助 Pydantic 模型和 Gemini 3 Flash 模型创建类型安全、结构化的响应。

教程特色

• 结构化输出实现：

• 学习如何使用 Pydantic 模型进行类型安全的输出

• 理解如何定义结构化的响应格式

• 了解 Google ADK 如何处理结构化响应

• 电子邮件生成器示例：

• 以电子邮件生成作为实际用例的实用示例

• 展示如何创建具有恰当结构的专业电子邮件内容

• 演示结构化输出在现实场景中的应用

• Google ADK 最佳实践：

• 简单的代理定义与清晰的说明

• 正确使用输出模式以获得可靠的结果

• 极简的代码库，充分展现核心概念

开始使用

1. 设置你的环境：

   cd 3_2_email_agent
   
   # 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. 安装依赖项：

   # Navigate back to the directory
   cd ..
   
   # Install required packages
   pip install -r requirements.txt
   ​

3. 运行代理

   # Start the ADK web interface
   adk web
   ​

   然后：

   1. 在浏览器中打开网页界面
   2. 选择“email_generator_agent”
   3. 输入你的邮件请求（例如：“写一封专业邮件，与客户预约会议”）
   4. 响应将是一个包含主题和正文字段的结构化 JSON

教程概览

本教程演示了在 Google ADK 中实现结构化输出的过程：

1. 代理定义：学习如何创建 LlmAgent with Gemini 3 Flash
2. Output Schema: Understand how to use Pydantic models for structured responses
3. Instructions: See how to write clear prompts for structured output
4. Structured Response: Learn how to handle JSON responses with defined schemas

Code Structure

• agent.py: Contains the main agent definition and Pydantic schema
• __init__.py: Module initialization for easy imports

Dependencies

• google-adk: Google's Agent Development Kit
• pydantic：数据验证与设置管理

结构化输出的工作原理

本教程展示了 Google ADK 如何处理结构化输出：

1. 输入处理：接收自然语言请求，并通过代理进行处理
2. 内容生成：利用 Gemini 3 Flash 根据指令生成内容
3. 输出结构化：自动按照 Pydantic 模式对响应进行格式化
4. 响应验证：确保输出符合定义的结构与类型

这种方法展示了如何在 Google ADK 应用中创建可靠且类型安全的响应。

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