Administrar agentes a escala en Microsoft Foundry Control Plane

Microsoft Foundry Control Plane proporciona administración centralizada y observabilidad para los agentes que se ejecutan en plataformas e infraestructuras compatibles. Con Foundry Control Plane, puede administrar agentes que se distribuyen entre varios proyectos dentro de una suscripción.

En este artículo se explica cómo ver el inventario del agente, supervisar el estado del agente y realizar operaciones de ciclo de vida mediante el portal de Foundry.

Requisitos previos

• Una cuenta de Azure con una suscripción activa. Si no tiene una, cree una cuenta de free Azure, que incluye una suscripción de evaluación gratuita.

• Un proyecto de fundición. Si no tiene uno, cree un proyecto.

• Application Insights configurado para métricas de observabilidad (opcional, pero recomendado).

Inventario del agente

El panel Recursos proporciona una tabla unificada y buscable de todos los activos de IA en los proyectos de una suscripción. Este inventario reúne los metadatos críticos y los indicadores de estado, por lo que puede evaluar y actuar sobre el patrimonio de inteligencia artificial de forma eficaz.

El plano de control de Foundry detecta automáticamente los agentes admitidos en los recursos de la suscripción seleccionada y los muestra en la pestaña Agentes. Para verlos, seleccione Operar>Activos>Agentes.

Aparece la siguiente información:

Modelo de permisos

Foundry Control Plane detecta automáticamente los agentes a los que los usuarios pueden acceder. Dado que Foundry Control Plane agrega información a través de los recursos dentro de la suscripción, es posible que distintos usuarios vean diferentes agentes en el panel Activos, en función de su nivel de acceso en cada recurso.

Los siguientes roles afectan lo que usted puede ver y hacer:

Plataformas de agentes compatibles

Foundry Control Plane detecta automáticamente agentes en las siguientes plataformas:

Agentes de fundición

El plano de control de Foundry le ayuda a administrar agentes en todos los proyectos de Foundry. Al crear un agente o un flujo de trabajo dentro de un proyecto de Foundry, el agente aparece en el inventario. El Plano de Control de Foundry enumera todos los agentes de todos los proyectos de una suscripción.

Para cada agente, la información incluye:

• La versión más reciente del agente.
• Versiones publicadas como aplicaciones de agente.

Puede supervisar las versiones consumidas por los usuarios y las nuevas versiones en desarrollo. En el ejemplo siguiente se muestran varios agentes Foundry listados. La versión 6 del format-agent agente se publicó, pero la versión 7 (más reciente) todavía está en desarrollo.

Agente de SRE de Azure

Azure agente de SRE le ayuda a mantener el estado y el rendimiento de los recursos de Azure a través de la supervisión y asistencia con tecnología de inteligencia artificial. Los agentes observan continuamente los recursos para detectar problemas, proporcionan ayuda para solucionar problemas y sugieren pasos de corrección en una interfaz de chat en lenguaje natural. Aprende más sobre el Agente SRE de Azure.

El Plano de Control Foundry descubre los recursos del Agente SRE de Azure en tu suscripción y los muestra en el inventario.

bucle del agente de Azure Logic Apps

Azure Logic Apps admite flujos de trabajo que completan tareas mediante bucles de agente con modelos de lenguaje grandes (LLM). Un bucle de agente usa un proceso iterativo para resolver problemas complejos y de varios pasos. Obtenga más información sobre los flujos de trabajo con agentes y modelos de IA en Logic Apps.

Foundry Control Plane detecta recursos de Logic Apps que contienen flujos de trabajo de bucle de agente y los enumera en el inventario.

Agentes personalizados

En el caso de plataformas agenticas que Foundry Control Plane no admite, puede registrar manualmente agentes en un proyecto de Foundry para habilitar la administración.

El registro de agentes personalizados que se ejecutan en Azure servicios de proceso u otros entornos en la nube puede ayudarle a obtener visibilidad sobre sus operaciones y controlar su comportamiento. Puede registrar un agente personalizado en el plano de control de Foundry y desarrollar el agente en la tecnología que prefiera, tanto para soluciones de plataforma como de infraestructura.

Obtenga información sobre cómo registrar un agente en el plano de control de Foundry para habilitar la administración.

Observabilidad de agentes

El plano de control de Foundry usa los recursos de Application Insights que hospedan los agentes para ayudarle a supervisar y diagnosticar esos agentes. Cuando estos datos están disponibles, Foundry Control Plane puede realizar las siguientes acciones:

• Ejecuciones de proceso y tasas de errores.
• Calcular métricas de uso, incluido el uso de tokens y el costo.
• Recopilar rastros de ejecución.

Si no ve dicha información para el agente, debe configurar Application Insights. Asegúrese de que también tiene los permisos adecuados para ver los datos de Application Insights y las métricas de costos.

Ver trazas

Puede ver seguimientos y registros enviados a Foundry. Las trazas se almacenan en Application Insights y puede consultarlas mediante el portal Foundry o cualquier otra herramienta compatible.

Para verlos:

1. En la barra de herramientas, seleccione Operar.

2. En el panel izquierdo, seleccione Activos.

3. Seleccione el agente.

