Saltar al contenido principal
POST
Consultar al copiloto de una auditoría

Autorizaciones

X-API-Key
string
header
requerido

Su clave de API en el header X-API-Key.

Encabezados

X-Audit-Id
string | null

Id de la auditoría que el cliente cree estar leyendo, opcional. Si no coincide con el audit_id de la ruta, la respuesta es 400 audit_id_mismatch y no se lee nada.

X-Case-Id
string | null

Caso activo, opcional: el token de un caso que usted puede ver. La consulta queda registrada en ese caso y usa también sus etiquetas propias. Un caso que no existe, se borró o ya no está compartido con usted responde 400 case_unavailable y la consulta no se hace, sin cobro.

Parámetros de ruta

audit_id
string
requerido

Id de la auditoría: minúsculas, dígitos, _ y -, de 1 a 64 caracteres, como los que lista GET /v1/audit.

Cuerpo

application/json
message
string
requerido

La pregunta del usuario.

Required string length: 1 - 4000
history
History · object[]

Turnos previos {role: user|assistant, content} de esta conversación (se usan los últimos 12).

Maximum array length: 40
context
Context · object | null

La pantalla: {section, selection: {kind: finding|lead|proof, id}}. Se valida contra la auditoría: lo que no existe en ella se ignora.

Respuesta

Stream SSE (text/event-stream) con los eventos start, token, tool, tool_result, notice, error y done.