Cómo usar el registro manual

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.

Debes registrar manualmente los agentes alojados fuera de Google Clouden el Registro de agentes. En este documento, se muestra cómo registrar agentes de forma manual en el Registro de agentes.

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 del Registro de agentes.

Antes de comenzar

Antes de comenzar, configura el Registro de agentes. Necesitas el ID del proyecto para realizar estas tareas.

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

Roles obligatorios

Para obtener los permisos que necesitas para registrar agentes de forma manual en el Registro de agentes, pídele a tu administrador que te otorgue el rol de IAM Editor de la API del Registro de agentes (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 agente compatible con A2A

Si tu agente remoto implementa la especificación de Agent2Agent (A2A), dirige el Registro de agentes a la carga útil agent-card.json del agente. El registro sincroniza automáticamente la tarjeta de agente y, luego, indexa las habilidades disponibles del agente para el descubrimiento.

Sigue estos pasos para registrar el agente:

Console

1. En la Google Cloud consola, ve al Registro de agentes:

   Ir al Registro de agentes

2. En el selector de proyectos, selecciona el Google Cloud proyecto en el que configuraste el Registro de agentes.

3. Selecciona la pestaña Agentes.

4. Haz clic en Agregar agente.

5. En el panel Detalles del agente , ingresa un nombre visible y una descripción, y selecciona la región geográfica.

6. Para el tipo de agente, selecciona A2A.

7. En la sección de especificación del agente, selecciona la pestaña Pegar JSON y pega el contenido completo de tu archivo agent-card.json.

8. Haz clic en Guardar.

gcloud

Para registrar un agente A2A, guarda la tarjeta de agente del agente como un archivo JSON local, por ejemplo, agent-card.json, y haz lo siguiente:

gcloud alpha agent-registry services create AGENT_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --display-name="DISPLAY_NAME" \
  --agent-spec-type=a2a-agent-card \
  --agent-spec-content=@agent-card.json

Nota: El archivo de especificación del agente que subas no debe superar los 10 KB.

Reemplaza lo siguiente:

• AGENT_NAME: Es el nombre que deseas asignarle a tu agente, por ejemplo, my-support-agent.
• PROJECT_ID: Es el ID del proyecto.
• REGION: Es la región del registro.
• DISPLAY_NAME: Es el nombre legible que deseas asignarle a tu agente, por ejemplo, Support Agent.

Registra un agente REST estándar

Los agentes REST estándar se pueden descubrir por nombre y descripción, pero no tienen habilidades que se puedan buscar, a menos que adopten el protocolo A2A.

Si deseas registrar un agente remoto que no implementa la especificación A2A, como un extremo de API de REST o SaaS estándar, la API del Registro de agentes crea un recurso Service sin especificación de protocolo de agente.

Sigue estos pasos para registrar el agente:

Console

1. En la Google Cloud consola, ve al Registro de agentes:

   Ir al Registro de agentes

2. En el selector de proyectos, selecciona el Google Cloud proyecto en el que configuraste el Registro de agentes.

3. Selecciona la pestaña Agentes.

4. Haz clic en Agregar agente.

5. En el panel Detalles del agente , ingresa un nombre visible y una descripción, y selecciona la región geográfica.

6. Para el tipo de agente, selecciona la opción que indica que no hay especificación, como Non-A2A.

7. Ingresa el extremo en el que se aloja el agente y selecciona la vinculación de protocolo si es necesario, como HTTP_JSON.

8. Haz clic en Guardar.

gcloud

De manera opcional, puedes proporcionar la interfaz de extremo HTTP/JSON definida con la marca --interfaces para que el registro establezca una conexión con el agente.

Para registrar un agente REST estándar, haz lo siguiente:

gcloud alpha agent-registry services create AGENT_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --display-name="DISPLAY_NAME" \
  --agent-spec-type=no-spec \
  --interfaces=url=ENDPOINT_URL,protocolBinding=PROTOCOL

Reemplaza lo siguiente:

• AGENT_NAME: Es el nombre que deseas asignarle a tu agente, por ejemplo, my-remote-rest-agent.
• PROJECT_ID: Es el ID del proyecto.
• REGION: Es la región del registro.
• DISPLAY_NAME: Es el nombre legible que deseas asignarle a tu agente, por ejemplo, Remote REST Agent.
• ENDPOINT_URL: Es la URL del extremo del servicio del agente, por ejemplo, https://api.remote-service.com/v1/agents/1234.
• PROTOCOL: Es la vinculación de protocolo para el extremo. Los valores válidos son HTTP_JSON, GRPC o JSONRPC.

Verifica el registro

Después de registrar tu agente, verifica que el Registro de agentes haya procesado correctamente el Service y haya creado el recurso Agent correspondiente:

Console

1. En la Google Cloud consola, ve al Registro de agentes:

   Ir al Registro de agentes

2. En el selector de proyectos, selecciona el Google Cloud proyecto en el que configuraste el Registro de agentes.

3. Selecciona la pestaña Agentes.

   La página debe mostrar una lista de todos los agentes registrados y sus detalles.

gcloud

gcloud alpha agent-registry agents list \
  --project=PROJECT_ID \
  --location=REGION

Si tienes varios agentes o si deseas confirmar el registro de un solo agente, puedes filtrar la lista por los metadatos del agente:

gcloud alpha agent-registry agents list \
  --project=PROJECT_ID \
  --location=REGION \
  --filter="FILTER_EXPRESSION"

Reemplaza lo siguiente:

• PROJECT_ID: Es el ID del proyecto.
• REGION: Es la región del registro.
• FILTER_EXPRESSION: Es la expresión de filtro para los agentes que deseas filtrar. Por ejemplo, para filtrar por nombre visible, puedes usar displayName='DISPLAY_NAME'. Para filtrar por el identificador único global (URN), puedes usar agentId='urn:agent:AGENT_URN'.