KI-Agenten registrieren

Durch die Registrierung eines KI-Agenten wird er zu einer auffindbaren Komponente in der Agent Registry. Wenn Sie die Fähigkeiten Ihres KI-Agenten veröffentlichen, können andere Entwickler und Orchestrator-KI-Agenten in Ihrer Organisation Ihre Arbeit finden und wiederverwenden, was die KI-Entwicklung insgesamt beschleunigt.

Je nach Ihren Agent-Runtimes unterstützt die 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 in der Agent Registry.

Die automatische Registrierung wird für die folgenden Google Cloud Runtimes unterstützt:

  • Agent Runtime auf der 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 Funktionstyp der Agent Registry enthalten.

Die Metadaten und Fähigkeiten 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 die Agent Registry automatisch die Fähigkeiten des KI-Agenten aus seiner Agentenkarte und füllt die Registry damit.
  • KI-Agenten, die das A2A-Protokoll nicht implementieren: Die Agent Registry registriert den KI-Agenten, kann aber keine Metadaten wie die Inferenz-URL und Fähigkeiten 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 eine Service-Ressource, die den Endpunkt und die Konfiguration des KI-Agenten definiert. Diese beschreibbare Ressource enthält auch die spezifischen Details des KI-Agenten. Nachdem die 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 Agent2Agent-Spezifikation (A2A) (A2A_AGENT_CARD) implementieren. Die Registry scannt den Endpunkt ihrer Agentenkarte (agent-card.json), um ihre Fähigkeiten 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.