Get Version Eval Summary

Retrieves evaluation summary statistics for an agent version.

GET https://api.futureagi.com/simulate/agent-definitions/{agent_id}/versions/{version_id}/eval-summary/

Authentication

X-Api-Key API Key Required

Your Future AGI API key used to authenticate requests. You can find and manage your API keys in the Dashboard under Settings.

X-Secret-Key Secret Key Required

Your Future AGI secret key, used alongside the API key for request authentication. This is generated when you create an API key in the Dashboard.

Path parameters

agent_id UUID Required

The agent definition ID.

version_id UUID Required

The agent version ID.

Response

200 OK

Array of evaluation template statistics. Empty array if no evaluations configured.

eval_id string
UUID of the evaluation template.
eval_name string
Name of the evaluation template.
eval_type string
Evaluation type category (e.g., "tone", "relevance").
total integer
Total evaluations run for this template.
pass integer
Number of passed evaluations.
fail integer
Number of failed evaluations.
error integer
Number of evaluations that errored (distinct from pass/fail).
pass_rate number
Pass rate as a percentage (0-100).

Errors

401 Unauthorized Optional

Invalid or missing API credentials.

404 Not Found Optional

Agent definition or version not found.

500 Internal Server Error Optional

Unexpected server error.

GET /
Authentication
REQUEST 
 
 
  
 
 RESPONSE