In der Agent Registry können Sie benutzerdefinierte KI-Agenten registrieren, die Sie mit dem Agent Development Kit (ADK) erstellen und auf Ihrer eigenen Infrastruktur hosten, damit andere Entwickler und Orchestrator-Agenten sie finden können. Wenn Sie eine Agentenkarte bereitstellen, die dem Agent2Agent-Protokoll (A2A) entspricht, und den Endpunkt des Agenten manuell registrieren, werden seine A2A-Skills in der Agent Registry auffindbar.
Hinweis
- Agent Registry einrichten
Rufen Sie für eine Einrichtung mit einem einzelnen Projekt die Projekt-ID des Governance-Projekts ab, in dem die Agent Registry aktiviert ist. Wenn Sie eine Verwaltungsgrenze für mehrere Projekte konfiguriert haben, verwenden Sie die Projekt-ID Ihres Verwaltungsprojekts für die grenzübergreifende Erkennung und Registrierung oder geben Sie eine Mitgliedsprojekt-ID für Vorgänge in einem einzelnen Projekt an.
Wenn Sie die Google Cloud CLI-Befehle in diesem Dokument verwenden möchten, richten Sie Ihre gcloud CLI-Umgebung ein.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Agent Registry API Editor (roles/agentregistry.editor) für das Governance-Projekt zuzuweisen, in dem Agent Registry aktiviert ist, um die Berechtigungen zu erhalten, die Sie zum Registrieren benutzerdefinierter ADK-Agenten in Agent Registry benötigen.
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.
Der Agent Card-Endpunkt
Damit die Agent Registry die Funktionen Ihres benutzerdefinierten KI-Agenten indexieren kann, muss der KI-Agent seine Metadaten und verfügbaren A2A-Skills über das Agent2Agent-Protokoll (A2A) bereitstellen.
Die A2A-Spezifikation erfordert, dass KI-Agenten eine Agentenkarte bereitstellen. Das ist ein JSON-Dokument, das die Identität und die Tools des KI-Agenten beschreibt und an einem bestimmten Endpunkt, in der Regel /.well-known/agent-card.json, verfügbar ist.
Wenn Sie die spezifischen A2A-Server-Plug-ins oder ‑Module des ADK verwenden, um Ihren Agenten zu registrieren, kann das Framework diese Agentenkarte automatisch basierend auf der Agent-Definition und der tools, die Sie in Ihrem Code angeben, generieren und bereitstellen.
Verfügbar gemachten KI-Agenten registrieren
Nachdem Sie den ADK-Agenten in Ihrer Hosting-Umgebung bereitgestellt haben und er seine REST-Endpunkte erfolgreich bereitstellt, weisen Sie die Agent Registry an, ihn zu erkennen.
Da für benutzerdefinierte Deployments eine manuelle Registrierung erforderlich ist, erstellen Sie eine Service-Ressource in der Registry. Speichern Sie die generierte Agentenkarte Ihres Agenten als lokale JSON-Datei, z. B. agent-card.json.
Registrieren Sie den Agenten mit der gcloud CLI und dem Befehl gcloud agent-registry services create. Geben Sie dabei den Spezifikationstyp a2a-agent-card an und laden Sie Ihre lokale Datei mit dem Flag --agent-spec-content hoch:
gcloud agent-registry services create AGENT_NAME \
--project=PROJECT_ID \
--location=LOCATION \
--display-name="DISPLAY_NAME" \
--agent-spec-type=a2a-agent-card \
--agent-spec-content=agent-card.json
Die maximale Dateigröße für die Spezifikationsdatei beträgt 10 KB.
Ersetzen Sie Folgendes:
AGENT_NAME: der Name, den Sie Ihrem Agenten geben möchten, z. B.my-custom-agent.PROJECT_ID: Projekt-ID.LOCATION: der Standort oder die Region der Registry.DISPLAY_NAME: Der menschenlesbare Name Ihres KI-Agenten.
Nachdem die Service-Ressource erstellt wurde, parst die Agent Registry die Agentenkarte, erstellt eine Agent-Ressource mit Lesezugriff und indexiert die in Ihrem ADK-Python-Code definierten A2A-Fähigkeiten, damit andere Entwickler danach suchen können.