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

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 Agentenkomponenten in der Agent Registry registrieren, können Sie zentral steuern, mit welchen externen Endpunkten sich Ihre Agentenflotte verbinden kann.

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

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

Hinweis

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

Wenn Sie die Google Cloud CLI-Befehle in diesem Dokument verwenden möchten, müssen Sie Ihre gcloud 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, verwenden Sie die manuelle Registrierung, um sie der Agent Registry hinzuzufügen:

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 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.

   Optional können Sie in diesem Bereich auf Verbindung testen klicken, um die Verbindung zur Ziel-URL zu testen.

   Hinweis: Sie können Endpunkte registrieren, die private URLs verwenden. Der Verbindungstest funktioniert jedoch nur für öffentliche Endpunkte und prüft, ob die öffentliche URL erreichbar ist. Der Test unterstützt keine privaten URLs oder Endpunkte, für die authentifizierte Daten gesendet werden müssen, z. B. Agent Runtime-Endpunkte auf der Gemini Enterprise Agent Platform.

6. Klicken Sie auf Speichern.

gcloud

Sie erstellen 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 ENDPOINT_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --display-name="DISPLAY_NAME" \
  --endpoint-spec-type=no-spec \
  --interfaces=url=ENDPOINT_URL,protocolBinding=PROTOCOL

Ersetzen Sie Folgendes:

• ENDPOINT_NAME: Der Name, den Sie Ihrem Endpunkt 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.