Adk-Bereitstellungsspezialist
Übersicht
Experte für die Erstellung und Bereitstellung von Multi-Agenten-Produktionssystemen mit Googles Agent Development Kit (ADK). Behandelt die Agenten-Orchestrierung (Sequentiell, Parallel, Schleife), die A2A-Protokollkommunikation, die Code-Ausführungs-Sandbox für GCP-Operationen, den Memory Bank für zustandsbehaftete Unterhaltungen und die Bereitstellung in der Vertex AI Agent Engine.
Voraussetzungen
- Ein Google Cloud-Projekt mit aktiviertem Vertex AI (und Berechtigungen zur Bereitstellung von Agent Engine-Laufzeiten)
- Installiertes ADK (und auf die unterstützte Version des Projekts festgelegt)
- Ein klarer Agentenvertrag: benötigte Tools, Orchestrierungsmuster und Bereitstellungsziel (lokal vs. Agent Engine)
- Ein Plan für Geheimnisse/Anmeldeinformationen (OIDC/WIF wo möglich; niemals langlebige Schlüssel committen)
Anleitung
- Bestätigen Sie die gewünschte Architektur (Einzelagent vs. Multiagent) und das Orchestrierungsmuster (Sequentiell/Parallel/Schleife).
- Definieren Sie die AgentCard- + A2A-Schnittstellen (Eingaben/Ausgaben, Aufgabenübermittlung und Statusabfrageerwartungen).
- Implementieren Sie den/die Agenten mit der minimal erforderlichen Tool-Oberfläche (Code Execution Sandbox und/oder Memory Bank nach Bedarf).
- Testen Sie lokal mit repräsentativen Eingabeaufforderungen und Fehlerfällen, fügen Sie dann Smoke-Tests für die Bereitstellungsverifikation hinzu.
- Stellen Sie in der Vertex AI Agent Engine bereit und validieren Sie die generierten Endpunkte (
/.well-known/agent-card, Aufgaben-Send-/Status-APIs). - Fügen Sie Observability hinzu: Logs, Dashboards und Wiederholungs-/Backoff-Verhalten für vorübergehende Fehler.
Ausgabe
- Agenten-Quelldateien (oder Patches), bereit für die Bereitstellung
- Bereitstellungsbefehle/Konfiguration (z.B.
adk deploy-Aufruf + erforderliche Flags) - Eine Verifikations-Checkliste für Agent Engine-Endpunkte (AgentCard + Aufgaben-APIs) und Sicherheitslage
Fehlerbehandlung
Siehe ${CLAUDE_SKILL_DIR}/references/errors.md für eine umfassende Fehlerbehandlung.
Beispiele
Siehe ${CLAUDE_SKILL_DIR}/references/examples.md für detaillierte Beispiele.
Ressourcen
- ADK-Dokumentation: https://cloud.google.com/vertex-ai/docs/agent-engine
- Workload Identity (CI/CD): https://cloud.google.com/iam/docs/workload-identity-federation
- A2A / AgentCard-Muster: siehe
000-docs/6767-a-SPEC-DR-STND-claude-code-plugins-standard.md