Gestire i binding

In Agent Registry, un binding rappresenta una connessione tra un agente di origine e una risorsa di destinazione, ad esempio un altro agente, un server MCP o un endpoint. Creando i binding, stabilisci relazioni esplicite che consentono agli agenti orchestratori di interagire con le funzionalità downstream.

Utilizzi i binding per gestire due scenari:

  • Connessioni delle risorse:puoi collegare un agente di origine a una risorsa di destinazione, ad esempio un altro agente, un server MCP o un endpoint. Questo scenario ti consente di mappare i workflow multi-agente in cui un orchestratore principale delega le attività a subagenti o strumenti specializzati.
  • Autorizzazioni delegate:puoi associare un agente a un provider di autenticazione per consentire all'agente di connettersi a target esterni o strumenti personalizzati utilizzando le proprie credenziali o per conto di un singolo utente. Questo binding è necessario se l'agente deve autenticarsi su server o strumenti MCP remoti utilizzando token OAuth o chiavi API. Con i binding, non devi definire manualmente i fornitori di autenticazione nel codice. Per istruzioni dettagliate, consulta Creare un binding del fornitore di autenticazione in questo documento.

Questo documento descrive come creare, visualizzare, aggiornare ed eliminare i binding nel registro degli agenti.

Prima di iniziare

Prima di poter gestire i binding, completa le seguenti operazioni:

  1. Configura Agent Registry.
  2. Registra le risorse di origine e di destinazione. Per saperne di più, consulta Registrare i servizi.
  3. Se vuoi configurare i binding per le autorizzazioni delegate, crea un provider di autenticazione con Agent Identity auth manager. Per saperne di più, consulta Esegui l'autenticazione in strumenti e risorse.
  4. Per utilizzare i comandi gcloud CLI in questo documento, assicurati di aver configurato l'ambiente Google Cloud CLI.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per gestire i binding in Agent Registry, chiedi all'amministratore di concederti i seguenti ruoli IAM sul progetto:

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Crea un'associazione

Crea un binding per connettere un agente di origine a una risorsa di destinazione:

gcloud alpha agent-registry bindings create BINDING_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --display-name="DISPLAY_NAME" \
  --source-identifier="SOURCE_ID" \
  --target-identifier="TARGET_ID"

Sostituisci quanto segue:

  • BINDING_NAME: il nome che vuoi assegnare al binding, ad esempio my-custom-binding.
  • PROJECT_ID: l'ID progetto.
  • REGION: la regione del registro.
  • DISPLAY_NAME: il nome leggibile che vuoi assegnare all'associazione, ad esempio My Custom Binding.
  • SOURCE_ID: l'identificatore dell'agente di origine nel formato URN (Uniform Resource Name).
  • TARGET_ID: l'identificatore della risorsa di destinazione in formato URN, ad esempio un identificatore del server MCP.

Crea un binding del provider di autenticazione

Puoi associare un agente a un provider di autenticazione per le autorizzazioni delegate. Prima di creare questo binding, devi prima creare il provider di autenticazione con Agent Identity auth manager. Per saperne di più, consulta Esegui l'autenticazione in strumenti e risorse.

Quando specifichi il nome della risorsa --auth-provider, devi utilizzare l'ID progetto:

gcloud alpha agent-registry bindings create BINDING_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --display-name="DISPLAY_NAME" \
  --source-identifier="SOURCE_ID" \
  --auth-provider="projects/PROJECT_ID/locations/REGION/connectors/AUTH_PROVIDER_ID"

Sostituisci AUTH_PROVIDER_ID con l'ID del tuo provider di autenticazione.

Per esempi di come utilizzare questi binding nel codice dell'agente, vedi Risolvere i binding nel codice ADK.

Crea un elenco di associazioni

Elenca tutti i binding in una posizione specifica:

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

Visualizza i dettagli dell'associazione

Recupera i dettagli di un singolo binding:

gcloud alpha agent-registry bindings describe BINDING_NAME \
  --project=PROJECT_ID \
  --location=REGION

Aggiorna un binding

Aggiorna i parametri di un binding esistente, ad esempio il nome visualizzato o la descrizione, utilizzando i flag di gcloud CLI:

gcloud alpha agent-registry bindings update BINDING_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --display-name="NEW_DISPLAY_NAME"

Eliminare un'associazione

Per rimuovere un collegamento tra le risorse, elimina il record di binding:

gcloud alpha agent-registry bindings delete BINDING_NAME \
  --project=PROJECT_ID \
  --location=REGION

Passaggi successivi