In der Agent Registry können Ihre Orchestrator-Agenten über Bindungen eine Verbindung zu nachgelagerten Agenten, MCP-Servern und Endpunkten herstellen, ohne dass Verbindungs- oder Authentifizierungsdetails im Code hartcodiert werden müssen. Sie können Bindungen in der Agent Registry erstellen, ansehen, aktualisieren und löschen, um Ressourcenverbindungen und delegierte Berechtigungen zu verwalten.
Hinweis
- Agent Registry einrichten
Rufen Sie für eine Einrichtung mit einem einzelnen Projekt die Projekt-ID des Governance-Projekts ab, in dem die Agent Registry aktiviert ist. Wenn Sie eine Verwaltungsgrenze für mehrere Projekte konfiguriert haben, verwenden Sie die Projekt-ID Ihres Verwaltungsprojekts für die grenzübergreifende Erkennung und Registrierung oder geben Sie eine Mitgliedsprojekt-ID für Vorgänge in einem einzelnen Projekt an.
Registrieren Sie die Quell- und Zielkomponenten. Weitere Informationen finden Sie unter Registrierungsmodelle.
Wenn Sie Bindungen für delegierte Berechtigungen konfigurieren möchten, erstellen Sie einen Authentifizierungsanbieter mit dem Agent Identity-Authentifizierungsmanager. Weitere Informationen finden Sie unter Bei Tools und Ressourcen authentifizieren.
Wenn Sie die Google Cloud CLI-Befehle in diesem Dokument verwenden möchten, richten Sie Ihre gcloud CLI-Umgebung ein.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Governance-Projekt zuzuweisen, in dem Agent Registry aktiviert ist, um die Berechtigungen zu erhalten, die Sie zum Verwalten von Bindungen in Agent Registry benötigen:
-
Bindungen erstellen, aktualisieren und löschen: Agent Registry API Admin (
roles/agentregistry.admin) -
Bindungen ansehen:
Agent Registry API Viewer (
roles/agentregistry.viewer)
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.
Bindungsszenarien
Mit Bindungen können Sie Ressourcen verbinden und Berechtigungen delegieren. Sie können Bindungen beispielsweise in folgenden Szenarien verwenden:
- Ressourcenverbindungen: Verknüpfen Sie einen Quell-Agenten mit einer Zielressource, z. B. einem anderen Agenten, einem MCP-Server oder einem Endpunkt. In diesem Szenario können Sie Workflows mit mehreren Agenten planen, bei denen ein primärer Orchestrator Aufgaben an spezialisierte Sub-Agenten oder Tools delegiert.
- Delegierte Berechtigungen: Verknüpfen Sie einen KI-Agenten mit einem Authentifizierungsanbieter, damit er mit seinen eigenen Anmeldedaten oder im Namen eines einzelnen Nutzers eine Verbindung zu externen Zielen oder benutzerdefinierten Tools herstellen kann. Diese Bindung ist erforderlich, wenn sich Ihr KI-Agent bei Remote-MCP-Servern oder ‑Tools mit OAuth-Tokens oder API-Schlüsseln authentifizieren muss. Mit Bindungen müssen Sie Authentifizierungsanbieter nicht manuell in Ihrem Code definieren. Eine ausführliche Anleitung finden Sie in diesem Dokument unter Bindung für Authentifizierungsanbieter erstellen.
Bindung erstellen
Erstellen Sie eine Bindung, um einen Quell-Agent mit einer Zielressource zu verbinden:
gcloud
Führen Sie den Befehl gcloud agent-registry bindings create aus:
gcloud agent-registry bindings create BINDING_NAME \
--project=PROJECT_ID \
--location=REGION \
--display-name="DISPLAY_NAME" \
--source-identifier="SOURCE_ID" \
--target-identifier="TARGET_ID"
Ersetzen Sie Folgendes:
BINDING_NAME: der Name, den Sie der Bindung geben möchten, z. B.my-custom-binding.PROJECT_ID: Projekt-ID.REGION: die Registry-Region.DISPLAY_NAME: der menschenlesbare Name, den Sie Ihrer Bindung geben möchten, z. B.My Custom Binding.SOURCE_ID: die Agent-ID des Quell-Agenten im URN-Format (Uniform Resource Name).TARGET_ID: die Registry-ID der Zielressource im URN-Format, z. B. eine Agent-ID, MCP-Server-ID oder Endpunkt-ID.
Terraform
Wenn Sie eine Bindung zwischen einem Quell-Agenten und einer Zielressource erstellen möchten, konfigurieren Sie eine google_agent_registry_binding-Ressource. Für eine Bindung ist der Block target erforderlich:
resource "google_agent_registry_binding" "agent_binding" {
location = "REGION"
binding_id = "BINDING_NAME"
display_name = "DISPLAY_NAME"
description = "Connects a source agent to a target resource."
source {
identifier = "SOURCE_ID"
}
target {
identifier = "TARGET_ID"
}
}
Ersetzen Sie Folgendes:
REGION: die Registry-Region.BINDING_NAME: der eindeutige Name, den Sie der Bindung geben möchten.DISPLAY_NAME: der menschenlesbare Name der Bindung.SOURCE_ID: die Agent-ID des Quell-Agenten im URN-Format.TARGET_ID: die Registry-ID der Zielressource im URN-Format.
Authentifizierungsanbieterbindung erstellen
Sie können einen Agenten mit einem Authentifizierungsanbieter für delegierte Berechtigungen verknüpfen. Bevor Sie diese Bindung erstellen, müssen Sie zuerst den Authentifizierungsanbieter mit dem Authentifizierungsmanager erstellen. Weitere Informationen finden Sie unter Bei Tools und Ressourcen authentifizieren.
Wenn Sie den Ressourcennamen --auth-provider-binding angeben, müssen Sie Ihre Projekt-ID verwenden:
gcloud
Führen Sie den Befehl gcloud agent-registry bindings create mit dem Flag --auth-provider-binding aus:
gcloud agent-registry bindings create BINDING_NAME \
--project=PROJECT_ID \
--location=REGION \
--display-name="DISPLAY_NAME" \
--source-identifier="SOURCE_ID" \
--target-identifier="TARGET_ID" \
--auth-provider-binding="projects/PROJECT_ID/locations/REGION/authProviders/AUTH_PROVIDER_ID"
Ersetzen Sie Folgendes:
BINDING_NAME: der eindeutige Name, den Sie der Bindung geben möchten.PROJECT_ID: Projekt-ID.REGION: die Registry-Region.DISPLAY_NAME: der menschenlesbare Name der Bindung.SOURCE_ID: die Agent-ID des Quell-Agenten im URN-Format.TARGET_ID: die Registry-ID der Zielressource im URN-Format.AUTH_PROVIDER_ID: die ID Ihres Authentifizierungsanbieters.
Terraform
Wenn Sie eine Authentifizierungsanbieterbindung in Terraform konfigurieren möchten, geben Sie den Block auth_provider_binding mit dem Ressourcennamen Ihres Authentifizierungsanbieters sowie dessen Bereichen und Weiterleitungs-URI an:
resource "google_agent_registry_binding" "auth_binding" {
location = "REGION"
binding_id = "BINDING_NAME"
display_name = "DISPLAY_NAME"
source {
identifier = "SOURCE_ID"
}
target {
identifier = "TARGET_ID"
}
auth_provider_binding {
auth_provider = "projects/PROJECT_ID/locations/REGION/authProviders/AUTH_PROVIDER_ID"
scopes = [SCOPES]
continue_uri = "CONTINUE_URI"
}
}
Ersetzen Sie Folgendes:
REGION: die Registry-Region.BINDING_NAME: der eindeutige Name, den Sie der Bindung geben möchten.DISPLAY_NAME: der menschenlesbare Name der Bindung.SOURCE_ID: die Agent-ID des Quell-Agenten im URN-Format.TARGET_ID: die Registry-ID der Zielressource im URN-Format.PROJECT_ID: Projekt-ID.AUTH_PROVIDER_ID: die ID des Authentifizierungsanbieters.SCOPES: eine durch Kommas getrennte Liste von OAuth 2.0-Bereichen, z. B."https://www.googleapis.com/auth/cloud-platform".CONTINUE_URI: der Fortsetzungs-URI des Authentifizierungsanbieters, z. B.https://example.com/continue.
Beispiele für die Verwendung dieser Bindungen in Ihrem Agenten-Code finden Sie unter Bindungen im ADK-Code (Agent Development Kit) auflösen.
Bindungen auflisten
Listen Sie alle Bindungen an einem bestimmten Standort mit dem Befehl gcloud agent-registry bindings list auf:
gcloud agent-registry bindings list \
--project=PROJECT_ID \
--location=REGION
Ersetzen Sie Folgendes:
PROJECT_ID: Projekt-ID.REGION: die Registry-Region.
Bindungsdetails ansehen
Rufen Sie die Details einer einzelnen Bindung mit dem Befehl gcloud agent-registry bindings describe ab:
gcloud agent-registry bindings describe BINDING_NAME \
--project=PROJECT_ID \
--location=REGION
Ersetzen Sie Folgendes:
BINDING_NAME: der Name der Bindung.PROJECT_ID: Projekt-ID.REGION: die Registry-Region.
Bindung aktualisieren
Aktualisieren Sie die Parameter einer vorhandenen Bindung, z. B. den Anzeigenamen oder die Beschreibung:
gcloud
Führen Sie den Befehl gcloud agent-registry bindings update aus:
gcloud agent-registry bindings update BINDING_NAME \
--project=PROJECT_ID \
--location=REGION \
--display-name="NEW_DISPLAY_NAME"
Ersetzen Sie Folgendes:
BINDING_NAME: der Name der Bindung, die Sie aktualisieren möchten.PROJECT_ID: Projekt-ID.REGION: die Registry-Region.NEW_DISPLAY_NAME: der neue menschenlesbare Name für die Bindung.
Terraform
Wenn Sie den Anzeigenamen oder die Beschreibung einer Bindung mit Terraform aktualisieren möchten, ändern Sie die vorhandene google_agent_registry_binding-Ressource in Ihrer Konfiguration und führen Sie terraform apply aus.
Bindung löschen
Wenn Sie eine Verbindung zwischen Ressourcen entfernen möchten, löschen Sie die Bindung:
gcloud
Führen Sie den Befehl gcloud agent-registry bindings delete aus:
gcloud agent-registry bindings delete BINDING_NAME \
--project=PROJECT_ID \
--location=REGION
Ersetzen Sie Folgendes:
BINDING_NAME: der Name der Bindung, die Sie löschen möchten.PROJECT_ID: Projekt-ID.REGION: die Registry-Region.
Terraform
Entfernen Sie die google_agent_registry_binding-Ressource, die die Bindung darstellt, aus Ihrer Terraform-Konfiguration und führen Sie dann terraform apply aus.
Nächste Schritte
- Authentifizierung bei Tools und Ressourcen mithilfe von Bindungen von Authentifizierungsanbietern
- Endpunkte auflösen und Orchestratoren erstellen mit dem ADK