Cómo relacionar una respuesta del agente con la ejecución que la produjo

No confundas mensaje, tarea e intento

Una solicitud puede producir varios intentos y uno solo llegar al usuario. Define identificadores distintos para la tarea lógica, cada ejecución y la respuesta publicada. Si la interfaz permite regenerar, conserva qué versión reemplaza a cuál. El vínculo debe crearlo la aplicación al emitir la salida, no pedir al modelo que invente un número dentro de su texto.

Conserva una relación consultable

Guarda canal, identificador del mensaje, ejecución e intento seleccionado. Añade la versión del flujo y referencias a fuentes o herramientas utilizadas. No hace falta mostrar identificadores técnicos largos al cliente: puedes ofrecer una referencia de soporte que resuelva a esa relación dentro de un acceso controlado. Los identificadores de proveedor complementan el vínculo, pero no sustituyen el de tu propia aplicación.

Resuelve los casos que rompen la cadena

Prueba una respuesta en streaming que se interrumpe, una edición humana antes del envío y un reintento que termina después que el primero. Registra si el usuario recibió una salida parcial, completa o corregida. Para el borrador editado, diferencia texto generado de versión enviada, conservando solo el detalle autorizado. Sin esa distinción, soporte podría atribuir al modelo una frase que añadió una persona.

Haz una comprobación desde la pantalla del usuario

Elige una salida de ensayo y pide a soporte localizar su ejecución usando la referencia disponible. Después recorre el camino inverso y comprueba qué salida se entregó realmente. Si aparecen dos candidatas, el diseño sigue siendo ambiguo. El tracing del SDK ofrece una estructura técnica para eventos, pero unirla al mensaje de tu canal exige trabajo de integración. Comprueba permisos: conocer una referencia no debe conceder acceso al contenido del expediente.

Prueba además una entrega fallida al canal: una salida generada que nunca se publica debe permanecer como intento no entregado. Si el canal confirma recepción de forma asíncrona, conserva ese evento separado de la finalización del modelo para no confundir ambos estados.

Fuentes y documentación

• OpenAI Agents SDK — Tracing — El SDK diferencia trazas y spans y permite controlar contenido sensible; verifica tu versión y exportadores.
• OWASP — Logging Cheat Sheet — Referencia para exclusión de secretos y correlación de eventos.