Qué información necesita soporte para investigar un fallo de agente

Empieza por el estado que importa

Indica proceso, entorno, hora con zona horaria e identificador del caso. Describe qué esperabas y qué observaste: respuesta ausente, dato equivocado o cambio sin confirmar. Añade cuántos casos conoces afectados y si el servicio sigue activo. No conviertas una estimación de alcance en un número confirmado; marca lo pendiente de comprobar.

Relaciona versiones y última etapa conocida

Incluye versión del flujo, instrucciones, modelo configurado y conector, cuando estén disponibles. Anota el último paso confirmado y el identificador técnico de petición que devuelve el proveedor si existe. Diferencia el mensaje mostrado a la persona del error de la integración. Una captura de pantalla ayuda a reconocer el síntoma, pero no sustituye una referencia que soporte pueda buscar con sus permisos.

Da una reproducción segura

Prepara una entrada sintética que conserve formato, longitud relevante y condición desencadenante. Enumera pasos y resultado observado. Si no se reproduce, dilo y conserva la evidencia original en un lugar autorizado; no inventes una secuencia que parezca concluyente. Antes de repetir una petición que modifica datos, comprueba el destino o usa un entorno sin efectos. Una investigación no debe crear otro pedido por intentar reproducir el primero.

Cierra el envío con decisiones pendientes

Señala si hubo aprobación humana, reintentos y posible escritura parcial. Identifica quién puede decidir una pausa y quién valida la reparación operativa. Comparte referencias protegidas en vez de tokens o archivos enteros. Acuerda el canal para aportar evidencia adicional y quién retira las capturas temporales. Soporte debe devolver una hipótesis comprobable y el siguiente ensayo; recibir el ticket no significa haber resuelto la operación.

Añade una secuencia breve de cambios recientes: despliegue, renovación de credencial o modificación de fuente. Trátalos como pistas, no como causas confirmadas. Soporte debe poder descartar cada pista con una comprobación y conservar las que todavía no ha contrastado.

Fuentes y documentación

• OWASP — Logging Cheat Sheet — Referencia para exclusión de secretos y correlación de eventos.
• OpenAI — Function calling — El modelo propone llamadas; la aplicación ejecuta el código de las herramientas.