Saltar al contenido principal
PATCH
Editar un caso

Autorizaciones

Authorization
string
header
requerido

Envía Authorization: Bearer YOUR_API_KEY. La clave corresponde a una sola organización.

Parámetros de ruta

id
string<uuid>
requerido

Id del benchmark.

caseId
string<uuid>
requerido

Id del caso.

Cuerpo

application/json
title
string
Required string length: 1 - 160
tags
string[]

Etiquetas de usuario (máximo 20); se normalizan a minúsculas con guiones.

Maximum array length: 20
Maximum string length: 200
checkGroupId
string<uuid> | null
language
string | null
Required string length: 2 - 16
agentVersionId
string<uuid> | null

La versión del agente con cuyo prompt y herramientas se escribió el caso. Nulo = prompt tal como se grabó.

agentId
string<uuid>

El agente del benchmark para el que se escribió el caso (se muestra en el caso). Predeterminado: el agente de agentVersionId.

draft
boolean

Los casos en borrador se guardan pero no se ejecutan hasta confirmarlos.

turns
object[]

turno: la conversación hasta ahora, terminando con el turno del llamante que responde el agente.

Maximum array length: 200
variables
object
expected
string | null

turno: el resultado esperado.

Maximum string length: 20000
replyExpectation
object

Cómo se comprueba la respuesta hablada de un caso de turno.

toolExpectation
object

Qué llamada(s) a herramientas espera un caso de turno.

tools
object[]
Maximum array length: 50
toolMocks
object[]
Maximum array length: 50
conversation
object

conversación: el llamante simulado.

referenceTranscript
string | null

audio: la referencia.

Maximum string length: 20000
keyTerms
string[]
Maximum array length: 50
Required string length: 1 - 200
referenceVerified
boolean

audio: true marca la transcripción de referencia como revisada por una persona; false la marca como sin verificar (se ejecuta igual).

skippedJudgeIds
string<uuid>[]
Maximum array length: 100
judgeParamOverrides
object

Respuesta

Respuesta correcta.

Un caso con su contenido (transcripción, expectativas, herramientas). Leerlo queda registrado en la auditoría.

id
string
requerido
revision
integer
requerido
type
enum<string>
requerido
Opciones disponibles:
turn,
conversation,
audio
title
string
requerido
checkGroupId
string | null
requerido
source
enum<string>
requerido
Opciones disponibles:
production,
trace,
manual,
red_team,
api,
mcp,
upload
sourceConversationId
string | null
requerido
sourceAgent
object | null
requerido

Un agente al que está asignado el benchmark.

tags
string[]
requerido
language
string | null
requerido
retired
boolean
requerido
draft
boolean
requerido
preview
string
requerido
sourceAgentVersionLabel
string

La versión del prompt del agente con la que se escribió el caso, por ejemplo "v7".

referenceUnverified
boolean

audio: la transcripción de referencia viene de la llamada y nadie la revisó todavía. El caso se ejecuta igual.

unpublished
boolean
skippedJudgeIds
string[]
judgeParamOverrides
object
addedInVersion
integer | null
retiredInVersion
integer | null
toolExpectation
object

Qué llamada(s) a herramientas espera un caso de turno.

replyExpectation
object

Cómo se comprueba la respuesta hablada de un caso de turno.

traceSource
object
status
enum<string>
Opciones disponibles:
ready,
draft,
preparing,
failed
contentPurged
boolean
contentDeleted
boolean

"Eliminar todo el contenido de llamadas" vació este caso: el contenido y el razonamiento de los Judges ya no están, el título es un neutro "Caso N · contenido eliminado" y las puntuaciones se conservan.

createdAt
string

Marca de tiempo ISO 8601.

updatedAt
string

Marca de tiempo ISO 8601.

context
object
persona
object
tools
object[]
toolMocks
object[]
keyTerms
string[]
referenceTranscript
string | null
variables
object
promptAgentVersionId
string | null