Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
[Este artículo es documentación preliminar y está sujeto a modificaciones].
Un agente que parece correcto en la pestaña Build aún puede fallar en una conversación. Las instrucciones son guía, no garantías: el modelo las interpreta, y la diferencia entre lo que escribiste y lo que hace el agente solo aparece cuando realmente hablas con él. Utiliza la pestaña Vista previa para probar a tu agente tanto en el chat web como en la voz antes de publicarlo.
Canales de prueba
La pestaña Vista previa ofrece dos formas de probar tu agente:
- Chat en web: Un panel de chat basado en texto. Aquí es donde deberías pasar la mayor parte del tiempo dedicado a las pruebas. Es más rápido que la voz, la transcripción completa es visible y obtienes un rastreo de razonamiento junto al chat.
- Llamada de voz: Una conversación de voz en directo con tu agente. La voz tiene modos de fallo que el texto nunca revela, así que pruébala por separado incluso cuando el chat pase limpio.
Selecciona Chat en web o Llamada de voz en la parte superior de la pestaña de Vista previa para cambiar entre canales de prueba. Un panel de transcripción en directo aparece junto a la conversación.
Antes de comenzar
- Guardar los cambios. El panel de Vista previa ejecuta tu agente guardado, no las ediciones no guardadas en la pestaña Build.
- Sepa qué aspecto tiene lo «correcto». Apunta el resultado esperado antes de enviar el primer mensaje.
- Abre el mapa de actividad. Se coloca junto al chat y muestra el enrutamiento, las llamadas a herramientas y la ejecución de tópicos. Es la forma de distinguir un fallo de razonamiento de uno de fontanería.
- Inicia una nueva sesión de prueba entre escenarios. El contexto se arrastra y contaminará tu próximo resultado.
Las cinco capas a probar
Trabaja hacia afuera desde la capa más simple. Un fallo en una capa temprana se producirá en cascada, así que soluciona los problemas en orden.
| Nivel | Lo que estás probando | Cómo saber que funciona |
|---|---|---|
| Introducción y alcance | El agente se presenta y entiende su propio trabajo | El mensaje de apertura coincide con tu descripción; acepta solicitudes dentro del alcance |
| Routing | El orquestador elige al subagente adecuado | El mapa de actividad muestra el especialista invocado esperado |
| Herramientas y temas | Las acciones realmente se ejecutan y devuelven datos | Los valores reales vuelven, no los marcadores de posición ni el silencio |
| Conocimientos | Las respuestas se basan en tus fuentes | Las citas aparecen y coinciden con tus fuentes configuradas |
| Barreras de protección | Rechazos, escalado y retención por reglas de negocio | El agente rechaza, escala o señala exactamente como se le indica |
Pruebas en chat web
Ejecuta primero el flujo principal
Juega como un usuario realista con un objetivo definido de principio a fin, no como un tester que está explorando características. Por ejemplo, para un agente de viajes, eso significa reservar un viaje real de principio a fin en lugar de preguntar "¿puedes reservar vuelos?"
- Abre el objetivo de forma natural, como lo haría un usuario real.
- Responde a las preguntas del agente como usuario cooperativo.
- Sigue el flujo hasta una conclusión real: una reserva, un resumen, una resolución.
- Pide un resumen al final y luego verifica cada dato con la transcripción.
Entonces rómpela a propósito
El caso ideal demuestra que el agente puede operar correctamente. Estos escenarios demuestran que falla de manera controlada.
| Test | Qué enviar | ¿Qué debería pasar? |
|---|---|---|
| Detalle faltante | No omitas un campo obligatorio que el agente necesita | Pide exactamente ese campo, una vez |
| Cambio de opinión | Revertir una decisión a mitad de flujo | Se actualiza sin perder el contexto anterior |
| Fuera del alcance | Pregunta algo fuera de su dominio | Rechaza y redirige, sin improvisar |
| Escalación | Activa una regla de traspaso documentada | Se transfiere en lugar de intentar la tarea |
| Regla de negocio | Superar un límite declarado, como el presupuesto | Señala explícitamente el conflicto |
| Memoria de la sesión | Pídele que repita un detalle de antes | Recuerda con precisión, sin volver a preguntar |
Lee el mapa de actividad, no solo la respuesta
El chat te dice lo que dijo el agente. El mapa de actividad te dice qué ha hecho. Cuando una respuesta parece incorrecta, el mapa te indica dónde corregirla:
- Se ha invocado al especialista incorrecto → tus instrucciones de enrutamiento o descripciones de subagentes son ambiguas.
- Especialista adecuado, mala salida → las instrucciones propias del subagente necesitan mejorar.
- La herramienta se ejecutó pero no devolvió nada → la herramienta o el tema está roto, no el prompt.
- Ninguna llamada a la herramienta → el agente respondió desde el modelo en lugar de tus datos. Trata cada valor de esa respuesta como no verificado.
Pruebas de voz
Voice no es chat web con audio adjunto. Tiene modos de fallo que el chat nunca mostrará, así que pruébalo por separado incluso cuando el chat pase limpio.
- Permite el acceso al micrófono, luego inicia la conversación de voz y confirma que el estado llegue a conectado y en escucha.
- Formula una solicitud completa de forma natural en lugar de leer un guion palabra por palabra.
- Mira la transcripción en directo. Si el reconocimiento de voz te entiende mal, la respuesta del agente responde a una pregunta diferente a la que has hecho.
- Interrumpe al agente a mitad de frase para verificar que el barge-in detiene la reproducción y empieza a escuchar.
- Permanece en silencio varios segundos para confirmar que vuelva a repreguntar amablemente en lugar de colgar la llamada.
- Pide un código de confirmación y comprueba que se deletree carácter por carácter, no como una palabra.
Qué hay que escuchar
- Longitud: Cualquier cosa de más de tres frases es demasiado larga para seguirla de oído.
- Listas y URLs: Estas deben resumirse, nunca leerse en voz alta elemento por elemento.
- Fechas y números: "Martes, 24 de marzo" funciona; "2026-03-24" no.
- Confirmación de datos críticos: Nombres, fechas y códigos deben repetirse antes de que el agente actúe sobre ellos.
Si Speech se comporta como tu canal de chat, las instrucciones específicas de tu canal no están cumpliendo su función. Las instrucciones de voz y chat se configuran por separado en cada agente, en la sección Instrucciones, en las pestañas Voz y Chat. Consulta la visión general de la configuración de voz y chat.
Tip
Ejecuta tus escenarios críticos más de una vez y haz al menos una sesión larga. Los fallos intermitentes siguen siendo fallos, y son los que llegan a producción.
Cuando algo falla
- Reprodúcelo. Inicia una nueva sesión y vuelve a ejecutar la misma ruta, anotando si falla cada vez o de forma intermitente.
- Localízalo usando el mapa de actividad: ruta, herramienta, conocimiento o instrucción.
- Arregla una cosa a la vez. Cambiar varias instrucciones a la vez hace imposible saber qué funcionó.
- Guarda, inicia una nueva sesión y repite exactamente el mismo escenario.
- Reejecuta tus otros escenarios correctos. Los cambios en las instrucciones tienen efectos secundarios.
Lista de comprobación para envío
- El flujo ideal se completa de principio a fin sin necesidad de guía.
- Cada dato en el resumen final se puede rastrear hasta algo que una herramienta o fuente de conocimiento realmente devolvió.
- No aparece ningún texto provisional en ninguna respuesta visible para el usuario.
- El agente informa de fallos honestamente cuando una herramienta no devuelve nada.
- Las reglas de escalada y rechazo funcionan de forma fiable.
- Las respuestas de voz son breves y los códigos se deletrean.
- Los escenarios críticos se ejecutaron más de una vez, incluyendo una sesión larga.