O que Especialista em Implantação ADK faz?
Visão Geral
Especialista em construir e implantar sistemas multiagentes de produção usando o Agent Development Kit (ADK) do Google. Lida com orquestração de agentes (Sequencial, Paralelo, Loop), comunicação via protocolo A2A, Sandbox de Execução de Código para operações GCP, Banco de Memória para conversas com estado e implantação no Vertex AI Agent Engine.
Pré-requisitos
- Um projeto do Google Cloud com Vertex AI ativado (e permissões para implantar runtimes do Agent Engine)
- ADK instalado (e fixado na versão suportada pelo projeto)
- Um contrato de agente claro: ferramentas necessárias, padrão de orquestração e alvo de implantação (local vs Agent Engine)
- Um plano para segredos/credenciais (OIDC/WIF quando possível; nunca commitar chaves de longa duração)
Instruções
- Confirme a arquitetura desejada (agente único vs multiagente) e o padrão de orquestração (Sequencial/Paralelo/Loop).
- Defina as interfaces AgentCard + A2A (entradas/saídas, envio de tarefas e expectativas de polling de status).
- Implemente o(s) agente(s) com a superfície de ferramentas mínima necessária (Sandbox de Execução de Código e/ou Banco de Memória conforme necessário).
- Teste localmente com prompts representativos e casos de falha, depois adicione testes de verificação para implantação.
- Implante no Vertex AI Agent Engine e valide os endpoints gerados (
/.well-known/agent-card, APIs de envio/status de tarefas). - Adicione observabilidade: logs, dashboards e comportamento de retry/backoff para falhas transitórias.
Saída
- Arquivos fonte do agente (ou patches) prontos para implantação
- Comandos/configuração de implantação (ex.: invocação
adk deploy+ flags necessárias) - Uma lista de verificação para endpoints do Agent Engine (AgentCard + APIs de tarefas) e postura de segurança
Tratamento de Erros
Consulte ${CLAUDE_SKILL_DIR}/references/errors.md para tratamento abrangente de erros.
Exemplos
Consulte ${CLAUDE_SKILL_DIR}/references/examples.md para exemplos detalhados.
Recursos
- Documentação do ADK: https://cloud.google.com/vertex-ai/docs/agent-engine
- Workload Identity (CI/CD): https://cloud.google.com/iam/docs/workload-identity-federation
- Padrões A2A / AgentCard: consulte
000-docs/6767-a-SPEC-DR-STND-claude-code-plugins-standard.md