Update test
Update an agent test case
Authorizations
API key for authentication
Path Parameters
Test to update
"b1c2d3e4-f5a6-7890-bcde-f12345678901"
Body
New test name. Omit to leave unchanged
What the test judges:
response: judges the generated replytool_call: diffs the generated tool callsconversation: judges the full conversationgeneral: judges a single plain-text input/output pair with no conversation involved (e.g. summarization, extraction, classification)
Immutable. Omit it, or send the current value
response, tool_call, conversation, general The calibrate test config.
history: the conversation up to the agent's turn, required forresponseandconversationtests and for atool_calltest aimed at a conversational agent. Each item is{role, content}withroleone ofuser,assistant,tool. Atoolmessage also carriestool_call_idandname.input: a standalone prompt with no conversation around it, required forgeneraltests and for atool_calltest aimed at ageneralagent. A string, not a conversation.evaluation: the required{type, ...}, wheretypematches the test'stypebelow.settings: an optional object, e.g.{"language": "en"}.
A tool_call test carries exactly one of history or input, and which one it carries decides the agent it can be linked to.
evaluation by test type:
response: judge the agent's reply, graded by the linked evaluators.{"type": "response"}conversation: append the reply and judge the whole conversation.{"type": "conversation"}tool_call: diff the agent's tool calls against expected ones. Addtool_calls, a list of{tool, arguments, accept_any_arguments?}.general: judge a standalone, non-conversational input/output pair, graded by the linked evaluators.{"type": "general"}
For tool_call, each expected argument value is one of:
{"match_type": "exact", "value": <any>}: must equalvalue{"match_type": "llm_judge", "criteria": "..."}: judged against the criteria{"match_type": "any"}: any value, only checks the argument was passed
response / conversation example:
tool_call example, for a conversational agent. Swap history for input to aim it at a general agent:
general example:
Evaluators are linked via the separate evaluators field, not inside config.
Replaces the stored config. Omit to leave unchanged
New evaluator links for the test. Omit to leave unchanged. An empty list clears them, except on conversation tests, which must keep at least one
Response
Successful Response
Unique ID for the test
36"b1c2d3e4-f5a6-7890-bcde-f12345678901"
Name of the test
What the test judges:
response: judges the generated replytool_call: diffs the generated tool callsconversation: judges the full conversationgeneral: judges a single plain-text input/output pair with no conversation involved (e.g. summarization, extraction, classification)
response, tool_call, conversation, general When the test was created (ISO 8601 UTC)
When the test was last updated (ISO 8601 UTC)
The stored config: history, evaluation, and an optional settings
Linked evaluators, resolved to their current live version at read time