Manuelle Registrierung verwenden

Für Agenten, die außerhalb von Google Cloudgehostet werden, ist eine manuelle Registrierung in der Agent Registry erforderlich. In diesem Dokument wird beschrieben, wie Sie Agenten manuell in der Agent Registry registrieren.

Hinweis

Richten Sie zuerst die Agent Registry ein. Sie benötigen die Projekt-ID um diese Aufgaben auszuführen.

Wenn Sie die gcloud CLI-Befehle in diesem Dokument verwenden möchten, müssen Sie Ihre Google Cloud CLI-Umgebung eingerichtet haben.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die Agent Registry API Editor (roles/agentregistry.editor) IAM-Rolle für das Projekt zu erteilen, um die Berechtigungen zu erhalten, die Sie zum manuellen Registrieren von Agenten in der Agent Registry benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

A2A-konformen Agenten registrieren

Wenn Ihr Remote-Agent die Agent2Agent-Spezifikation (A2A) implementiert, leiten Sie die Agent Registry zur agent-card.json-Nutzlast des Agenten weiter. Die Registry synchronisiert die Agentenkarte automatisch und indexiert die verfügbaren Skills des Agenten für die Erkennung.

Führen Sie die folgenden Schritte aus, um den Agenten zu registrieren:

Console

  1. Rufen Sie in der Google Cloud Console die Seite Agent Registry auf:

    Zur Agent Registry

  2. Wählen Sie in der Projektauswahl das Google Cloud Projekt aus, in dem Sie die Agent Registry eingerichtet haben.

  3. Wählen Sie den Tab Agenten aus.

  4. Klicken Sie auf Agent hinzufügen.

  5. Geben Sie im Bereich Agentendetails einen Anzeigenamen und eine Beschreibung ein und wählen Sie die geografische Region aus.

  6. Wählen Sie für den Agententyp A2A aus.

  7. Wählen Sie im Bereich für die Agentenspezifikation den Tab JSON einfügen aus und fügen Sie den gesamten Inhalt Ihrer agent-card.json-Datei ein.

  8. Klicken Sie auf Speichern.

gcloud

Wenn Sie einen A2A-Agenten registrieren möchten, speichern Sie die Agentenkarte des Agenten als lokale JSON-Datei, z. B. agent-card.json, und führen Sie die folgenden Schritte aus:

gcloud alpha agent-registry services create AGENT_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --display-name="DISPLAY_NAME" \
  --agent-spec-type=a2a-agent-card \
  --agent-spec-content=@agent-card.json

Ersetzen Sie Folgendes:

  • AGENT_NAME: Der Name, den Sie Ihrem Agenten geben möchten, z. B. my-support-agent.
  • PROJECT_ID: Die Projekt-ID.
  • REGION: Die Registry-Region.
  • DISPLAY_NAME: Der für Menschen lesbare Name, den Sie Ihrem Agenten geben möchten, z. B. Support Agent.

Standard-REST-Agenten registrieren

Standard-REST-Agenten können nach Name und Beschreibung gefunden werden, haben aber keine durchsuchbaren Skills, es sei denn, sie verwenden das A2A-Protokoll.

Wenn Sie einen Remote-Agenten registrieren möchten, der die A2A-Spezifikation nicht implementiert, z. B. einen Standard-REST- oder SaaS-API-Endpunkt, erstellt die Agent Registry API eine Service-Ressource ohne Spezifikation des Agentenprotokolls.

Führen Sie die folgenden Schritte aus, um den Agenten zu registrieren:

Console

  1. Rufen Sie in der Google Cloud Console die Seite Agent Registry auf:

    Zur Agent Registry

  2. Wählen Sie in der Projektauswahl das Google Cloud Projekt aus, in dem Sie die Agent Registry eingerichtet haben.

  3. Wählen Sie den Tab Agenten aus.

  4. Klicken Sie auf Agent hinzufügen.

  5. Geben Sie im Bereich Agentendetails einen Anzeigenamen und eine Beschreibung ein und wählen Sie die geografische Region aus.

  6. Wählen Sie für den Agententyp die Option aus, die keine Spezifikation angibt, z. B. Non-A2A.

  7. Geben Sie den Endpunkt ein, an dem der Agent gehostet wird, und wählen Sie bei Bedarf die Protokollbindung aus, z. B. HTTP_JSON.

  8. Klicken Sie auf Speichern.

gcloud

Optional können Sie die definierte HTTP/JSON-Endpunktschnittstelle mit dem Flag --interfaces angeben, damit die Registry eine Verbindung zum Agenten herstellt.

So registrieren Sie einen Standard-REST-Agenten:

gcloud alpha agent-registry services create AGENT_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --display-name="DISPLAY_NAME" \
  --agent-spec-type=no-spec \
  --interfaces=url=ENDPOINT_URL,protocolBinding=PROTOCOL

Ersetzen Sie Folgendes:

  • AGENT_NAME: Der Name, den Sie Ihrem Agenten geben möchten, z. B. my-remote-rest-agent.
  • PROJECT_ID: Die Projekt-ID.
  • REGION: Die Registry-Region.
  • DISPLAY_NAME: Der für Menschen lesbare Name, den Sie Ihrem Agenten geben möchten, z. B. Remote REST Agent.
  • ENDPOINT_URL: Die Endpunkt-URL des Agentendienstes, z. B. https://api.remote-service.com/v1/agents/1234.
  • PROTOCOL: Die Protokollbindung für den Endpunkt. Gültige Werte sind HTTP_JSON, GRPC oder JSONRPC.

Registrierung bestätigen

Prüfen Sie nach der Registrierung Ihres Agenten, ob die Agent Registry den Service erfolgreich verarbeitet und die entsprechende Agent-Ressource erstellt hat:

Console

  1. Rufen Sie in der Google Cloud Console die Seite Agent Registry auf:

    Zur Agent Registry

  2. Wählen Sie in der Projektauswahl das Google Cloud Projekt aus, in dem Sie die Agent Registry eingerichtet haben.

  3. Wählen Sie den Tab Agenten aus.

    Auf der Seite muss eine Liste aller registrierten Agenten und ihrer Details angezeigt werden.

gcloud 

gcloud alpha agent-registry agents list \
  --project=PROJECT_ID \
  --location=REGION

Wenn Sie mehrere Agenten haben oder die Registrierung eines einzelnen Agenten bestätigen möchten, können Sie die Liste nach den Metadaten des Agenten filtern:

gcloud alpha agent-registry agents list \
  --project=PROJECT_ID \
  --location=REGION \
  --filter="FILTER_EXPRESSION"

Ersetzen Sie Folgendes:

  • PROJECT_ID: Die Projekt-ID.
  • REGION: Die Registry-Region.
  • FILTER_EXPRESSION: Der Filterausdruck für die Agenten, die Sie filtern möchten. Wenn Sie beispielsweise nach Anzeigenamen filtern möchten, können Sie verwenden displayName='DISPLAY_NAME'. Wenn Sie nach der global eindeutigen ID (URN) filtern möchten, können Sie agentId='urn:agent:AGENT_URN' verwenden.