Endpunkte registrieren

In der Agent Registry stellt ein Endpunkt eine Ziel-URL dar, in der Regel eine REST API, auf die Ihre Agenten zugreifen. Wenn Sie diese Ziele als verwaltete Ressourcen registrieren, können Sie zentral steuern, mit welchen externen Diensten sich Ihre Agentenflotte verbinden kann.

In diesem Dokument wird erläutert, wie Sie externe Endpunkte explizit in der Registry registrieren.

Hinweis

Richten Sie zuerst die Agent Registry ein. Sie benötigen Ihre 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 Registrieren von Endpunkten 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.

Endpunkt registrieren

Da Endpunkte benutzerdefinierte, externe Ziele sind, müssen Sie sie manuell in der Agent Registry registrieren:

Console

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

    Zu 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 Endpunkte aus.

  4. Klicken Sie auf Endpunkt hinzufügen.

  5. Geben Sie im Bereich Endpunktdetails den Anzeigenamen, eine Beschreibung, die geografische Region und die Ziel-URL ein. In diesem Bereich können Sie die Verbindung zur Ziel-URL testen.

  6. Klicken Sie auf Speichern.

gcloud

Erstellen Sie eine Service-Ressource mit dem endpoint-spec-type no-spec.

Registrieren Sie den Endpunkt und definieren Sie die Details der Schnittstellenverbindung:

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

Ersetzen Sie Folgendes:

  • SERVICE_NAME: Der Name, den Sie Ihrer Ressource geben möchten, z. B. my-external-api.
  • PROJECT_ID: Die Projekt-ID.
  • REGION: Die Registry-Region.
  • DISPLAY_NAME: Der für Nutzer lesbare Name des Endpunkts.
  • ENDPOINT_URL: Die Ziel-URL, z. B. https://api.example.com/v1/data.
  • PROTOCOL: Die Protokollbindung für die Schnittstelle. Gültige Werte sind HTTP_JSON, GRPC oder JSONRPC.

Nachdem die Service Ressource erstellt wurde, generiert die Agent Registry automatisch eine schreibgeschützte Endpoint Ressource auf der Consumerseite, die von Agenten und Orchestratoren erkannt und verwendet werden kann.