ADK Python 智能体
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kunlungrowth/google-adk-python。
技能介绍
先解决什么问题
把 LLM 调用包成函数并不难,难的是让智能体像软件一样被维护:工具如何与编排逻辑分离,多智能体之间如何分工,工作流如何可预测地执行,敏感操作如何人工兜底,以及系统上线后如何评估与迁移。ADK 智能体技能针对这些工程化场景,用 代码优先 的思路把需求转换为结构化的 AgentPlan,再落地到部署目标。
它如何工作
该技能围绕六步展开:
- 选型:动态路由或自适应任务用
LlmAgent;需要确定性管线时用SequentialAgent、ParallelAgent、LoopAgent;要完全自定义时继承BaseAgent。 - 工具生态:接入
google_search、code_execution;用Tool.from_function将 Python 函数转为工具;通过 OpenAPI 集成既有服务;对敏感操作开启tool_confirmation=True。 - 多智能体架构: coordinator 通过
sub_agents委派,形成层级或领域专家结构。 - 实现模式:支持单智能体带工具、多智能体协调、自定义工具、顺序/并行/循环工作流与人工确认流。
- 部署:本地开发 UI 调试,再迁到
Cloud Run、Vertex AI Agent Engine或自定义基础设施。 - 工程实践:强调版本控制、测试、评估驱动;模型优先为 Gemini,也可通过标准 API 接其他 LLM。
输出会包含 AgentPlan 工件(架构、智能体、工作流、部署)与自然语言说明,便于交接给 mcp-builder、context-engineering、devops 等下游。
适用边界
仅面向 Python 的 Google ADK,不支持 Java 等其他实现。密钥、配额与权限由用户管理。AgentPlan 偏向设计层面,性能优化与运行监控仍需在具体代码中验证。
使用场景
- 为带工具调用的智能体服务写 Python 代码,需要把动态路由、模型选型和工具清单固化进代码库
- 用 SequentialAgent 或 ParallelAgent 把搜索、总结、写作等步骤串成可预测的确定性管线
- 把自定义 Python 函数或 OpenAPI 服务封装成工具,并对敏感操作开启 tool_confirmation 人工确认
- 智能体开发完成后需要部署到 Cloud Run 或 Vertex AI Agent Engine,并配套测试与评估脚本
适合人员
- 要在生产环境发布智能体服务、需要版本化管理代码的后端工程师
- 负责工具调用治理、需要把敏感操作纳入人工确认流程的技术负责人
- 用 LLM 搭建研究或内容管线、需要步骤可预测的产品开发者
- 准备部署到 Cloud Run 或 Vertex AI 并建立评估体系的 AI 应用工程师