Durch die Registrierung eines KI-Agenten wird er zu einer auffindbaren Komponente in Agent Registry. Wenn Sie die A2A-Skills Ihres Agents veröffentlichen, können andere Entwickler und Orchestrator-Agents 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 im Schema für Agent-Karten.
Je nach 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
Bei unterstützten Google Cloud Laufzeiten werden Ihre Agents standardmäßig oder über einen Opt-in-Bereitstellungsschritt in derselben Projekt-Agent-Registry registriert. Die automatische Registrierung erfolgt auf Projektebene und erkennt nicht automatisch Agents, die in anderen Google CloudProjekten bereitgestellt werden.
Die automatische Registrierung wird für die folgenden Google Cloud Laufzeiten unterstützt:
- Agent Runtime on Gemini Enterprise Agent Platform: Mit dem SDK bereitgestellte Agents werden ohne zusätzliche Konfiguration registriert. Weitere Informationen finden Sie unter Agents über die Agent-Laufzeit registrieren.
- Integrierte Google-Agents: Agents, die direkt von Google bereitgestellt werden, z. B. Google Workspace- und Gemini Enterprise-Agents, sind ohne Konfiguration auffindbar. Weitere Informationen finden Sie unter Integrierte Google-Agents registrieren.
- Google Kubernetes Engine: Containerisierte Agenten, die in Google Kubernetes Engine (GKE) bereitgestellt werden, werden registriert, wenn sie mit dem Label für den Funktionstyp „KI-Agent“ und der Anmerkung „Agent Card“ konfiguriert werden. Der GKE-Cluster-Laufzeitcontroller führt den Introspektionsscan aus und veröffentlicht die Metadaten in der Agent Registry. Weitere Informationen finden Sie unter Agents aus GKE registrieren.
- Cloud Run: Containerisierte Agents, die in Cloud Run-Diensten oder -Jobs bereitgestellt werden, werden registriert, wenn sie mit den Flags für Funktion und Identität bereitgestellt werden. Cloud Run registriert den Namen und Typ (
AGENT) des Agents automatisch in der Agent Registry. Weitere Informationen finden Sie unter Agents aus 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 Agentenkarte (
/.well-known/agent-card.json) des Agents ab, um die beworbenen A2A-Skills und -Funktionen automatisch in den Registrierungskatalog zu extrahieren. - Agents, die das A2A-Protokoll nicht implementieren (Standard-REST- oder gRPC-Endpunkte): Agent Registry registriert den Agent, kann aber Metadaten wie die Endpunkt-URL, die Identität des Agents und A2A-Skills nicht automatisch erfassen. Wenn Sie Funktionen mit Nicht-A2A-Agenten verknüpfen möchten, verwenden Sie die manuelle Registrierung oder register skills.
Informationen zu Google Cloud Laufzeiten, die die automatische Registrierung unterstützen, finden Sie unter Automatische Registrierung verwenden.
Manuelle Registrierung
Bei Agents, die auf externen Plattformen, lokal, in Google CloudLaufzeiten gehostet werden, die keine automatische Erkennung unterstützen, oder in verschiedenenGoogle Cloud Projekten, müssen Sie die manuelle Registrierung verwenden.
Wenn Sie einen Agent manuell registrieren möchten, 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 Agents definiert. Diese beschreibbare Service-Ressource enthält auch die spezifischen Details des Kundenservicemitarbeiters. Nachdem die Service erstellt wurde, generiert die Registry eine schreibgeschützte Agent-Ressource, die Sie für die Ermittlung verwenden können.
Sie können zwei Arten von Agents manuell registrieren:
- A2A-konforme Agenten: Agenten, die die A2A-Spezifikation (
A2A_AGENT_CARD) implementieren. Die Registrierung scannt ihren Agentenkarten-Endpunkt (agent-card.json), um ihre A2A-Skills zu indexieren. - Standard-REST-Agents: Remote-Agents, die die A2A-Spezifikation (
NO_SPEC) nicht implementieren, z. B. ein Standard-REST API-Endpunkt.
Informationen zur manuellen Registrierung von Agents 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 Arbeitslastprojekten bereitgestellt werden.
Da bei der automatischen Registrierung nur Ressourcen im lokalen Projekt erkannt werden, müssen Sie die Remote-Agents manuell in der Registrierung des zentralen Governance-Projekts registrieren. Durch die projektübergreifende Registrierung kann das zentrale Gateway die Agenten finden und verwalten. Eine Anleitung finden Sie unter Agent aus einem anderen Projekt registrieren.
Eigenständige Skills einbinden
Mit der Agent Registry können Sie eigenständige Skills für Agents als Ressourcen der obersten Ebene verwalten und steuern.
Eigenständige Skills werden als Skill-Ressourcen in Ihrer Registrierung registriert. So können Administratoren detaillierte Zugriffsrichtlinien anwenden und den Versionsverlauf mit Skill-Revisionen verwalten.
Wenn Sie KI-Agenten in Gemini Enterprise erstellen und verwalten, können Sie auf diese registrierten Skills verweisen, um die Funktionen Ihres KI-Agenten zu erweitern. Informationen zum Registrieren und Verwalten von eigenständigen Skills finden Sie unter Skills registrieren und Skills verwalten.