Registra endpoint

In Agent Registry, 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.

Prima di iniziare

Prima di iniziare, configura Agent Registry. Per eseguire queste attività, devi avere l'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 Editor API Agent Registry (roles/agentregistry.editor) 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.

Registrare un endpoint

Poiché gli endpoint sono destinazioni esterne personalizzate, utilizza la registrazione manuale per aggiungerli ad Agent Registry:

Console

  1. Nella Google Cloud console, vai ad Agent Registry:

    Vai ad Agent Registry

  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 connessione all'URL di destinazione da questo riquadro.

  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 della 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: il binding del protocollo per l'interfaccia. I valori validi sono HTTP_JSON, GRPC o JSONRPC.

Dopo aver creato la risorsa Service, Agent Registry genera automaticamente una risorsa Endpoint di sola lettura sul lato consumer che gli agenti e gli orchestratori possono scoprire e utilizzare.