KI-Agenten registrieren

Vorschau

Dieses Produkt oder Feature unterliegt den „Nutzungsbedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Dienstbedingungen“ der Dienstspezifischen Nutzungsbedingungen. Pre-GA-Produkte und -Features sind „im Ist-Zustand“ verfügbar und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie unter den Beschreibungen der Startphase.

Durch die Registrierung eines KI-Agenten wird er zu einem auffindbaren Dienst. 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-Laufzeiten unterstützt die Agent Registry zwei primäre Registrierungsmechanismen: automatische und manuelle Registrierung.

In diesem Dokument erfahren Sie, wie Sie den Registrierungsmechanismus auswählen, der zu Ihren Agent-Laufzeiten passt.

Automatische Registrierung

Unterstützte Google Cloud Laufzeiten registrieren Ihre KI-Agenten in der Agent Registry entweder standardmäßig oder über einen optionalen Bereitstellungsschritt.

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

• Vertex AI Agent Engine: Mit dem SDK bereitgestellte KI-Agenten werden ohne zusätzliche Konfiguration registriert.
• In Google integrierte KI-Agenten: Von Google direkt bereitgestellte KI-Agenten wie Google Workspace- und Gemini Enterprise-KI-Agenten sind ohne Konfiguration auffindbar.
• Google Kubernetes Engine: In Containern bereitgestellte KI-Agenten, die in GKE bereitgestellt werden, werden registriert, wenn sie eine bestimmte Annotation für den funktionalen Typ 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 URL für die Inferenz und die 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 Laufzeiten, 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 Laufzeiten 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.