Durch die Registrierung eines KI-Agenten wird er zu einer auffindbaren Komponente in Agent Registry. Wenn Sie die Skills Ihres KI-Agenten veröffentlichen, können andere Entwickler und Orchestrator-KI-Agenten in Ihrer Organisation Ihre Arbeit 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 der Agentenkarte.
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 entweder standardmäßig oder über einen optionalen Bereitstellungsschritt bei Agent Registry.
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.
- In Google integrierte KI-Agenten: KI-Agenten, die von Google direkt bereitgestellt werden, z. B. Google Workspace- und Gemini Enterprise-KI-Agenten, sind ohne Konfiguration auffindbar.
- Google Kubernetes Engine: Containerisierte KI-Agenten, die in Google Kubernetes Engine (GKE) bereitgestellt werden, werden registriert, wenn sie eine bestimmte Annotation für den funktionalen Typ von Agent Registry enthalten.
Die Metadaten und Skills eines KI-Agenten, die bei der Registrierung erfasst werden, hängen vom Protokoll des KI-Agenten ab:
- KI-Agenten, die das A2A-Protokoll implementieren: Wenn Ihr KI-Agent das A2A Protokoll implementiert, extrahiert Agent Registry automatisch die 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 URL für die Inferenz und die 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 oder auf Google Cloud Runtimes gehostet werden, die keine automatische Erkennung unterstützen, 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 Skills zu indexieren. - Standard-REST-KI-Agenten: Remote-KI-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.