llm_request_completed — Esquema de evento

Ruta de evidencia del contrato

llm_request_completed: del límite propio a la consulta confiable

Trate a llm_request_completed como un contrato analítico duradero: el propietario emite un grano documentado, un dispositivo prueba los campos y una consulta revisada responde a la pregunta formulada.

1
El resultado se vuelve definitivo
Shared model gateway or provider adapter emits only after token usage, outcome, and provider response are final.
2
El contrato está limitado.
9 required fields preserve the declared grain: One completed model-provider request.
3
El accesorio está verificado
Tipos de verificación, hora UTC, resultados alternativos, idempotencia y todos los campos seudónimos o clasificados por revisión.
4
La pregunta esta respondida
¿Cuánto cuesta cada flujo de trabajo de IA exitoso y qué tan bien funciona?

grano

Una solicitud de proveedor de modelo completa.

propietario

Adaptador de proveedor o puerta de enlace de modelo compartido

Emitir cuando

Después del uso del token, el resultado y la respuesta del proveedor son 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.
feature	string	yes	non-sensitive	Característica de producto estable o flujo de trabajo utilizando el modelo.
model	string	yes	non-sensitive	Identificador del modelo de proveedor.
input_tokens	number	yes	non-sensitive	Tokens de entrada informados por el proveedor.
output_tokens	number	yes	non-sensitive	Tokens de salida informados por el proveedor.
estimated_cost_usd	number	no	non-sensitive	Costo de asignación estimado, conciliado por separado.
status	string	yes	non-sensitive	Proveedor final o resultado del flujo de trabajo.

Evento JSON sintético

{
  "timestamp_utc": "2026-07-28T14:18:44Z",
  "event_id": "evt_llm_01",
  "account_id": "acct_8f31",
  "release": "2026.07.2",
  "feature": "query_explanation",
  "model": "model_family_a",
  "input_tokens": 820,
  "output_tokens": 244,
  "estimated_cost_usd": 0.0124,
  "status": "success"
}

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: pseudonymous

Lista de verificación de validación

Pruebe el contrato antes de crear un panel

Send one known llm_request_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 llm_request_completed before shared model gateway or provider adapter 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