带结构化输出的客户支持工单处理代理

本教程演示如何使用 Google 的 ADK（代理开发套件）框架实现结构化的客户支持工单系统。此示例展示了如何利用 Pydantic 模式和 Gemini 3 Flash 模型，创建类型安全、结构化的支持工单，包括优先级、类别和解决时间预估。

教程特色

• 结构化支持工单：

• 学习如何创建全面的支持工单模式

• 理解优先级级别与分类方式

• 了解如何预估解决时间

• 高级模式设计：

• 包含枚举和可选字段的复杂 Pydantic 模型

• 正确的字段校验与描述

• 类型安全的结构化响应

• 真实应用场景：

• 实用的客户支持用例

• 展示如何处理不同类型的支援请求

• 演示面向业务流程的结构化输出

• 优先级管理：

• 四级优先级体系（低、中、高、紧急）

• 根据问题描述自动分配优先级

• 基于类别的路由以适配不同部门

开始使用

1. 设置你的环境：

   cd 3_1_customer_support_ticket_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. 选择“support_ticket_creator”代理
   3. 输入你的支持请求（例如：“我无法登录我的账户，而且两小时后有个重要的会议”）
   4. 返回结果将是一个包含所有工单详情的结构化 JSON

教程概览

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

1. 复杂模式设计：学习如何创建复杂的 Pydantic 模型
2. 枚举使用：理解如何为受限值使用枚举
3. 可选字段：了解如何处理带有默认值的可选数据
4. 业务逻辑：学习如何实现真实的业务流程

代码结构

• customer_support_agent/agent.py: Contains the main agent definition and SupportTicket schema
• customer_support_agent/__init__.py：模块初始化，方便导入

支持工单模式

该代理创建的结构化工单包含以下字段：

• title：问题的简明摘要
• description：详细的问题描述
• priority：优先级（低、中、高、紧急）
• category：所属部门（技术、账单、账户、产品）
• steps_to_reproduce：可选的技术问题步骤列表
• estimated_resolution_time：预计解决时间

示例使用

输入：“我的付款失败了，而且我被重复扣款两次”

输出：

{
  "title": "Duplicate payment charge issue",
  "description": "Customer reports payment failure followed by duplicate charges for the same service",
  "priority": "high",
  "category": "Billing",
  "steps_to_reproduce": null,
  "estimated_resolution_time": "4-6 hours"
}
​

依赖项

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

结构化输出的工作原理

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

1. 输入处理：接收自然语言形式的支持请求
2. 上下文分析：分析问题的严重程度与类型
3. 结构化生成：创建包含所有必要字段的完整工单
4. 校验：确保输出符合定义的模式与业务规则

这种方法展示了如何在 Google ADK 应用程序中创建可靠且适合业务需求的结构化响应。

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