Agent Registry ti consente di scoprire, aggiornare e rimuovere gli endpoint registrati in modo che i tuoi agenti indirizzino il traffico verso URL di destinazione validi. Puoi ispezionare gli endpoint disponibili nel tuo progetto, aggiornare i dettagli di connessione man mano che l'infrastruttura cambia e rimuovere gli endpoint non più in uso.
Prima di iniziare
- Configura Agent Registry.
Per una configurazione con un singolo progetto, recupera l'ID progetto del progetto di governance in cui è abilitato Agent Registry. Se hai configurato un confine di gestione per più progetti, utilizza l'ID del progetto di gestione per il rilevamento e la registrazione a livello di confine oppure specifica l'ID di un progetto membro per le operazioni su un singolo progetto.
Registra gli endpoint in Agent Registry.
Per utilizzare i comandi di Google Cloud CLI in questo documento, configura l'ambiente gcloud CLI.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per gestire gli endpoint in Agent Registry, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto di governance in cui è abilitato Agent Registry:
-
Endpoint di rilevamento:
Agent Registry API Viewer (
roles/agentregistry.viewer) -
Aggiorna ed elimina endpoint:
Agent Registry API Editor (
roles/agentregistry.editor)
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.
Endpoint di rilevamento
Per sfogliare gli URL di destinazione e le API REST registrate nel tuo ambiente, elenca le risorse Endpoint disponibili.
Elenca tutti gli endpoint
Elenca tutti gli endpoint registrati nel tuo ambiente:
Console
Nella console Google Cloud , vai a Agent Registry:
Nel selettore di progetti, seleziona il progetto Google Cloud in cui hai configurato Agent Registry.
Seleziona la scheda Endpoint.
La pagina mostra un elenco di tutti gli endpoint registrati e i relativi dettagli, come nome, descrizione e località.
Per visualizzare i dettagli completi della connessione di un endpoint, fai clic sul nome dell'endpoint.
gcloud
Per elencare tutti gli endpoint in una località specifica, esegui il comando gcloud agent-registry endpoints list:
gcloud agent-registry endpoints list \
--project=PROJECT_ID \
--location=REGION
Sostituisci quanto segue:
PROJECT_ID: l'ID progettoREGION: la regione del registry.
Filtra gli endpoint registrati
Se hai più endpoint, puoi filtrare l'elenco in base ai metadati dell'endpoint:
Console
Nella console Google Cloud , vai a Agent Registry:
Nel selettore di progetti, seleziona il progetto Google Cloud in cui hai configurato Agent Registry.
Seleziona la scheda Endpoint.
La pagina mostra un elenco di tutti gli endpoint registrati e i relativi dettagli, come nome, descrizione e località.
Per filtrare in base alla località, fai clic sul menu Località, seleziona le località che vuoi filtrare e fai clic su Applica.
La pagina mostra un elenco filtrato degli endpoint registrati per le condizioni selezionate.
gcloud
Filtra l'elenco in modo da restituire solo le risorse corrispondenti a metadati specifici passando il flag --filter al comando gcloud agent-registry endpoints list:
gcloud agent-registry endpoints list \
--project=PROJECT_ID \
--location=REGION \
--filter="FILTER_EXPRESSION"
Sostituisci quanto segue:
PROJECT_ID: l'ID progettoREGION: la regione del registry.FILTER_EXPRESSION: l'espressione di filtro per gli endpoint che vuoi filtrare. Ad esempio, per filtrare in base al nome visualizzato, utilizzadisplayName='DISPLAY_NAME'. Per filtrare in base all'identificatore dell'endpoint (URN) univoco a livello globale, utilizzaendpointId='urn:endpoint:ENDPOINT_URN'.
Terraform
Per recuperare un endpoint registrato specifico filtrando in base ai relativi metadati, configura l'origine dati google_agent_registry_endpoint con l'argomento filter:
data "google_agent_registry_endpoint" "filtered_endpoint" {
location = "REGION"
filter = "displayName=\"DISPLAY_NAME\""
}
Sostituisci quanto segue:
REGION: la regione del registry.DISPLAY_NAME: il nome leggibile dell'endpoint in base al quale filtrare, ad esempioExample API Endpoint.
Visualizza i dettagli di un endpoint
Visualizza i dettagli di un endpoint specifico, inclusi i dettagli della connessione e le associazioni del protocollo:
Console
Nella console Google Cloud , vai a Agent Registry:
Nel selettore di progetti, seleziona il progetto Google Cloud in cui hai configurato Agent Registry.
Seleziona la scheda Endpoint.
La pagina mostra un elenco di tutti gli endpoint registrati e i relativi dettagli, come nome, descrizione e località.
Fai clic sul nome dell'endpoint che vuoi visualizzare.
La pagina Panoramica mostra il nome, la descrizione, la località e i dettagli di connessione dell'endpoint, inclusi l'URL di destinazione e le associazioni del protocollo.
gcloud
Recupera i metadati dettagliati su un endpoint specifico, inclusi l'URL dell'interfaccia completo e l'associazione del protocollo, eseguendo il comando gcloud agent-registry endpoints describe:
gcloud agent-registry endpoints describe ENDPOINT_NAME \
--project=PROJECT_ID \
--location=REGION
Sostituisci quanto segue:
PROJECT_ID: l'ID progettoREGION: la regione del registry.ENDPOINT_NAME: il nome dell'endpoint, ad esempiomy-external-api.
Terraform
Per recuperare i dettagli di un endpoint registrato specifico utilizzando il suo ID, configura l'origine dati google_agent_registry_endpoint:
data "google_agent_registry_endpoint" "my_endpoint" {
location = "REGION"
endpoint_id = "ENDPOINT_NAME"
}
output "endpoint_create_time" {
description = "The timestamp when the endpoint was registered."
value = data.google_agent_registry_endpoint.my_endpoint.create_time
}
output "endpoint_update_time" {
description = "The timestamp when the endpoint was last updated."
value = data.google_agent_registry_endpoint.my_endpoint.update_time
}
Sostituisci quanto segue:
REGION: la regione del registry.ENDPOINT_NAME: l'identificatore univoco del tuo endpoint, ad esempiomy-external-api.
Aggiorna un endpoint
Se l'URL sottostante di un endpoint di destinazione esterno cambia, puoi aggiornare i dettagli dell'interfaccia dell'endpoint.
In Agent Registry, le risorse Endpoint sono risorse di rilevamento di sola lettura.
Pertanto, per aggiornare un endpoint registrato, devi aggiornare direttamente la relativa risorsa Service scrivibile.
Per aggiornare un endpoint:
Console
Nella console Google Cloud , vai a Agent Registry:
Nel selettore di progetti, seleziona il progetto Google Cloud in cui hai configurato Agent Registry.
Seleziona la scheda Endpoint.
La pagina mostra un elenco di tutti gli endpoint registrati e i relativi dettagli, come nome, descrizione e località.
Fai clic sul nome dell'endpoint che vuoi aggiornare.
La pagina Panoramica mostra il nome, la descrizione, la località e i dettagli di connessione dell'endpoint, inclusi l'URL di destinazione e le associazioni del protocollo.
Fai clic su Modifica.
Nel riquadro Modifica servizio, inserisci le informazioni aggiornate per l'endpoint, ad esempio il nome visualizzato, la descrizione e l'URL di destinazione. Puoi testare la connessione all'endpoint da questo riquadro.
Fai clic su Salva.
gcloud
Esegui il comando gcloud agent-registry services update con il flag --interfaces per specificare il nuovo URL di destinazione:
gcloud agent-registry services update ENDPOINT_NAME \
--project=PROJECT_ID \
--location=REGION \
--interfaces=url=ENDPOINT_URL,protocolBinding=PROTOCOL
Sostituisci quanto segue:
ENDPOINT_NAME: il nome dell'endpoint, ad esempiomy-external-api.PROJECT_ID: l'ID progetto in cui è stata creata la risorsaService.REGION: la regione del registry.ENDPOINT_URL: il nuovo URL di destinazione, ad esempiohttps://new-api.example.com/v1/data.PROTOCOL: l'associazione del protocollo per l'interfaccia. I valori validi sonohttp-json,grpcojsonrpc.
Terraform
Per aggiornare l'URL di un endpoint o l'associazione del protocollo utilizzando Terraform, modifica il blocco interfaces della risorsa google_agent_registry_service esistente nella configurazione, quindi esegui terraform apply:
resource "google_agent_registry_service" "endpoint" {
location = "REGION"
service_id = "ENDPOINT_NAME"
display_name = "DISPLAY_NAME"
interfaces {
url = "ENDPOINT_URL"
protocol_binding = "PROTOCOL"
}
endpoint_spec {
type = "NO_SPEC"
}
}
Sostituisci quanto segue:
REGION: la regione del registry.ENDPOINT_NAME: il nome dell'endpoint.DISPLAY_NAME: il nome leggibile dell'endpoint.ENDPOINT_URL: il nuovo URL di destinazione, ad esempiohttps://new-api.example.com/v1/data.PROTOCOL: l'associazione del protocollo per l'interfaccia. I valori validi sonoHTTP_JSON,GRPCoJSONRPC.
Rimuovi un endpoint
Per rimuovere un endpoint dal registry, devi eliminare la relativa risorsa Service. Questa azione rimuove immediatamente l'endpoint dai risultati di ricerca di Discovery.
Per rimuovere un endpoint dal registry:
Console
Nella console Google Cloud , vai a Agent Registry:
Nel selettore di progetti, seleziona il progetto Google Cloud in cui hai configurato Agent Registry.
Seleziona la scheda Endpoint.
La pagina mostra un elenco di tutti gli endpoint registrati e i relativi dettagli, come nome, descrizione e località.
Fai clic sul nome dell'endpoint che vuoi rimuovere.
La pagina Panoramica mostra il nome, la descrizione, la località e i dettagli di connessione dell'endpoint, inclusi l'URL di destinazione e le associazioni del protocollo.
Fai clic su Elimina.
Nella finestra Elimina endpoint, inserisci
DELETEper confermare l'azione.Fai clic su Elimina.
gcloud
Esegui il comando gcloud agent-registry services delete:
gcloud agent-registry services delete ENDPOINT_NAME \
--project=PROJECT_ID \
--location=REGION
Sostituisci quanto segue:
ENDPOINT_NAME: il nome dell'endpoint che vuoi rimuovere, ad esempiomy-external-api.PROJECT_ID: l'ID progetto in cui è stata creata la risorsaService.REGION: la regione del registry.
Terraform
Rimuovi la risorsa google_agent_registry_service che rappresenta l'endpoint dalla configurazione Terraform, quindi esegui terraform apply.