Registra extremos

En Agent Registry, un extremo representa una URL de destino, por lo general, una API de REST, a la que acceden tus agentes. Si registras estos destinos como recursos administrados, puedes controlar de forma centralizada a qué servicios externos puede conectarse tu flota de agentes.

En este documento, se explica cómo registrar de forma explícita extremos externos en el registro.

Antes de comenzar

Antes de comenzar, configura Agent Registry. Necesitas el ID de tu proyecto para realizar estas tareas.

Para usar los comandos de gcloud CLI en este documento, asegúrate de haber configurado tu entorno de Google Cloud CLI.

Roles obligatorios

Para obtener los permisos que necesitas para registrar endpoints en Agent Registry, pídele a tu administrador que te otorgue el rol de IAM Editor de la API de Agent Registry (roles/agentregistry.editor) en el proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Registra un extremo

Dado que los extremos son destinos externos personalizados, usa el registro manual para agregarlos a Agent Registry:

Console

  1. En la Google Cloud consola, ve a Agent Registry:

    Ir a Agent Registry

  2. En el selector de proyectos, selecciona el Google Cloud proyecto en el que configuraste Agent Registry.

  3. Selecciona la pestaña Endpoints.

  4. Haz clic en Add endpoint.

  5. En el panel Endpoint details , ingresa el nombre visible, una descripción, la región geográfica y la URL de destino. Puedes probar tu conexión a la URL de destino desde este panel.

  6. Haz clic en Guardar.

gcloud

Crea un recurso Service con un endpoint-spec-type de no-spec.

Registra el extremo y define los detalles de conexión de su interfaz:

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

Reemplaza lo siguiente:

  • SERVICE_NAME: Es el nombre que deseas asignarle a tu recurso, por ejemplo, my-external-api.
  • PROJECT_ID: Es el ID del proyecto.
  • REGION: Es la región del registro.
  • DISPLAY_NAME: Es el nombre legible del extremo.
  • ENDPOINT_URL: Es la URL de destino, por ejemplo, https://api.example.com/v1/data.
  • PROTOCOL: Es la vinculación de protocolo para la interfaz. Los valores válidos son HTTP_JSON, GRPC o JSONRPC.

Después de crear el recurso Service, Agent Registry genera automáticamente un recurso Endpoint de solo lectura en el lado del consumidor que los agentes y los orquestadores pueden descubrir y usar.