Evaluations
Create an eval
Binds an agent under test to a dataset and a list of scorers. The agent and the dataset must belong to the same project as the eval; a cross-project reference is rejected with 400.
Scorer config is frozen here rather than read from the agent at run time, so two runs of the same eval are always judged by the same criteria and their comparison measures the agent instead of the config drifting underneath it. Each scorer type may appear at most once.
post/v1/projects/{project_id}/evals
Request
- Base URL: https://api.naturali.ai
- URL: https://api.naturali.ai/v1/projects/{project_id}/evals
- Auth: one of:
- HTTP bearer
- OAuth 2 (authorization code, authorization URL https://api.naturali.ai/authorize, token URL https://api.naturali.ai/token, scopes: mcp:access)
Request body
Example request
{
"name": "billing-regression-suite",
"agent_id": "agent_V1StGXR8Z5jdHi6B",
"dataset_id": "dset_V1StGXR8Z5jdHi6B",
"scorers": [
{
"value": "invoice"
}
],
"pass_threshold": 0.8,
"group_by": "kind"
}Response
Eval created successfully
Example response
{
"id": "eval_V1StGXR8Z5jdHi6B",
"agent_id": "agent_V1StGXR8Z5jdHi6B",
"dataset_id": "dset_V1StGXR8Z5jdHi6B",
"scorers": [
{
"value": "invoice"
}
],
"group_by": "kind"
}Changes
No recorded changes to this operation across all 1 revision of this API.