O que Construtor de Agentes ADK faz?
Construa agentes prontos para produção com o Google Agent Development Kit (ADK): scaffolding, integração de ferramentas, padrões de orquestração, testes e deploy opcional no Vertex AI Agent Engine.
Visão Geral
- Cria um scaffold ADK mínimo e voltado para produção (ponto de entrada do agente, registro de ferramentas, configuração e testes).
- Suporta fluxos de trabalho ReAct de agente único e orquestração multi-agente (Sequencial/Paralelo/Loop).
- Produz uma checklist de validação adequada para CI (lint/testes/prompts de fumaça) e verificação opcional de deploy no Agent Engine.
Pré-requisitos
- Runtime Python compatível com seu projeto (geralmente Python 3.10+)
google-adkinstalado e importável- Se for fazer deploy: acesso a um projeto do Google Cloud com Vertex AI ativado e permissões para implantar runtimes do Agent Engine
- Segredos disponíveis via variáveis de ambiente ou um gerenciador de segredos (nunca codificados diretamente)
Instruções
- Confirme o escopo: scaffold de agente apenas local vs. deploy no Vertex AI Agent Engine.
- Escolha uma arquitetura:
- Agente único (ReAct) para tarefas adaptativas orientadas por ferramentas
- Sistema multi-agente (especialistas + orquestrador) para fluxos de trabalho complexos e de múltiplas etapas
- Defina a superfície de ferramentas (ferramentas ADK integradas + quaisquer ferramentas personalizadas que você precisar) e as credenciais necessárias.
- Crie o scaffold do projeto:
src/agents/,src/tools/,tests/, e um arquivo de dependências (pyproject.tomlourequirements.txt)
- Implemente o agente mínimo viável e um prompt de teste de fumaça; adicione testes de regressão para falhas de ferramentas.
- Se for fazer deploy, produza um comando
adk deploy ...e uma checklist de validação pós-implantação (AgentCard/endpoints de tarefa, permissões, logs).
Saída
- Um scaffold ADK pronto para repositório (arquivos e diretórios) mais código inicial do agente
- Stubs de ferramentas e pontos de conexão (onde adicionar novas ferramentas com segurança)
- Um plano de teste e validação (testes unitários e um prompt de fumaça mínimo)
- Opcional: comandos de deploy e etapas de verificação para o Agent Engine
Tratamento de Erros
- Problemas de dependência/runtime: forneça comandos de instalação fixados e valide as importações.
- Falhas de autenticação/permissão: identifique a função/API ausente e proponha correções de privilégio mínimo.
- Falhas de ferramentas/limites de taxa: adicione orientação de retentativas/backoff e um teste de regressão para evitar recorrência.
Exemplos
Exemplo: Scaffold de um agente ReAct único
- Solicitação: "Crie um agente ADK que resuma PRs e proponha atualizações de teste."
- Resultado: ponto de entrada do agente + registro de ferramentas + um comando de teste de fumaça para verificação local.
Exemplo: Orquestrador multi-agente
- Solicitação: "Construa uma equipe de supervisor + implantador + verificador e faça deploy no Agent Engine."
- Resultado: esqueleto do orquestrador, responsabilidades de cada agente e
adk deploy ...+ verificações de integridade pós-implantação.
Recursos
- Guia detalhado completo (mantido para referência):
${CLAUDE_SKILL_DIR}/references/SKILL.full.md - Padrões do repositório (fonte da verdade):
000-docs/6767-a-SPEC-DR-STND-claude-code-plugins-standard.md000-docs/6767-b-SPEC-DR-STND-claude-skills-standard.md
- Documentação do ADK / Agent Engine: https://cloud.google.com/vertex-ai/docs/agent-engine