Endpunkte registrieren

Vorschau

Dieses Produkt oder Feature unterliegt den „Bedingungen 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.

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

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

Hinweis :Die manuelle Registrierung wird an den multiregionalen Standorten us und eu nicht unterstützt. Sie müssen Ressourcen in einer unterstützten Region oder am Standort global registrieren. Weitere Informationen finden Sie unter Agent Registry-Standorte.

Hinweis

Richten Sie die Agent Registry ein, bevor Sie beginnen. 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 einrichten.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen für das Projekt die IAM-Rolle Bearbeiter der Agent Registry API (roles/agentregistry.editor) zuzuweisen, damit Sie die Berechtigungen 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, verwenden Sie die manuelle Registrierung, um sie der Agent Registry hinzuzufügen:

Console

1. Rufen Sie in der Google Cloud Console die 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 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 Ihre Verbindung zur Ziel-URL testen.

6. Klicken Sie auf Speichern.

gcloud

Sie erstellen eine Service-Ressource mit einem endpoint-spec-type von 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 Menschen 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 und JSONRPC.

Nachdem die Service-Ressource erstellt wurde, generiert die Agent Registry automatisch eine schreibgeschützte Endpoint-Ressource auf der Nutzerseite, die von Agents und Orchestratoren ermittelt und verwendet werden kann.