Agent Registry te permite descubrir, actualizar y quitar extremos registrados para que tus agentes enruten el tráfico a URLs de destino válidas. Puedes inspeccionar los extremos disponibles en tu proyecto, actualizar sus detalles de conexión a medida que cambia tu infraestructura y quitar los extremos que ya no se usan.
Antes de comenzar
- Configura el Registro de agentes.
Para una configuración de un solo proyecto, obtén el ID del proyecto del proyecto de administración en el que está habilitado el Registro de agentes. Si configuraste un límite de administración para varios proyectos, usa el ID de tu proyecto de administración para el descubrimiento y el registro en todo el límite, o especifica un ID del proyecto miembro para las operaciones de un solo proyecto.
Registra extremos en Agent Registry.
Para usar los comandos de Google Cloud CLI en este documento, configura tu entorno de gcloud CLI.
Roles obligatorios
Para obtener los permisos que necesitas para administrar extremos en el Registro de agentes, pídele a tu administrador que te otorgue los siguientes roles de IAM en el proyecto de administración en el que está habilitado el Registro de agentes:
-
Descubre extremos:
Visualizador de la API de Agent Registry (
roles/agentregistry.viewer) -
Actualiza y borra extremos:
Editor de la API de Agent Registry (
roles/agentregistry.editor)
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.
Descubre extremos
Para explorar las URLs de destino y las APIs de REST registradas en tu entorno, enumera los
recursos Endpoint disponibles.
Enumera todos los extremos
Enumera todos los extremos registrados en tu entorno:
Console
En la consola de Google Cloud , ve a Agent Registry:
En el selector de proyectos, elige el proyecto de Google Cloud en el que configuraste Agent Registry.
Selecciona la pestaña Extremos.
En la página, se muestra una lista de todos los extremos registrados y sus detalles, como el nombre, la descripción y la ubicación.
Para ver los detalles de conexión completos de un extremo, haz clic en su nombre.
gcloud
Para enumerar todos los extremos en una ubicación específica, ejecuta el comando
gcloud agent-registry endpoints list:
gcloud agent-registry endpoints list \
--project=PROJECT_ID \
--location=REGION
Reemplaza lo siguiente:
PROJECT_ID: Es el ID del proyecto.REGION: Es la región del registro.
Filtra los extremos registrados
Si tienes varios extremos, puedes filtrar la lista por los metadatos del extremo:
Console
En la consola de Google Cloud , ve a Agent Registry:
En el selector de proyectos, selecciona el proyecto de Google Cloud en el que configuraste el Registro de agentes.
Selecciona la pestaña Extremos.
En la página, se muestra una lista de todos los extremos registrados y sus detalles, como el nombre, la descripción y la ubicación.
Para filtrar por ubicación, haz clic en el menú Ubicación, selecciona las ubicaciones que deseas filtrar y haz clic en Aplicar.
En la página, se muestra una lista filtrada de los extremos registrados para las condiciones que seleccionaste.
gcloud
Filtra tu lista para que solo se muestren los recursos que coincidan con metadatos específicos.
Para ello, pasa la marca --filter al comando
gcloud agent-registry endpoints list:
gcloud agent-registry endpoints 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 extremos que deseas filtrar. Por ejemplo, para filtrar por nombre visible, usadisplayName='DISPLAY_NAME'. Para filtrar por el identificador de extremo (URN) único a nivel global, usaendpointId='urn:endpoint:ENDPOINT_URN'.
Terraform
Para recuperar un extremo registrado específico filtrando sus metadatos,
configura la fuente de datos google_agent_registry_endpoint con el argumento
filter:
data "google_agent_registry_endpoint" "filtered_endpoint" {
location = "REGION"
filter = "displayName=\"DISPLAY_NAME\""
}
Reemplaza lo siguiente:
REGION: Es la región del registro.DISPLAY_NAME: Es el nombre legible por humanos del extremo por el que se filtrará, por ejemplo,Example API Endpoint.
Visualiza los detalles de un extremo
Consulta los detalles de un extremo específico, incluidos los detalles de conexión y las vinculaciones de protocolo:
Console
En la consola de Google Cloud , ve a Agent Registry:
En el selector de proyectos, selecciona el proyecto de Google Cloud en el que configuraste el Registro de agentes.
Selecciona la pestaña Extremos.
En la página, se muestra una lista de todos los extremos registrados y sus detalles, como el nombre, la descripción y la ubicación.
Haz clic en el nombre del extremo que deseas ver.
En la página Descripción general, se muestran el nombre, la descripción, la ubicación y los detalles de conexión del extremo, incluidas la URL de destino y las vinculaciones de protocolo.
gcloud
Ejecuta el comando
gcloud agent-registry endpoints describe
para recuperar metadatos detallados sobre un extremo específico, incluida la URL de la interfaz completa
y la vinculación de protocolo:
gcloud agent-registry endpoints describe ENDPOINT_NAME \
--project=PROJECT_ID \
--location=REGION
Reemplaza lo siguiente:
PROJECT_ID: Es el ID del proyecto.REGION: Es la región del registro.ENDPOINT_NAME: el nombre de tu extremo, por ejemplo,my-external-api.
Terraform
Para recuperar detalles sobre un extremo registrado específico con su ID,
configura la fuente de datos google_agent_registry_endpoint:
data "google_agent_registry_endpoint" "my_endpoint" {
location = "REGION"
endpoint_id = "ENDPOINT_NAME"
}
output "endpoint_create_time" {
description = "The timestamp when the endpoint was registered."
value = data.google_agent_registry_endpoint.my_endpoint.create_time
}
output "endpoint_update_time" {
description = "The timestamp when the endpoint was last updated."
value = data.google_agent_registry_endpoint.my_endpoint.update_time
}
Reemplaza lo siguiente:
REGION: Es la región del registro.ENDPOINT_NAME: Es el identificador único de tu extremo, por ejemplo,my-external-api.
Actualiza un extremo
Si cambia la URL subyacente de un extremo de destino externo, puedes actualizar los detalles de la interfaz del extremo.
En el Registro de agentes, los recursos Endpoint son recursos de descubrimiento de solo lectura.
Por lo tanto, para actualizar un extremo registrado, debes actualizar su recurso Service
escribible directamente.
Sigue estos pasos para actualizar un extremo:
Console
En la consola de Google Cloud , ve a Agent Registry:
En el selector de proyectos, selecciona el proyecto de Google Cloud en el que configuraste el Registro de agentes.
Selecciona la pestaña Extremos.
En la página, se muestra una lista de todos los extremos registrados y sus detalles, como el nombre, la descripción y la ubicación.
Haz clic en el nombre del extremo que deseas actualizar.
En la página Descripción general, se muestran el nombre, la descripción, la ubicación y los detalles de conexión del extremo, incluidas la URL de destino y las vinculaciones de protocolo.
Haz clic en Editar.
En el panel Editar servicio, ingresa la información actualizada del extremo, como el nombre visible, la descripción y la URL de destino. Puedes probar la conexión al extremo desde este panel.
Haz clic en Guardar.
gcloud
Ejecuta el comando
gcloud agent-registry services update
con la marca --interfaces para especificar la nueva URL de destino:
gcloud agent-registry services update ENDPOINT_NAME \
--project=PROJECT_ID \
--location=REGION \
--interfaces=url=ENDPOINT_URL,protocolBinding=PROTOCOL
Reemplaza lo siguiente:
ENDPOINT_NAME: el nombre de tu extremo, por ejemplo,my-external-api.PROJECT_ID: Es el ID del proyecto en el que se creó el recursoService.REGION: Es la región del registro.ENDPOINT_URL: Es la nueva URL de destino, por ejemplo,https://new-api.example.com/v1/data.PROTOCOL: Es la vinculación de protocolo para la interfaz. Los valores válidos sonhttp-json,grpcojsonrpc.
Terraform
Para actualizar una URL de extremo o una vinculación de protocolo con Terraform, modifica el
bloque interfaces de tu recurso google_agent_registry_service existente
en tu configuración y, luego, ejecuta terraform apply:
resource "google_agent_registry_service" "endpoint" {
location = "REGION"
service_id = "ENDPOINT_NAME"
display_name = "DISPLAY_NAME"
interfaces {
url = "ENDPOINT_URL"
protocol_binding = "PROTOCOL"
}
endpoint_spec {
type = "NO_SPEC"
}
}
Reemplaza lo siguiente:
REGION: Es la región del registro.ENDPOINT_NAME: Es el nombre de tu extremo.DISPLAY_NAME: Es el nombre legible por humanos del extremo.ENDPOINT_URL: Es la nueva URL de destino, por ejemplo,https://new-api.example.com/v1/data.PROTOCOL: Es la vinculación de protocolo para la interfaz. Los valores válidos sonHTTP_JSON,GRPCoJSONRPC.
Quita un extremo
Para quitar un extremo del registro, debes borrar su recurso
Service. Esta acción quita de inmediato el extremo de los resultados de la búsqueda de descubrimiento.
Sigue estos pasos para quitar un extremo de tu registro:
Console
En la consola de Google Cloud , ve a Agent Registry:
En el selector de proyectos, selecciona el proyecto de Google Cloud en el que configuraste el Registro de agentes.
Selecciona la pestaña Extremos.
En la página, se muestra una lista de todos los extremos registrados y sus detalles, como el nombre, la descripción y la ubicación.
Haz clic en el nombre del extremo que deseas quitar.
En la página Descripción general, se muestran el nombre, la descripción, la ubicación y los detalles de conexión del extremo, incluidas la URL de destino y las vinculaciones de protocolo.
Haz clic en Borrar.
En la ventana Borrar extremo, ingresa
DELETEpara confirmar la acción.Haz clic en Borrar.
gcloud
Ejecuta el comando gcloud agent-registry services delete:
gcloud agent-registry services delete ENDPOINT_NAME \
--project=PROJECT_ID \
--location=REGION
Reemplaza lo siguiente:
ENDPOINT_NAME: Es el nombre del extremo que deseas quitar, por ejemplo,my-external-api.PROJECT_ID: Es el ID del proyecto en el que se creó el recursoService.REGION: Es la región del registro.
Terraform
Quita el recurso google_agent_registry_service que representa el extremo
de tu configuración de Terraform y, luego, ejecuta terraform apply.