Inspecciona un agente local con el Agent Inspector

Importante

Los elementos marcados (versión preliminar) de este artículo se encuentran actualmente en versión preliminar pública. Esta versión preliminar se ofrece sin acuerdo de nivel de servicio y no se recomienda para las cargas de trabajo de producción. Es posible que algunas características no se admitan o que tengan funcionalidades restringidas. Para más información, consulte Términos de uso complementarios para las versiones preliminares de Microsoft Azure.

El Inspector de agentes es una interfaz de usuario basada en navegador para inspeccionar un agente de Microsoft Foundry que se ejecuta en tu equipo local. Se conecta al punto de conexión HTTP/SSE del agente local, muestra las solicitudes y respuestas, y te permite reproducir mensajes mientras trabajas con indicaciones, herramientas y código.

Prerequisites

• Un proyecto de agente alojado inicializado. Para crear uno, consulte Inicialización de un proyecto de agente.
• Las extensiones de Foundry para azd se han instalado. Para conocer los pasos de instalación, consulte Instalación de las extensiones azd Foundry.
• Una sesión de la CLI de desarrollador Azure autenticada. Ejecute azd auth login si es necesario.
• Un agente local para inspeccionar. Para iniciar uno, consulte Ejecución de un agente hospedado localmente con la CLI para desarrolladores de Azure.

El inspector se distribuye como extensión independiente (azure.ai.inspector) y el metapaquete microsoft.foundry lo instala automáticamente. También se incluye como dependencia de azure.ai.agents, por lo que basta con instalar la extensión del agente.

Nota:

Por defecto, el inspector solo se dirige a un agente local en http://localhost:8088. No se autentica ni actúa como proxy para un agente de Foundry implementado. Para el agente implementado, use azd ai agent invoke y azd ai agent monitor.

Iniciar el agente localmente

1. Inicie el agente en un terminal:

   azd ai agent run
   

   Por defecto, azd ai agent run abre el inspector automáticamente cuando el servidor local comienza a escuchar.

2. Para omitir el inicio automático, pase --no-inspector:

   azd ai agent run --no-inspector
   

Abrir el inspector manualmente

Si has iniciado el agente tú mismo, por ejemplo con python app.py o dotnet run, o si has cerrado la pestaña del inspector y quieres volver a abrirla, inicia el inspector manualmente.

1. Ejecute el comando launch:

   azd ai inspector launch
   

   La interfaz de usuario está disponible en http://localhost:8087 de forma predeterminada y se conecta a un agente en http://localhost:8088.

2. Configure ambos puertos si es necesario:

   # Agent on port 9000, UI on port 9001.
   azd ai inspector launch --port 9000 --inspector-port 9001
   

3. Para cargar en el inspector una conversación existente o un ID de sesión con el fin de reproducir una ejecución específica, pasa los ID de forma explícita:

   azd ai inspector launch \
     --conversation-id conv_abc123 \
     --session-id sess_xyz789
   

Inspección del tráfico local

Cuando el inspector está abierto, la aplicación de una sola página transmite las respuestas del agente mediante SSE y también las refleja en tu terminal. Ustedes pueden:

• Revisa el contenido completo de las solicitudes y respuestas de cada turno.
• Para continuar una conversación existente, reutilice el ID de la conversación en los distintos turnos.
• Vuelva a una sesión nueva en cualquier momento.

El inspector no modifica el código del agente ni azure.yaml. Es puramente una vista en tiempo de ejecución.

Contenido relacionado

• Ejecute un agente hospedado localmente con la CLI de Azure Developer para iniciar el agente local.
• Invoque un agente hospedado con la CLI del desarrollador de Azure para la invocación local e implementada basada en terminal.
• Aísla las sesiones del agente hospedado por usuario para comprobar el aislamiento frente a un agente desplegado.