Create test
Tests
Create test
Create a test that runs your agent against a conversation and evaluates its answer quality or the tools it calls
POST
Create test
Authorizations
API key for authentication
Body
application/json
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 conversation
Available options:
response, tool_call, conversation The calibrate test config. Three top-level keys.
history: the required conversation up to the agent's turn. Each item is{role, content}withroleone ofuser,assistant,tool. Atoolmessage also carriestool_call_idandname.evaluation: the required{type, ...}, wheretypematches the test'stypebelow.settings: an optional object, e.g.{"language": "en"}.
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?}.
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:
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
Example:
Evaluators to link. Used by response and conversation tests