ADK Agent Builder
Erstelle produktionsreife Agenten mit Googles Agent Development Kit (ADK): Gerüstbau, Tool-Verdrahtung, Orchestrierungsmuster, Tests und optionale Bereitstellung auf der Vertex AI Agent Engine.
Übersicht
- Erstellt ein minimales, produktionsorientiertes ADK-Gerüst (Agent-Einstiegspunkt, Tool-Registry, Konfiguration und Tests).
- Unterstützt Single-Agent-ReAct-Workflows und Multi-Agent-Orchestrierung (Sequentiell/Parallel/Schleife).
- Erzeugt eine Validierungs-Checkliste, geeignet für CI (Lint/Tests/Smoke-Prompts) und optionale Überprüfung der Agent Engine-Bereitstellung.
Voraussetzungen
- Python-Laufzeitumgebung, kompatibel mit Ihrem Projekt (oft Python 3.10+)
google-adkinstalliert und importierbar- Bei Bereitstellung: Zugriff auf ein Google Cloud-Projekt mit aktiviertem Vertex AI und Berechtigungen zur Bereitstellung von Agent Engine-Laufzeiten
- Geheimnisse (Secrets) verfügbar über Umgebungsvariablen oder einen Secret Manager (niemals fest codiert)
Anleitung
- Bestätigen Sie den Umfang: Nur lokales Agenten-Gerüst vs. Bereitstellung auf Vertex AI Agent Engine.
- Wählen Sie eine Architektur:
- Einzelagent (ReAct) für adaptive, toolgesteuerte Aufgaben
- Multi-Agent-System (Spezialisten + Orchestrator) für komplexe, mehrstufige Workflows
- Definieren Sie die Tool-Oberfläche (eingebaute ADK-Tools + benutzerdefinierte Tools) und die erforderlichen Anmeldeinformationen.
- Erstellen Sie das Projektgerüst:
src/agents/,src/tools/,tests/und eine Abhängigkeitsdatei (pyproject.tomloderrequirements.txt)
- Implementieren Sie den minimal lebensfähigen Agenten und einen Smoke-Test-Prompt; fügen Sie Regressionstests für Tool-Fehler hinzu.
- Erstellen Sie bei Bereitstellung einen
adk deploy ...-Befehl und eine Checkliste für die Überprüfung nach der Bereitstellung (AgentCard/Task-Endpunkte, Berechtigungen, Logs).
Ausgabe
- Ein repo-bereites ADK-Gerüst (Dateien und Verzeichnisse) plus Starter-Agent-Code
- Tool-Stubs und Verdrahtungspunkte (wo sicher neue Tools hinzugefügt werden können)
- Ein Test- und Validierungsplan (Unit-Tests und ein minimaler Smoke-Prompt)
- Optional: Bereitstellungsbefehle und Überprüfungsschritte für die Agent Engine
Fehlerbehandlung
- Abhängigkeits-/Laufzeitprobleme: Geben Sie festgelegte Installationsbefehle an und validieren Sie Importe.
- Authentifizierungs-/Berechtigungsfehler: Identifizieren Sie die fehlende Rolle/API und schlagen Sie Korrekturen mit geringsten Berechtigungen vor.
- Tool-Fehler/Ratenbegrenzungen: Fügen Sie Anleitungen zu Wiederholungen/Backoff und einen Regressionstest hinzu, um Wiederholungen zu vermeiden.
Beispiele
Beispiel: Gerüst für einen einzelnen ReAct-Agenten
- Anfrage: „Erstelle einen ADK-Agenten, der PRs zusammenfasst und Test-Updates vorschlägt.“
- Ergebnis: Agent-Einstiegspunkt + Tool-Registry + ein Smoke-Test-Befehl zur lokalen Überprüfung.
Beispiel: Multi-Agent-Orchestrator
- Anfrage: „Baue ein Team aus Supervisor + Deployer + Verifier und stelle es auf der Agent Engine bereit.“
- Ergebnis: Orchestrator-Gerüst, Verantwortlichkeiten pro Agent und
adk deploy ...+ Gesundheitschecks nach der Bereitstellung.
Ressourcen
- Vollständige detaillierte Anleitung (zur Referenz aufbewahrt):
${CLAUDE_SKILL_DIR}/references/SKILL.full.md - Repo-Standards (maßgebliche Quelle):
000-docs/6767-a-SPEC-DR-STND-claude-code-plugins-standard.md000-docs/6767-b-SPEC-DR-STND-claude-skills-standard.md
- ADK / Agent Engine-Dokumentation: https://cloud.google.com/vertex-ai/docs/agent-engine