Una ejecución completa se convierte en un contrato analítico reutilizable
Emita solo después de que el propietario conozca el resultado del terminal, luego valide el contrato almacenado antes de que un panel o un flujo de trabajo de evaluación dependa de él.
- 1
La ejecución se completa
La aplicación conoce el estado final, las herramientas, la transferencia, la duración, los tokens y el costo.
- 2
Contrato emitido
Envíe campos delimitados e identificadores aprobados sin copiar mensajes ni cargas útiles de herramientas.
- 3
Accesorio verificado
Inspeccione los tipos requeridos, los campos de privacidad, los reintentos y un resultado alternativo conocido.
- 4
Análisis reutilizado
Power revisó la calidad, confiabilidad y economía unitaria de SQL por característica y versión.
grano
Un resultado de terminal por ejecución de agente lógico.
propietario
Orquestador de agentes después de determinar el resultado del producto
Emitir cuando
Después del éxito, el fracaso, la cancelación o el traspaso humano se vuelven definitivos.
Contrato de campo
Campos escritos con límites de privacidad explícitos
Mantenga estables los nombres y tipos de campos existentes después de que las consultas de producción dependan de ellos. El contexto opcional debe permanecer limitado, documentado y justificado por una decisión específica.
| Campo | Tipo | Requerido | Privacidad | Significado |
|---|---|---|---|---|
| timestamp_utc | timestamp | yes | non-sensitive | Hora UTC en el límite del resultado. |
| event_id | string | yes | non-sensitive | Identificador único estable utilizado para la deduplicación. |
| release | string | yes | non-sensitive | Versión de la aplicación o servicio que emitió el evento. |
| account_id | string | yes | pseudonymous | Identificador de cuenta interno estable, nunca un correo electrónico o nombre. |
| run_id | string | yes | pseudonymous | Identificador estable compartido por eventos de nivel de paso aprobados. |
| workflow | string | yes | non-sensitive | Flujo de trabajo del producto versionado manejado por el agente. |
| status | string | yes | non-sensitive | Éxito, fallido, cancelado o human_handoff. |
| tool_call_count | number | yes | non-sensitive | Total de llamadas a herramientas en la ejecución lógica. |
| estimated_cost_usd | number | no | non-sensitive | Asignación de costos de proveedor estimada versionada. |
| task_completed | boolean | yes | non-sensitive | Se revisó la definición de éxito a nivel de producto. |
Evento JSON sintético
{
"timestamp_utc": "2026-07-29T09:29:40Z",
"event_id": "evt_agent_01",
"account_id": "acct_8f31",
"release": "2026.07.3",
"run_id": "run_f28c",
"workflow": "support_resolution_v3",
"status": "success",
"tool_call_count": 3,
"estimated_cost_usd": 0.021,
"task_completed": true
}Revisión de privacidad
Revisar los identificadores antes de la ingestión
Este ejemplo utiliza identificadores sintéticos. Los valores seudónimos aún pueden ser datos personales y los campos de revisión pueden exponer el contexto empresarial o del proveedor. Aplique sus propios requisitos de consentimiento, retención, acceso, residencia y eliminación.
account_id: pseudonymousrun_id: pseudonymous
Lista de verificación de validación
Pruebe el contrato antes de crear un panel
- Send one known ai_agent_run_completed fixture after the documented outcome boundary.
- Verify all 9 required fields arrive with the documented types.
- Vuelva a intentar el mismo identificador de evento y confirme el comportamiento de deduplicación elegido.
- Envíe un error controlado o un resultado alternativo cuando el flujo de trabajo lo admita.
- Ejecute el SQL relacionado en una ventana fija y concilie el resultado con el dispositivo.
Errores comunes
Mantenga una fila igual a un resultado duradero
- Emitting ai_agent_run_completed before agent orchestrator after the product outcome is determined knows the final outcome.
- Mezclar varios granos en una tabla, lo que hace que los recuentos y tasas sean ambiguos.
- Reemplazar categorías controladas con URL sin formato, cargas útiles, mensajes o texto de error.
- De ello depende el cambio de un tipo de campo después de las consultas y los paneles guardados.
- Agregar identificadores sin una necesidad documentada de investigación, acceso y retención.
Usa el contrato
Consultar y operacionalizar el evento.
Contratos relacionados
Enviar un dispositivo antes del tráfico de producción.
Cree una clave API gratuita, envíe el evento sintético e inspeccione la tabla inferida antes de conectar un flujo de trabajo en vivo.