Registro y administración de agentes en el Centro de API de Azure

En este artículo se muestra cómo registrar agentes de IA, incluidos los agentes de A2A, en el Centro de API, hacer que sean reconocibles para los usuarios y actualizarlos y administrarlos.

Prerrequisitos

• Una instancia del Centro de API de Azure
• Un agente descrito por una tarjeta de agente en formato JSON o una definición de agente en formato Markdown
• Permisos adecuados para editar las API en el Centro de API

Agente de registro

1. Inicie sesión en el portal Azure y vaya al centro de API.

2. En el menú de la barra lateral, en Inventario, seleccione Recursos.

3. Seleccione + Registrar un activo>Agente.

   

4. En el formulario Registrar un agente , escriba la información descrita en la tabla siguiente:

   Campo	Description
   Title	Escriba un nombre descriptivo para el agente, como el Agente del departamento de soporte técnico.
   Identificación	El Centro de API genera automáticamente un identificador basado en el título, como help-desk-agent. Puede editar este identificador si es necesario.
   Resumen breve	Escriba una breve descripción de una línea de lo que hace el agente que aparece en el portal del Centro de API y otras ubicaciones.
   Description	Opcionalmente, escriba una descripción más detallada de las funcionalidades, los casos de uso y el comportamiento de la aptitud.
   Version
   Título de la versión	Escriba un título de versión de su elección, como v1.
   Identificación de la versión	El Centro de API genera automáticamente un identificador basado en el título de la versión. Puede editar este identificador si es necesario.
   Ciclo de vida de una versión	Seleccione la fase actual del ciclo de vida de la versión del agente en el menú desplegable. Obtenga más información sobre las versiones en el Centro de API.
   Detalles del agente
   Definición del agente	Escriba una dirección URL o Seleccione un archivo para cargar una definición de agente. La definición del agente debe estar en formato Markdown e incluir detalles sobre las funcionalidades, aptitudes y otra información relevante del agente.
   Protocolo	Si procede, seleccione el protocolo A2A si el agente lo cumple.
   Tarjeta del agente	Opcionalmente, escriba una dirección URL o Seleccione un archivo para cargar una tarjeta del agente A2A en formato JSON.

   

5. Seleccione Crear para agregar el agente.

Después del registro, el agente aparece en su inventario en la página Inventario>Activos.

Actualización de un agente registrado

Puede actualizar la información del agente en cualquier momento.

1. En Azure Portal, vaya al Centro de API.
2. En el menú de la barra lateral, en Inventario, seleccione Recursos.
3. En la tabla, seleccione el nombre del agente en la columna Título .
4. Seleccione el botón Editar para abrir la página Editar en el panel de trabajo.
5. Realice los cambios y seleccione Guardar.

Sincronizar agentes desde fuentes de API

Para automatizar el registro del agente y mantener el inventario actualizado, puede integrar los siguientes orígenes ascendentes con el centro de API:

• Azure API Management: si administra agentes de A2A en Azure API Management, puede habilitar la sincronización automática para mantener actualizado el centro de API. Para más información, consulte Sincronizar las API de una instancia de Azure API Management.

• Repositorio de Git: para los agentes de A2A y otros recursos de IA almacenados en un repositorio de Git, puede habilitar la sincronización automática para mantener actualizado el centro de API. Para más información, consulte Synchronize API assets from a Git repo (Sincronizar recursos de API desde un repositorio de Git).

Detección de agentes en el portal del Centro de API

Configure el portal del Centro de API para que los desarrolladores y otras partes interesadas de la organización puedan detectar agentes en el inventario de API. En el portal del Centro de API, los usuarios pueden:

• Examine y filtre los agentes en el inventario.
• Vea información detallada sobre cada agente.

Evaluación de recursos de IA

El Centro de API puede evaluar la calidad de los recursos de inteligencia artificial, como aptitudes y agentes registrados en el centro de API. API Center incluye de forma predeterminada criterios de evaluación para evaluar activos en distintas dimensiones predefinidas. Los administradores de plataforma empresarial pueden ampliar aún más estos valores predeterminados mediante la definición de criterios de evaluación personalizados adaptados a los estándares específicos, los requisitos de cumplimiento y las directivas de gobernanza de su organización.

Para habilitar las evaluaciones automatizadas de los recursos de inteligencia artificial en el inventario:

1. En Azure Portal, vaya al Centro de API.

2. En el menú de la barra lateral. vaya a Gobernanza>Evaluación de IA.

3. Seleccione la pestaña Aptitudes para configurar las evaluaciones de aptitudes o seleccione la pestaña Agentes para configurar las evaluaciones de los agentes.

4. En Estado de evaluación, seleccione Habilitado.

5. Escriba una descripción para la evaluación.

6. En Criterios de evaluación, realice una de las siguientes acciones:

   • Acepte los criterios predeterminados proporcionados por el Centro de API. Opcionalmente, quite los criterios predeterminados que no sean pertinentes para su organización.

   En la captura de pantalla siguiente se muestran los criterios predeterminados para las aptitudes:

   

   • Agregue uno o varios criterios personalizados.
     1. Seleccione + Agregar criterios.
     2. Escriba un nombre y una instrucción de evaluación opcional para el criterio.
     3. Escriba Puntuación mínima y Valores de puntuación máxima para la puntuación (por ejemplo, 1 y 5).
     4. Escriba un valor de umbral de paso (por ejemplo, 3) que indique la puntuación mínima aceptable para el criterio.
     5. Escriba un valor Weight que indique la contribución del criterio a la evaluación total (por ejemplo, un peso de 0,3 múltiplo de la puntuación en 0,3, contribuyendo 30% a la evaluación total).
     6. Repita los pasos anteriores para agregar más criterios según sea necesario.

7. Haga clic en Guardar.

A continuación, puede ver los resultados de la evaluación en el portal del Centro de API. Por ejemplo, vea los resultados de la evaluación de cada aptitud en la página de detalles de la aptitud.

Contenido relacionado

• Sincronización de recursos de API desde un repositorio de Git
• Registro y detección de servidores MCP en el inventario de API
• Configuración del portal del Centro de API
• Conceptos clave en el Centro de API de Azure