Registrar endpoints

Visualizar

Este produto ou recurso está sujeito aos "Termos das Soluções Pré-GA" na seção "Termos Gerais de Serviço" dos Termos Específicos de Serviço. Os produtos e recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

No registro de agentes, um endpoint representa um URL de destino, geralmente uma API REST, que seus agentes acessam. Ao registrar esses destinos como recursos gerenciados, você pode controlar centralmente a quais serviços externos sua frota de agentes pode se conectar.

Neste documento, explicamos como registrar explicitamente endpoints externos no registro.

Observação: o registro manual não é compatível com as multirregiões us e eu. É preciso registrar recursos em uma região compatível ou no local global. Para mais informações, consulte Locais do Agent Registry.

Antes de começar

Antes de começar, configure o Agent Registry. Você precisa do ID do projeto para realizar essas tarefas.

Para usar os comandos da CLI gcloud Cloud neste documento, verifique se você configurou seu ambiente da Google Cloud CLI.

Funções exigidas

Para receber as permissões necessárias para registrar endpoints no Registro de agentes, peça ao administrador para conceder a você o papel do IAM de Editor da API Agent Registry (roles/agentregistry.editor) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

Registrar um endpoint

Como os endpoints são destinos externos personalizados, use o registro manual para adicioná-los ao registro de agentes:

Console

1. No console do Google Cloud , acesse Registro de agentes:

   Acessar o Agent Registry

2. No seletor de projetos, selecione o projeto Google Cloud em que você configurou o Agent Registry.

3. Selecione a guia Endpoints.

4. Clique em Adicionar endpoint.

5. No painel Detalhes do endpoint, insira o nome de exibição, uma descrição, a região geográfica e o URL de destino. É possível testar sua conexão com o URL de destino neste painel.

6. Clique em Salvar.

gcloud

Você cria um recurso Service com um endpoint-spec-type de no-spec.

Registre o endpoint e defina os detalhes da conexão de interface:

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

Substitua:

• SERVICE_NAME: o nome que você quer dar ao recurso, por exemplo, my-external-api.
• PROJECT_ID: o ID do projeto.
• REGION: a região do registro.
• DISPLAY_NAME: o nome legível do endpoint.
• ENDPOINT_URL: o URL de destino, por exemplo, https://api.example.com/v1/data.
• PROTOCOL: a vinculação de protocolo para a interface. Os valores válidos são HTTP_JSON, GRPC ou JSONRPC.

Depois que o recurso Service é criado, o Agent Registry gera automaticamente um recurso Endpoint somente leitura no lado do consumidor que agentes e orquestradores podem descobrir e usar.