27 Registro de IA
AI Registry es el catálogo central de agentes y servidores MCP para Oracle AI Data Platform. Admite estándares abiertos, incluidos MCP y A2A.
La plataforma de datos de IA es donde se crean y despliegan agentes. Oracle Agent Hub es donde los usuarios de negocio hablan con ellos. El registro de IA es la capa entre ellos. El registro de IA hace que un agente o una herramienta se puedan detectar y utilizar fuera del entorno en el que se creó. Los agentes y las herramientas deben estar registrados en AI Registry antes de que se puedan compartir en Agent Hub. Consulte Cómo funciona Enterprise AI en el hub de agente en Uso de Oracle Agent Hub.
Puede registrar los siguientes agentes y herramientas en el registro de IA de AI Data Platform:
| Tipo | Descripción |
|---|---|
| Agente de AI Data Platform | Un agente creado y desplegado en AI Data Platform, en un espacio de trabajo al que tiene acceso. También se denomina agente local en el registro de IA de AI Data Platform. |
| Agente externo | Un agente alojado fuera de AI Data Platform, agregado por la URL de su tarjeta de agente A2A. |
| Servidor MCP | Un servidor de protocolo de contexto de modelo (MCP) que expone un conjunto de herramientas que los agentes pueden llamar. |
En AI Registry, puede gestionar los agentes de IA, los servidores MCP y las credenciales necesarias para usar ambos. En la página AI Registry, puede utilizar los separadores Agents (Agentes), MCP servers (Servidores MCP) y Credentials (Credenciales) para ver una lista de cada uno. Puede utilizar la barra de búsqueda para filtrar las opciones visibles por nombre o descripción. En el separador Agentes, puede utilizar el menú desplegable Ordenar por para ordenar por la fecha en la que se han agregado los agentes al registro.
Al hacer clic en una tarjeta de agente, se muestran los detalles de ese agente y se proporciona el creador, el origen, la versión, una URL para la tarjeta de agente y la versión del protocolo. Puede cambiar entre la vista de detalles y una vista JSON de la tarjeta mediante las opciones de la esquina superior derecha de la tarjeta.
Antes de registrar nuevos agentes externos o servidores MCP, primero debe registrar sus credenciales de autenticación en el separador Credenciales. A continuación, puede registrar nuevos agentes y servidores MCP haciendo clic en Registrar en la parte superior derecha y seleccionando la opción adecuada. Los permisos para AI Registry se gestionan desde el separador Permissions (Permisos).
Acerca de las tarjetas de agente
Las tarjetas de agente son la estructura de metadatos que describe un agente. AI Registry los lee durante el registro y se los muestra para su revisión antes de confirmar.
Para obtener más información, consulte la Especificación del protocolo A2A.
- Nombre, versión y descripción.
- URL de la tarjeta de agente, que es donde se publica la propia tarjeta.
- Versión de Protocolo.
- Modos de entrada y salida. Por ejemplo, texto, texto/plano o texto/html.
- Capacidades, como Streaming.
- Habilidades, cada una con su propio nombre y descripción.
Crear credenciales en AI Registry
Puede guardar las credenciales necesarias para su uso en la autenticación de objetos de AI Registry como agentes y servidores MCP.
- En la página de inicio, haga clic en
Registro de AI. - Haga clic en el separador Credenciales y, a continuación, en Crear credencial.
- Introduzca un nombre y una descripción para la credencial.
- Seleccione el tipo de credencial en el menú desplegable.
- Seleccione el tipo Grant en el menú desplegable.
- Introduzca la URL de autorización, la URL de token de acceso, el ID de cliente, el secreto de cliente y la URL de refrescamiento para las credenciales.
- Introduzca un nombre y un valor de ámbito. Se necesita al menos un nombre y un valor de ámbito. Agregue nombres y valores de ámbito adicionales haciendo clic en Agregar ámbito.
- Copie la URL de redirección. Debe pegar la URL de redirección en la aplicación confidencial del dominio de identidad. En el siguiente ejemplo se muestra cómo copiar la URL de redirección a Oracle Cloud Infrastructure:
- Conéctese a la consola de OCI.
- Haga clic en Identidad y seguridad, en Dominios y, a continuación, en Aplicaciones integradas.
- Seleccione la aplicación para la que desea actualizar las URL de redirección.
- Haga clic en el separador Configuración de OAuth y, a continuación, en Editar configuración de OAuth.
- Aplique las URL de redirección necesarias y, a continuación, haga clic en Enviar.
- Haga clic en Create.
Registro de un agente local en AI Registry
Puede registrar agentes de IA locales desde los espacios de trabajo de Oracle AI Data Platform a los que tiene acceso.
- En la página de inicio, haga clic en
Registro de AI. - Haga clic en Registrar y, a continuación, en Agente.
- Haga clic en Agente local.
- En el menú desplegable Espacio de trabajo, seleccione el espacio de trabajo en el que se encuentra el agente local.
- En el menú desplegable Agente, seleccione el agente que desea registrar.
- Opcional: desplace el mouse sobre el icono de la tarjeta para obtener una vista previa de la tarjeta de agente.
- Haga clic en Siguiente.
- Confirme que los detalles del agente son correctos y, a continuación, haga clic en Registrar.
Registrar un agente externo en AI Registry
Puede registrar agentes de IA externos de orígenes admitidos en su registro de IA. Estos agentes deben cumplir con el protocolo A2A.
- En la página de inicio, haga clic en
Registro de AI. - Haga clic en Registrar y, a continuación, en Agente.
- Haga clic en Agente externo.
- Introduzca la URL de la tarjeta de agente.
- Opcional: si el punto final necesita credenciales seguras, seleccione Requerir autenticación y, a continuación, seleccione las credenciales en el menú desplegable Credenciales.
- Haga clic en Siguiente.
- Opcional: si ha seleccionado Requerir autenticación, introduzca las credenciales de una cuenta que tiene derecho al agente en el cuadro de diálogo que aparece.
- Revise la precisión de los detalles del agente y, a continuación, haga clic en Registrar.
Registro de un servidor MCP en AI Registry
Un servidor MCP expone un conjunto de herramientas que los agentes pueden detectar y llamar a través de una interfaz estándar. Registrar una en AI Registry hace que esas herramientas estén disponibles en la plataforma.
Note:
Si el servidor MCP requiere autenticación, primero debe crear las credenciales OAuth en AI Registry. No se pueden agregar credenciales como parte del registro de un servidor MCP.- En la página de inicio, haga clic en
Registro de AI. - Haga clic en Registrar y, a continuación, en Servidor de MCP.
- Introduzca la URL del punto final del servidor MCP.
- Introduzca un nombre mostrado y una descripción útiles. Los usuarios y agentes los utilizarán para identificar la finalidad del servidor MCP.
- En el menú desplegable, seleccione el método Transporte.
- Opcional: si el servidor MCP necesita credenciales seguras, seleccione Requerir autenticación. Seleccione las credenciales en el menú desplegable Credenciales.
- Haga clic en Continuar.
- Revise la lista de herramientas incluidas para el servidor MCP seleccionado. Seleccione las herramientas que desea incluir individualmente o haga clic en Seleccionar todo para incluir todas las herramientas enumeradas.
- Haga clic en Registrar.