Pruebas y Depuración de Agentes en Copilot Studio

La validación rigurosa es crítica antes de desplegar cualquier agente de Copilot Studio. Esta lección cubre las herramientas de prueba y depuración integradas, esenciales para asegurar que el agente opere según lo diseñado y maneje escenarios inesperados, minimizando errores en producción.

El panel de prueba en Copilot Studio

El panel de prueba es el entorno principal para interactuar con el agente durante el desarrollo. Permite simular conversaciones de usuario final y observar cómo el agente interpreta las entradas y ejecuta los temas. Es fundamental para verificar la lógica de los temas, las condiciones de bifurcación y las respuestas generadas.

• Acceso: Se encuentra en la esquina inferior izquierda de la interfaz de diseño de Copilot Studio. Se activa con un clic en el icono de chat.
• Resetear la conversación: Es una buena práctica reiniciar la conversación entre pruebas de diferentes escenarios para asegurar que el estado del agente no arrastre información de pruebas anteriores.
• Modo de seguimiento: Activar el modo de seguimiento (Track topic) es clave. Muestra visualmente la ruta que el agente toma a través de los temas, resaltando los nodos activos y las transiciones. Esto es indispensable para entender por qué el agente se desvía o no activa un tema esperado.

Uso del modo de seguimiento para depuración

El modo de seguimiento proporciona una vista detallada del flujo de ejecución del agente. Cuando se activa, cada mensaje enviado en el panel de prueba se registra y se visualiza en el lienzo de diseño. Esto permite identificar rápidamente dónde la conversación se desvía de lo esperado o dónde un tema no se activa correctamente.

1. Identificación de temas: Observar qué temas son identificados por el agente. Si un tema incorrecto se activa, es necesario revisar las frases desencadenadoras (trigger phrases) del tema deseado y del tema activado.
2. Evaluación de condiciones: El modo de seguimiento muestra si las condiciones dentro de los nodos (por ejemplo, condiciones de bifurcación) se evalúan como verdaderas o falsas. Esto es crucial para depurar la lógica condicional.
3. Valores de variables: Permite inspeccionar los valores de las variables en cada punto del flujo. Si una variable tiene un valor inesperado, se puede rastrear su origen, ya sea por una entrada de usuario, una acción o una conexión a datos externos.
4. Errores de acción: Si una acción (como una llamada a Power Automate) falla, el modo de seguimiento a menudo mostrará el error y el punto exacto donde ocurrió, facilitando la depuración de la integración.

Prueba de integraciones y conectores

Cuando el agente interactúa con sistemas externos a través de conectores o flujos de Power Automate, la depuración se extiende a esos componentes. Copilot Studio proporciona información sobre el éxito o fracaso de estas llamadas.

• Flujos de Power Automate: Al depurar un flujo de Power Automate llamado desde Copilot Studio, utiliza el historial de ejecuciones de Power Automate. Este historial muestra los detalles de cada paso del flujo, incluyendo entradas, salidas y errores específicos. Asegúrate de que los datos pasados desde Copilot Studio sean correctos y que el flujo devuelva los datos esperados en el formato correcto.
• Conectores personalizados: Para conectores personalizados, verifica la configuración de la API y los esquemas de entrada/salida. Un error común es una falta de coincidencia entre el esquema definido en el conector y la respuesta real de la API externa.
• Autenticación: Confirma que las credenciales y los métodos de autenticación configurados para los conectores son válidos y tienen los permisos necesarios para acceder a los recursos externos.

Manejo de errores y fallbacks

Un agente robusto debe manejar elegantemente las situaciones en las que no puede entender la intención del usuario o no puede completar una tarea. Los temas de fallback (reserva) son esenciales para esto.

• Tema de sistema 'Escalate': Este tema se activa cuando el agente no puede resolver la consulta del usuario después de varios intentos o cuando el usuario explícitamente solicita hablar con un agente humano. Pruébalo para asegurar que la transferencia se realiza correctamente.
• Tema de sistema 'Topic': Este tema se activa cuando el agente no puede identificar la intención del usuario. Personaliza este tema para proporcionar opciones útiles al usuario, como redirigir a un menú principal o solicitar que reformule su pregunta.
• Mensajes de error personalizados: En lugar de usar mensajes de error genéricos del sistema, configura respuestas personalizadas para errores específicos en acciones o integraciones. Esto mejora la experiencia del usuario y proporciona contexto para la resolución de problemas.

Recomendaciones para un ciclo de prueba efectivo

Adoptar un enfoque estructurado para las pruebas es crucial para la calidad del agente. No se trata solo de verificar la funcionalidad, sino también de asegurar la usabilidad y la resiliencia.

• Casos de prueba: Desarrolla un conjunto de casos de prueba que cubran los escenarios principales, los caminos alternativos, los errores esperados y las entradas fuera de alcance. Documenta los resultados esperados para cada caso.
• Pruebas de regresión: Cada vez que se realiza un cambio significativo en el agente, ejecuta un conjunto de pruebas de regresión para asegurar que las funcionalidades existentes no se hayan visto afectadas.
• Pruebas de usuario: Involucra a usuarios finales o a personal no técnico en las pruebas. Su perspectiva puede revelar problemas de usabilidad o interpretaciones inesperadas del agente.
• Iteración constante: La depuración y las pruebas son un proceso iterativo. Realiza pequeñas pruebas después de cada cambio significativo y no esperes hasta el final del desarrollo para probar todo.

Aplicación práctica: qué hacer el lunes

Al iniciar el desarrollo de un nuevo tema o la modificación de uno existente en Copilot Studio, sigue estos pasos:

1. Paso 1: Activa el panel de prueba y el modo de seguimiento (Track topic) desde el inicio.
2. Paso 2: Prueba el camino feliz del tema, asegurando que todas las ramas y acciones se ejecutan como se espera. Observa el flujo en el lienzo y los valores de las variables.
3. Paso 3: Introduce entradas ambiguas o incorrectas para verificar cómo el agente maneja las desviaciones y si el fallback topic se activa correctamente.
4. Paso 4: Si el tema interactúa con Power Automate o conectores, verifica el historial de ejecución de Power Automate para depurar cualquier error en la integración.
5. Paso 5: Documenta los problemas encontrados y los pasos para reproducirlos. Resuelve los errores y repite las pruebas hasta que el comportamiento sea el deseado.