ADK-Rust 官方文档

欢迎来到 ADK-Rust（Rust 代理开发工具包）官方文档。本文档提供了使用 ADK 框架的 Rust 实现构建 AI 代理的全面指南和参考。

入门

• 简介 - ADK-Rust 概述、其架构和关键概念
• 快速入门 - 在 10 分钟内构建您的第一个代理

核心

• 核心类型 - 基本类型：Content、Part、Agent trait、Tool trait、上下文
• Runner - 代理执行运行时和配置

模型

• 模型提供者 - LLM 集成：Gemini、OpenAI、Anthropic、DeepSeek、Groq、Ollama
• Ollama - 使用 Ollama 进行本地推理
• mistral.rs 集成 - 用于高性能本地推理的原生 mistral.rs

代理

• LlmAgent - 使用大型语言模型的 LlmAgent 核心代理类型
• 工作流代理 - 确定性代理：Sequential、Parallel、Loop
• 多代理系统 - 使用子代理构建代理层级结构
• Graph Agents - LangGraph 风格的工作流编排
• 实时代理 - 支持语音的 OpenAI/Gemini 代理

工具

• Function Tools - 使用 async Rust 函数创建自定义工具
• 内置工具 - 像 GoogleSearchTool 这样的预构建工具
• MCP 工具 - 模型上下文协议集成
• 浏览器工具 - 46 个 WebDriver 工具用于网络自动化
• UI 工具 - 使用表单、卡片、图表进行动态 UI 生成

会话与状态

• 会话 - Session 管理和生命周期
• 状态管理 - 使用前缀管理对话状态

回调与事件

• 回调 - 拦截和自定义代理行为
• 事件 - 理解事件系统和对话历史

工件

• 工件 - 二进制数据存储和检索

可观测性

• 遥测 - 日志记录、追踪和监控

部署

• 启动器 - 在控制台或服务器模式下运行代理
• 服务器 - REST API 和 Web UI 集成
• A2A 协议 - Agent-to-Agent 通信

评估

• 代理评估 - 测试和验证代理行为

安全

• 访问控制 - 基于角色的权限和审计日志
• 护栏 - PII 匿名化、内容过滤、模式验证
• 内存 - 代理的长期语义内存

工作室

• ADK Studio - 用于构建代理的可视化开发环境

开发

• 开发指南 - 贡献指南和最佳实践

---

验证状态

本文档中的所有代码示例都通过 official_docs_examples/ 包中的工作示例进行了验证。每个文档页面都有相应的示例，可以成功编译和执行。