Utiliza el trazado de actividad para depurar tu agente

El rastreo de actividad en los agentes impulsado por el harness de GitHub Copilot en Microsoft Copilot Studio te muestra exactamente cómo procesa tu agente cada mensaje. Úselo para comprender el razonamiento de cadena de pensamiento de su agente, verificar la atribución de la fuente de conocimientos, confirmar la ejecución de las herramientas y solucionar errores.

Note

Las características de este artículo están impulsadas por el arnés GitHub Copilot, que utiliza Copilot Credits para la facturación basada en el uso. Descubre más sobre los créditos de Copilot en Resumen de facturación para agentes impulsados por el arnés GitHub Copilot.

La facturación basada en el uso se aplica al uso, construcción, prueba y evaluación de agentes. Estas acciones pueden consumir Créditos de Copilot.

Prerequisites

  • Un agente creado con el arnés GitHub Copilot
  • Al menos una conversación de prueba en la pestaña Versión preliminar

Abrir la traza de actividad

  1. Abra su agente en Copilot Studio y seleccione la pestaña Vista previa.

  2. Asegúrese de que el control Versión preliminar para el usuario final esté desactivado (la vista de creador predeterminada). El seguimiento de actividad aparece junto al panel del chat, mostrando los detalles de procesamiento de cada mensaje.

  3. Envíe un mensaje al agente. El seguimiento se actualiza en tiempo real a medida que el agente procesa el mensaje.

Descripción del seguimiento

El seguimiento de actividad muestra una vista de cadena de pensamiento (CoT) del procesamiento de su agente. Cada paso en el seguimiento aparece como un nodo que muestra lo que hizo el agente y por qué.

Tipos de nodo

El seguimiento puede incluir los siguientes tipos de nodos:

Tipo de nodo Lo que muestra
Mensaje de usuario El mensaje que envió al agente
Respuesta del agente La respuesta generada por el agente
Información Una fuente de conocimientos que el agente consultó para fundamentar su respuesta. Se presenta en forma de tarjeta plegable titulada "Conocimiento buscado", en la que se muestran las fuentes de cada dato consultado, así como los vínculos a las citas bibliográficas, cuando estén disponibles.
Acción ejecutada Una invocación de conector o herramienta que se muestra como una ficha plegable en la que se visualizan el conector, los parámetros de entrada rellenados y la duración de la entrega
Tool Una herramienta que el agente invoca para realizar una acción o recuperar datos
Connector Un conector que el agente utiliza para obtener acceso a datos externos
Flujo Un flujo de agentes que se activó
Aptitud Una habilidad que se ejecutó
Error Un error que ha ocurrido durante el procesamiento
Complete Se muestra una marca de verificación verde en la parte inferior del seguimiento cuando todas las llamadas a las herramientas han finalizado

Visualización de los detalles del nodo

  1. Seleccione cualquier nodo de la traza para expandir sus detalles.

  2. Consulte la información mostrada, que puede incluir:

    • La entrada que el agente envió al paso
    • La salida o resultado devuelto
    • Tiempo de procesamiento y métricas
    • Detalles del error si se produjo un error en el paso

Depurar problemas con las fuentes de conocimientos

Cuando su agente utiliza conocimiento para responder a una pregunta, el seguimiento muestra qué fuentes se consultaron:

  1. Busque el nodo Knowledge en la traza.

  2. Revise el origen para ver qué fuentes de conocimientos se consultaron.

  3. Seleccione una fuente para ver el contenido específico recuperado.

  4. Verifique que el agente haya utilizado el origen correcto y que el contenido recuperado sea relevante.

Si el agente utilizó el origen incorrecto o devolvió información inexacta, revise su configuración de conocimiento en la pestaña Crear.

Depuración de la ejecución de herramientas

Cuando su agente invoca una herramienta, el seguimiento muestra los detalles de la ejecución:

  1. Encuentre el nodo Herramienta, el nodo Conector, el nodo Flujo o el nodo Habilidad en la traza.

  2. Revise los detalles de la ejecución, incluidos los parámetros de entrada y los resultados de salida.

  3. Verifique que se haya invocado la herramienta correcta y que los resultados sean los esperados.

  4. Si una ejecución de herramienta falló, revise los detalles del error en el nodo.

Para reconfigurar una herramienta, abra la pestaña Crear y localice la herramienta en la configuración de su agente.

Solución de errores

Cuando se producen errores durante el procesamiento, la traza los destaca:

  1. Busque nodos marcados con un indicador de error en la traza.

  2. Seleccione el nodo de error para ver los detalles del error, incluido el mensaje de error y el contexto.

  3. Algunos problemas comunes son:

    • Fallos de autenticación para herramientas o conectores
    • Errores de acceso a la fuente de conocimientos
    • Errores de tiempo de espera en llamadas a herramientas de larga duración
    • Indicadores de moderación de contenido

  4. Aborde la causa raíz en la pestaña Crear o en Configuración y luego vuelva a probar.

El seguimiento de actividad se integra con la pestaña Crear para una edición rápida.

  1. Seleccione cualquier origen, herramienta o componente de la traza.

  2. Copilot Studio navega hasta el componente correspondiente en la pestaña Crear.

  3. Haga los cambios y vuelva a la pestaña Versión preliminar para volver a probar.

  • Last updated on