Durch die Registrierung eines KI-Agenten wird er zu einer auffindbaren Komponente in 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.
Agent Registry lässt sich nahtlos in das
Agent2Agent-Protokoll (A2A) und seine
Spezifikationen einbinden. A2A ist ein offener Standard, mit dem KI-Agenten ihre Fähigkeiten und Identität deklarieren können. Agent Registry unterstützt die Versionen 0.3 und 1.0 der A2A-Spezifikation. Weitere Informationen finden Sie im
Schema für Agentenkarten.
Je nach Ihren Agent-Runtimes unterstützt Agent Registry zwei primäre Registrierungsmechanismen: automatische Registrierung und manuelle Registrierung.
In diesem Dokument erfahren Sie, welcher Registrierungsmechanismus für Ihre Agent-Runtimes geeignet ist.
Automatische Registrierung
Unterstützte Google Cloud Runtimes registrieren Ihre KI-Agenten in Agent Registry im selben Projekt, entweder standardmäßig oder über einen optionalen Bereitstellungsschritt. Die automatische Registrierung erfolgt auf Projektebene und erkennt nicht automatisch KI-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: KI-Agenten, die mit dem SDK bereitgestellt werden, werden ohne zusätzliche Konfiguration registriert.
- Integrierte Google-Agenten: Von Google direkt bereitgestellte KI-Agenten wie Google Workspace- und Gemini Enterprise-Agenten sind ohne Konfiguration auffindbar.
- Google Kubernetes Engine: Containerisierte KI-Agenten, die in Google Kubernetes Engine (GKE) bereitgestellt werden, werden registriert, wenn sie ein bestimmtes Label für den funktionalen Typ von Agent Registry enthalten.
Die Metadaten und A2A-Skills eines KI-Agenten, die bei der Registrierung erfasst werden, hängen vom Protokoll des KI-Agenten ab:
- KI-Agenten, die das Agent2Agent-Protokoll (A2A) implementieren: A2A ist ein offener Standard, mit dem KI-Agenten ihre Fähigkeiten und Identität deklarieren können. Wenn Ihr KI-Agent dieses Protokoll implementiert, extrahiert Agent Registry automatisch die A2A-Skills des KI-Agenten aus seiner Agentenkarte und füllt die Registry damit.
- KI-Agenten, die das A2A-Protokoll nicht implementieren: Agent Registry registriert den KI-Agenten, kann aber keine Metadaten wie die Inferenz-URL und A2A-Skills automatisch erfassen. Wenn Sie diese Informationen bereitstellen möchten, damit Ihr KI-Agent auffindbar ist, verwenden Sie die manuelle Registrierung.
Informationen zu Google Cloud Runtimes, die die automatische Registrierung unterstützen, finden Sie unter Automatische Registrierung verwenden.
Manuelle Registrierung
Für KI-Agenten, die auf externen Plattformen, lokal, auf Google Cloud Runtimes, die keine automatische Erkennung unterstützen, oder in verschiedenen Google Cloud Projekten gehostet werden, müssen Sie die manuelle Registrierung verwenden.
Um einen KI-Agenten manuell zu registrieren, erstellen Sie mit der Agent Registry API, der Google Cloud CLI oder Terraform eine Service-Ressource, die den Endpunkt und die Konfiguration des KI-Agenten definiert. Diese beschreibbare Service-Ressource enthält auch die spezifischen Details des KI-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 KI-Agenten manuell registrieren:
- A2A-konforme KI-Agenten: KI-Agenten, die die A2A-Spezifikation
(
A2A_AGENT_CARD) implementieren. Die Registry scannt den Endpunkt ihrer Agentenkarte (agent-card.json), 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 KI-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 KI-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 KI-Agenten finden und verwalten. Eine Anleitung finden Sie unter KI-Agenten aus einem anderen Projekt registrieren.
Eigenständige Skills einbinden
Mit Agent Registry können Sie eigenständige
Skills für KI-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-Revisionen verwalten.
Wenn Sie KI-Agenten in Gemini Enterprise erstellen und verwalten, können Sie auf diese registrierten Skills verweisen, um die Fähigkeiten Ihres KI-Agenten zu erweitern. Informationen zum Registrieren und Verwalten eigenständiger Skills finden Sie unter Skills registrieren und Skills verwalten.