Registra extremos

Vista previa

Este producto o esta función se encuentra sujeto a las "Condiciones de la oferta de la fase previa a la DG" en la sección Condiciones del servicio generales 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 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 agentes 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 los extremos externos en el registro.

Nota: El registro manual no es compatible con las ubicaciones multirregionales us y eu. Debes registrar los recursos en una región admitida o en la ubicación global. Para obtener más información, consulta Ubicaciones de Agent Registry.

Antes de comenzar

Antes de comenzar, configura Agent Registry. Necesitas 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 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.

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

   Nota: Puedes registrar extremos que usen URLs privadas. Sin embargo, la prueba de conexión solo funciona para extremos públicos y verifica si se puede acceder a la URL pública. La prueba no admite URLs privadas ni extremos que requieran el envío de datos autenticados, como Agent Runtime en los extremos de Gemini Enterprise Agent Platform.

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 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.