Registra extremos

Vista previa

Este producto o función está sujeto a las "Condiciones de la Oferta de la Fase Previa a la DG" en la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Los productos y las funciones de la fase previa a la DG están disponibles “tal como están” y pueden estar sujetos a asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

En el registro de agentes, 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 se puede conectar tu flota de agentes.

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

Nota: El registro manual no se admite en las ubicaciones de multirregión us y eu. Debes registrar los recursos en una región admitida o en la ubicación de global. Para obtener más información, consulta Ubicaciones del Registro de agentes.

Antes de comenzar

Antes de comenzar, configura el registro de agentes. Necesitarás el ID de tu proyecto para realizar estas tareas.

Para usar los comandos de gcloud CLI en este documento, asegúrate de configurar 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 de 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

Como los extremos son destinos externos personalizados, usa el registro manual para agregarlos al registro de agentes:

Console

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

   Ir a Agent Registry

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

3. Selecciona la pestaña Endpoints.

4. Haz clic en Agregar extremo.

5. En el panel Detalles del extremo, 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

Creas 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: 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 del protocolo para la interfaz. Los valores válidos son HTTP_JSON, GRPC o JSONRPC.

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