Durch die Registrierung eines KI-Agenten wird er zu einer auffindbaren Komponente in der Agent Registry. Wenn Sie die A2A-Skills Ihres KI-Agenten veröffentlichen, können andere Entwickler und Orchestrator-Agenten in Ihrer Organisation Ihre Arbeit leichter finden und wiederverwenden. So wird die KI-Entwicklung insgesamt beschleunigt.
Die Agent Registry lässt sich nahtlos in das
Agent2Agent-Protokoll (A2A) und seine
Spezifikationen einbinden. A2A ist ein offener Standard, mit dem Agenten ihre Fähigkeiten und Identität deklarieren können. Die Agent Registry unterstützt die Versionen 0.3 und 1.0 der A2A-Spezifikation. Weitere Informationen finden Sie unter
Agent Card-Schema.
Je nach Ihren Agent-Runtimes unterstützt die Agent Registry zwei primäre Registrierungsmechanismen: automatische Registrierung und manuelle Registrierung.
Wählen Sie den Registrierungsmechanismus aus, der zu Ihren Agent-Runtimes passt.
Automatische Registrierung
Unterstützte Google Cloud Runtimes registrieren Ihre Agenten in der Agent Registry im selben Projekt, entweder standardmäßig oder über einen optionalen Bereitstellungsschritt. Die automatische Registrierung erfolgt auf Projektebene und erkennt nicht automatisch Agenten, die in anderen Google Cloud Projekten bereitgestellt wurden.
Die automatische Registrierung wird für die folgenden Google Cloud Runtimes unterstützt:
- Agent Runtime on Gemini Enterprise Agent Platform: Agenten, die mit dem SDK bereitgestellt werden, werden ohne zusätzliche Konfiguration registriert. Weitere Informationen finden Sie unter Agenten über die Agent Runtime registrieren.
- Integrierte Google-Agenten: Agenten, die von Google direkt bereitgestellt werden, z. B. Google Workspace- und Gemini Enterprise-Agenten, sind ohne Konfiguration auffindbar. Weitere Informationen finden Sie unter Integrierte Google-Agenten registrieren.
- Google Kubernetes Engine: Containerisierte Agenten, die in Google Kubernetes Engine (GKE) bereitgestellt werden, werden registriert, wenn sie mit dem Label für den funktionalen Typ des KI-Agenten und der Agent Card-Annotation konfiguriert sind. Der GKE-Cluster-Runtime-Controller führt den Introspektionsscan aus und veröffentlicht die Metadaten in der Agent Registry. Weitere Informationen finden Sie unter Agenten über GKE registrieren.
- Cloud Run: Containerisierte Agenten, die in
Cloud Run-Diensten oder -Jobs bereitgestellt werden, werden registriert, wenn sie mit den
Flags für den funktionalen Typ und den Identitätstyp bereitgestellt werden. Cloud Run registriert automatisch den Namen, die URL und den Typ (
AGENT) des Agenten in der Agent Registry. Weitere Informationen finden Sie unter Agenten über Cloud Run registrieren.
Die Metadaten und Funktionen, die während der Registrierung für einen Agenten indexiert werden, hängen davon ab, ob der Agent das Agent2Agent-Protokoll (A2A) implementiert:
- Agenten, die das A2A-Protokoll implementieren: Das System fragt die
Agent Card (
/.well-known/agent-card.json) des Agenten ab, um die beworbenen A2A-Skills und -Funktionen automatisch in den Registry-Katalog zu extrahieren. - Agenten, die das A2A-Protokoll nicht implementieren (Standard-REST- oder gRPC-Endpunkte): Das System registriert die URL der Agent-Schnittstelle und die Transportbindung, aber kann semantische Funktionen nicht automatisch extrahieren. Wenn Sie Funktionen mit Nicht-A2A-Endpunkten verknüpfen möchten, können Sie sie über die manuelle Registrierung beschreiben oder sie mit eigenständigen Skills und MCP-Servern in einer KI-Anwendung verknüpfen.
Informationen zu Google Cloud Runtimes, die die automatische Registrierung unterstützen, finden Sie unter Automatische Registrierung verwenden.
Manuelle Registrierung
Für Agenten, die auf externen Plattformen, lokal, auf Google Cloud Runtimes gehostet werden, die keine automatische Erkennung unterstützen, oder in verschiedenen Google Cloud Projekten müssen Sie die manuelle Registrierung verwenden.
Um einen Agenten manuell zu registrieren, verwenden Sie die Agent Registry API, die Google Cloud CLI oder Terraform, um eine Service-Ressource zu erstellen, die den Endpunkt und die Konfiguration des Agenten definiert. Diese beschreibbare Service-Ressource enthält auch die spezifischen Details des Agenten. Nachdem der Service erstellt wurde, generiert die Registry eine
schreibgeschützte Agent-Ressource, die Sie für die Erkennung verwenden können.
Sie können zwei Arten von Agenten manuell registrieren:
- A2A-konforme Agenten: Agenten, die die A2A-Spezifikation
(
A2A_AGENT_CARD) implementieren. Die Registry scannt ihren Agent Card (agent-card.json) Endpunkt, um ihre A2A-Skills zu indexieren. - Standard-REST-Agenten: Remote-Agenten, die die A2A
Spezifikation (
NO_SPEC) nicht implementieren, z. B. ein Standard-REST API-Endpunkt.
Informationen zum manuellen Registrieren von Agenten finden Sie unter Manuelle Registrierung verwenden.
Überlegungen zur projektübergreifenden Registrierung
Wenn Ihre Organisation eine zentralisierte Governance-Architektur mit Agent Gateway, verwendet, können Sie ein Agent-to-Anywhere-Egress-Gateway in einem zentralen Governance Projekt bereitstellen und Agenten registrieren, die in mehreren Spoke- oder Workload-Projekten bereitgestellt wurden.
Da bei der automatischen Registrierung nur Ressourcen im lokalen Projekt erkannt werden, müssen Sie die Remote-Agenten manuell in der Registry des zentralen Governance-Projekts registrieren. Durch die projektübergreifende Registrierung kann das zentrale Gateway die Agenten finden und verwalten. Eine Anleitung finden Sie unter Agenten aus einem anderen Projekt registrieren.
Eigenständige Skills einbinden
Mit der Agent Registry können Sie eigenständige
Skills für Agenten als Ressourcen der obersten Ebene verwalten und steuern.
Eigenständige Skills werden als Skill Ressourcen in Ihrer Registry registriert,
so können Administratoren detaillierte Zugriffsrichtlinien anwenden und den Versionsverlauf
mithilfe von Skill-Versionen verwalten.
Wenn Sie Agenten in Gemini Enterprise erstellen und verwalten, können Sie auf diese registrierten Skills verweisen, um die Funktionen Ihres Agenten zu erweitern. Informationen zum Registrieren und Verwalten eigenständiger Skills finden Sie unter Skills registrieren und Skills verwalten.