Google Cloud Agent SDK Master

Google Cloud Agent SDK Master 是一个专注于 Google 智能体开发与部署的技能，围绕 Google 的 Agent Development Kit（ADK）和 Agent Starter Pack 展开，目标是帮助构建和部署生产级容器化智能体。

一、用途 该技能用于自动激活与 Google Cloud ADK 及 Agent Starter Pack 相关的操作，包括多智能体系统、容器化部署、RAG 等场景。它面向需要基于 Google Cloud 构建生产级智能体的开发者。

二、主要能力

1. Agent Development Kit（ADK）：Google 开源 Python 框架，据资料称与 Google Agentspace 和 CES 使用同一框架，可用少于 100 行代码构建生产智能体，模型无关（针对 Gemini 优化），部署无关（本地、Cloud Run、GKE、Agent Engine）。
2. 支持的智能体类型：LLM Agents（动态路由）、Workflow Agents（Sequential 线性执行、Loop 迭代处理、Parallel 并发执行）、Custom Agents（用户自定义实现）、Multi-agent Systems（分层协调）。
3. 关键特性：灵活编排（工作流与 LLM 驱动）、工具生态（搜索、代码执行、自定义函数）、第三方集成（LangChain、CrewAI）、Agents-as-tools、内置评估框架、Cloud Trace 集成。
4. Agent Starter Pack 生产模板：adk_base（使用 ADK 的 ReAct 智能体）、agentic_rag（文档检索与问答）、langgraph_base_react（LangGraph ReAct 实现）、crewai_coding_crew（多智能体编码系统）、adk_live（多模态 RAG，音频/视频/文本）。
5. 基础设施自动化：单命令 CI/CD 设置、GitHub Actions 或 Cloud Build 流水线、多环境支持（dev、staging、prod）、自动化测试与评估、部署回滚机制。

三、部署目标

1. Vertex AI Agent Engine：全托管运行时、自动扩缩容与负载均衡、内置可观测性、无服务器架构，适合生产规模智能体。
2. Cloud Run：容器化无服务器、按使用付费、自定义域名、流量拆分，适合面向 Web 的智能体。
3. Google Kubernetes Engine（GKE）：完整容器编排、高级网络、资源管理、多集群支持，适合复杂多智能体系统。
4. 本地/Docker：开发与测试、自定义基础设施、本地部署，适合 POC 与调试。

四、使用方式 安装命令：

Agent Starter Pack（推荐）

pip install agent-starter-pack

或直接从 GitHub

uvx agent-starter-pack create my-agent

仅 ADK

pip install google-cloud-aiplatform[adk,agent_engines]>=1.111

创建智能体（ADK）示例： from google.cloud.aiplatform import agent from vertexai.preview.agents import ADKAgent

@agent.adk_agent class MyAgent(ADKAgent): def init(self): super().init( model="gemini-2.5-pro", tools=[search_tool, code_exec_tool] )

def run(self, query: str):
    return self.generate(query)

使用 Agent Starter Pack 创建项目： uvx agent-starter-pack create my-rag-agent
--template agentic_rag
--deployment cloud_run

部署到 Cloud Run： adk deploy
--target cloud_run
--region us-central1
--service-account sa@project.iam.gserviceaccount.com

部署到 Agent Engine： asp deploy
--env production
--target agent_engine

五、适用场景 该技能在提及以下内容时自动激活：智能体开发、ADK 或 Agent Starter Pack、多智能体系统或编排、容器化智能体部署、Cloud Run/GKE/Agent Engine 部署、RAG 智能体或 ReAct 智能体、智能体模板或脚手架、智能体 CI/CD、生产智能体系统。

六、限制与说明 资料未提供该技能本身的收费、价格、平台限制或效果保证。文中涉及的定价示例（如 Cloud Run $0.00024/GB-second、Gemini API $3.50/1M tokens 等）为资料原文所列，具体以官方为准。部分代码示例为示意，实际使用需结合项目配置。