Create test
Create a test that runs your agent against a conversation and evaluates its answer quality or the tools it calls
Authorizations
API key for authentication
Body
Name of the test, unique within the workspace
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 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.
Omit to create the test with no config and fill it in later via update
Evaluators to link. Used by response and conversation tests