Agent Registry categoriza los componentes de agentes de tu ecosistema en tres tipos principales que puedes descubrir en tu entorno:
- Agentes: Actores autónomos que poseen habilidades específicas. Las habilidades representan las capacidades de alto nivel de un agente y son un mecanismo principal para el descubrimiento.
- Servidores MCP: Proveedores de recursos de datos y herramientas estandarizados. Las herramientas son funciones deterministas expuestas por un servidor MCP que los agentes pueden invocar para realizar acciones específicas.
- Extremos: URLs de destino, por lo general, APIs de REST, a las que accede un agente. Al abstraer estos destinos en recursos administrables, Agent Registry te permite controlar de forma centralizada a qué APIs externas pueden acceder tus agentes.
Para obtener más información sobre estos y otros conceptos que usa Agent Registry, consulta Conceptos clave.
La API de Agent Registry separa las operaciones de lectura y escritura. En Agent Registry, un
Service es un recurso de API que se puede escribir
que representa un agente, un servidor MCP o un extremo que agregas manualmente a
tu registro. Agent Registry también registra automáticamente los agentes y servidores implementados en supportedruntimes. Google Cloud
Para registrar y administrar tus agentes, servidores MCP y extremos, habilita la API de Agent Registry. Puedes usar el recurso Service que se puede escribir para crear, actualizar y borrar entradas de forma manual en tu registro. Luego, consulta los recursos Agent, McpServer o Endpoint de solo lectura para obtener, enumerar y buscar tus agentes, servidores y extremos registrados, respectivamente.
Para comenzar, consulta Configura Agent Registry.
Registra componentes de agentes en tu registro
Agent Registry mantiene tu catálogo de agentes y servidores MCP a través de dos mecanismos de registro: automático y manual. Usa el recurso Service para crear, actualizar y borrar entradas de forma manual.
| Mecanismo de registro | Descripción | Componente registrado | Productos decompatibles Google Cloud |
|---|---|---|---|
| Registro automático | Puedes configurar y usar Agent Registry para descubrir y procesar automáticamente recursos específicos implementados en supported Google Cloud runtimes. En el caso de los agentes que implementan el protocolo abierto Agent2Agent (A2A), el registro también extrae automáticamente sus habilidades y capacidades de su tarjeta de agente. | Agentes |
|
| Servidores MCP | Servidores MCP oficiales de Google y Google Cloud remotos | ||
| Registro manual |
En el caso de los recursos externos, los componentes de agentes personalizados en entornos de ejecución no compatibles
o los agentes de REST estándar que no implementan el protocolo A2A,
debes registrarlos de forma manual creando un
Service recurso en el registro.
|
Agentes | Agentes remotos |
| Servidores MCP | Componentes de agentes personalizados en entornos de ejecución no compatibles o servidores MCP externos |
¿Qué sigue?
- Revisa los conceptos clave para familiarizarte con los términos esenciales que se usan en Agent Registry.
- Configura Agent Registry.
- Obtén información sobre la diferencia entre el registro automático y el manual para los agentes.