Registra endpoint

Anteprima

Questo prodotto o funzionalità sono soggetti ai "Termini delle Offerte pre-GA" nella sezione Termini di servizio generali dei Termini specifici dei servizi. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Nel registro degli agenti, un endpoint rappresenta un URL di destinazione, in genere un'API REST, a cui accedono i tuoi agenti. Registrando queste destinazioni come risorse gestite, puoi controllare centralmente a quali servizi esterni può connettersi la tua flotta di agenti.

Questo documento spiega come registrare esplicitamente gli endpoint esterni nel registro.

Nota: la registrazione manuale non è supportata nelle località multi-regionali us e eu. Devi registrare le risorse in una regione supportata o nella località global. Per saperne di più, consulta Località del registro degli agenti.

Prima di iniziare

Prima di iniziare, configura il registro degli agenti. Per eseguire queste attività, devi disporre dell'ID progetto.

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 registrare gli endpoint in Agent Registry, chiedi all'amministratore di concederti il ruolo IAM Agent Registry API Editor (roles/agentregistry.editor) nel 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.

Registra un endpoint

Poiché gli endpoint sono destinazioni esterne personalizzate, utilizza la registrazione manuale per aggiungerli al registro degli agenti:

Console

1. Nella console Google Cloud , vai a Registro agenti:

   Vai al registry degli agenti

2. Nel selettore di progetti, seleziona il Google Cloud progetto in cui hai configurato Agent Registry.

3. Seleziona la scheda Endpoint.

4. Fai clic su Aggiungi endpoint.

5. Nel riquadro Dettagli endpoint, inserisci il nome visualizzato, una descrizione, la regione geografica e l'URL di destinazione. Puoi testare la tua connessione all'URL di destinazione da questo pannello.

6. Fai clic su Salva.

gcloud

Crea una risorsa Service con un endpoint-spec-type di no-spec.

Registra l'endpoint e definisci i dettagli di connessione dell'interfaccia:

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

Sostituisci quanto segue:

• SERVICE_NAME: il nome che vuoi assegnare alla risorsa, ad esempio my-external-api.
• PROJECT_ID: l'ID progetto.
• REGION: la regione del registro.
• DISPLAY_NAME: Il nome leggibile dell'endpoint.
• ENDPOINT_URL: l'URL di destinazione, ad esempio https://api.example.com/v1/data.
• PROTOCOL: l'associazione del protocollo per l'interfaccia. I valori validi sono HTTP_JSON, GRPC o JSONRPC.

Dopo la creazione della risorsa Service, il registro degli agenti genera automaticamente una risorsa Endpoint di sola lettura sul lato consumer che gli agenti e gli orchestratori possono scoprire e utilizzare.