4. Seleccione la pestaña Seguimientos . En la pestaña se muestra una entrada para cada llamada realizada al agente.

   Dos columnas contienen identificadores asociados a la llamada: ID de seguimiento y ID de conversación. Los seguimientos se almacenan en Application Insights y contienen datos para diagnosticar el comportamiento. La columna Identificador de conversación se aplica a los agentes de Foundry. Contiene la conversación asociada a la traza. Las conversaciones se almacenan en el servicio Foundry.

   

5. Para ver los detalles, seleccione un valor en la columna ID de traza.

   

   Propina

   Los agentes personalizados requieren una configuración adicional para mostrar detalles, incluidas las herramientas y las extensiones de LLM. Obtenga más información en Instrumentar agentes de código personalizados.

Operaciones del ciclo de vida

El plano de control de Foundry ayuda a las organizaciones a controlar los agentes para administrar el uso y el costo de la infraestructura. Diferentes plataformas de agente admiten diferentes operaciones.

En la tabla siguiente se resumen las acciones admitidas para cada plataforma. El soporte de un agente de Foundry depende del tipo de agente y su estado de publicación.

Iniciar y detener agentes

Cuando detienes un agente, detienes la infraestructura asociada a él y mueves el agente al estado Detenido.

Detener un agente desaprovisiona su infraestructura y evita nuevas ejecuciones. Los flujos de trabajo o recursos conectados a este agente no pueden acceder a ellos. Esta operación no finaliza las ejecuciones existentes.

Para detener un agente:

1. En la barra de herramientas, seleccione Operar.

2. En el panel izquierdo, seleccione Activos.

3. Seleccione el agente que desea detener. Aparece el panel de información.

4. Seleccione Estado de actualización y, a continuación, seleccione Detener.

   

5. Confirme la operación.

Después de detener el agente, el valor estado del agente en Foundry se detiene.

Para iniciar el agente:

1. Seleccione Estado de actualización y, a continuación, seleccione Iniciar.

2. Confirme la operación.

Bloquear y desbloquear agentes

En el caso de los agentes personalizados, Foundry no tiene acceso a la infraestructura subyacente donde se ejecuta el agente, por lo que las operaciones de inicio y detención no están disponibles. Sin embargo, Foundry puede bloquear las solicitudes entrantes al agente. El bloqueo impide que los clientes usen el agente. Esta funcionalidad permite a los administradores deshabilitar un agente si se comporta mal.

Para bloquear las solicitudes entrantes al agente:

1. En la barra de herramientas, seleccione Operar.

2. En el panel izquierdo, seleccione Activos.

3. Seleccione el agente que desea bloquear. Aparece el panel de información.

4. Seleccione Estado de actualización y, a continuación, seleccione Bloquear.

   

5. Confirme la operación.

Después de bloquear el agente, el valor estado del agente en Foundry está bloqueado. Los agentes en el estado Bloqueado se ejecutan en su infraestructura asociada, pero no pueden aceptar solicitudes entrantes. Foundry bloquea cualquier intento de comunicarse con el agente.

Para desbloquear el agente:

1. Seleccione Estado de actualización y, a continuación, seleccione Desbloquear.

2. Confirme la operación.

Gestionar estados desconocidos

En determinadas circunstancias, los agentes pueden mostrar el estado Desconocido. Este estado indica que el Foundry Control Plane no puede determinar el estado del agente porque la plataforma de origen no está disponible o el agente no pudo informar de vuelta.

Para solucionar problemas de un estado desconocido :

1. Compruebe que la plataforma de origen (por ejemplo, Azure Logic Apps o Azure agente SRE) esté operativa.
2. En el caso de los agentes personalizados, confirme que la infraestructura del agente está en funcionamiento y es accesible.
3. Compruebe los registros de Application Insights del agente en busca de rastros de errores.
4. Si el estado no se resuelve, intente detener y reiniciar el agente.

Solución de problemas

Los datos de observabilidad no son visibles

Si las métricas como la tasa de errores, el uso de tokens o el costo no aparecen para un agente:

1. Compruebe que Application Insights está configurado para el recurso que hospeda el agente.
2. Confirme que tiene los permisos necesarios para ver los datos de Application Insights y las métricas de costos.
3. Ejecute el agente después de configurar Application Insights. Las métricas y los seguimientos solo se recopilan para las ejecuciones que se producen después de la configuración. Las ejecuciones anteriores no se capturan de forma retroactiva.
4. Espere hasta 15 minutos para que los datos se propaguen después de la primera ejecución posterior a la configuración.

El agente no aparece en el inventario

Si un agente esperado no aparece en el panel Activos :

1. Confirme que el agente está en una plataforma compatible.
2. Compruebe que tiene permisos de RBAC en el recurso que hospeda el agente.
3. Compruebe que el agente está dentro de la suscripción seleccionada actualmente.
4. En el caso de los agentes personalizados, compruebe que el agente está registrado en un proyecto Foundry.

Contenido relacionado

• ¿Qué es el Plano de Control de Microsoft Foundry?
• Monitorea la salud y el rendimiento de los agentes en toda tu flota
• Registrar un agente personalizado en el Foundry Control Plane