ADK-3：谷歌ADK+Gemini+MCP集成
此存储库包含一个完整的工作流程，演示如何使用Google ADK、Gemini模型、重试安全API调用和MCP工具集成来构建、运行和管理LLM支持的代理。
🚀 这款笔记本解决了什么问题
1. 谷歌ADK设置
- 使用加载Google API密钥
UserSecretsClient - 初始化Gemini模型的环境变量
- 确保任何ADK项目的配置干净且可重用
2. 使用Google ADK创建代理
- 构建一个
LlmAgent使用Gemini模型(google.adk.models.google_llm.Gemini) - 配置会话、运行程序和消息传递
- 演示如何以编程方式编排代理
3. 强大的API重试机制
- 实现
HttpRetryOptions与：
- 自定义重试尝试 - 指数退避 - 基于状态码的重试逻辑
- 有助于避免429/500/503/504速率限制错误造成的故障
4. MCP（模型上下文协议）集成
- 演示如何连接到外部MCP服务器/工具集
- 使用：
- McpToolset - StdioConnectionParams - StdioServerParameters
- 使用带节点的Everything Server的示例设置(
npx)
- 演示如何使用其他工具功能扩展LLM代理
5. 基于UUID的会话管理
- 使用唯一ID用于：
- 追踪跑步记录 - 代理会话管理 - 有组织的对话日志
6. 端到端LLM工作流执行
- 使用运行配置的代理
Runner - 接受输入→ 生成响应→ 处理重试→ 使用工具
- 显示LLM代理的类似生产的管道
______________________________________________________________________
📁 文件结构
adk-3.ipynb # Complete notebook with ADK + Gemini + MCP pipeline______________________________________________________________________
🛠️ 使用的技术
- 谷歌ADK （代理开发工具包）
- Google Gemini API（Google.genai）
- MCP（模型上下文协议）
- python
- 用于会话处理的UUID
- 重试安全的API交互
______________________________________________________________________
▶️ 如何跑步
- 安装依赖项：
pip install google-genai google-adk- 设置API密钥：
export GOOGLE_API_KEY="YOUR_KEY"- 打开笔记本：
jupyter notebook adk-3.ipynb______________________________________________________________________
📌 主要亮点
- 清理ADK初始化工作流程
- Gemini代理创建的完整示例
- 可靠的重试机制
- 通过MCP增加刀具
- 生产就绪执行管道
______________________________________________________________________
📜 许可证
该项目在MIT许可证下发布。
______________________________________________________________________
如果你想要一个包含图表、徽章或安装脚本的更详细的自述文件，请请求更新版本。