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 componentes de agente administrados en Agent Registry, puedes controlar de forma centralizada a qué extremos 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. Necesitarás el ID del proyecto para realizar estas tareas.

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

Roles obligatorios

Para obtener los permisos que necesitas para registrar extremos 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 mediante 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.

    De manera opcional, haz clic en Test connection en este panel para probar tu conexión a la URL de destino.

  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 agent-registry services create ENDPOINT_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --display-name="DISPLAY_NAME" \
  --endpoint-spec-type=no-spec \
  --interfaces=url=ENDPOINT_URL,protocolBinding=PROTOCOL

Reemplaza lo siguiente:

  • ENDPOINT_NAME: El nombre que deseas asignarle a tu extremo, por ejemplo, my-external-api.
  • PROJECT_ID: El ID del proyecto
  • REGION: La región del registro.
  • DISPLAY_NAME: El nombre legible del extremo.
  • ENDPOINT_URL: La URL de destino, por ejemplo, https://api.example.com/v1/data.
  • PROTOCOL: 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.

Terraform

Para registrar un extremo externo, configura el recurso google_agent_registry_service con el bloque endpoint_spec:

resource "google_agent_registry_service" "endpoint" {
  location     = "REGION"
  service_id   = "ENDPOINT_NAME"
  display_name = "DISPLAY_NAME"
  description  = "An external REST API registered using Terraform."

  interfaces {
    url              = "ENDPOINT_URL"
    protocol_binding = "PROTOCOL"
  }

  endpoint_spec {
    type = "NO_SPEC"
  }
}

output "endpoint_resource_name" {
  description = "The generated read-only Endpoint resource name."
  value       = google_agent_registry_service.endpoint.registry_resource
}

Reemplaza lo siguiente:

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