For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Login
HomeDocsAPI ReferenceMCP ServerChat SDKsRelease Notes
HomeDocsAPI ReferenceMCP ServerChat SDKsRelease Notes
  • Introduction
    • Overview
    • Getting started
    • Authentication
    • Data privacy
    • Built-in prompts
    • FAQ
    • Troubleshooting
  • Tools
    • Overview
    • get_ada_configuration
    • get_ada_metric
    • get_available_filters
    • get_conversations
    • get_conversation
    • search_knowledge
    • search_coaching
    • get_improvement_guide
    • list_entities
    • propose_change
    • get_test_cases
    • get_test_runs
    • get_test_run_quota
    • send_feedback
  • Prompt library
    • Overview
    • Improvement recommendations
    • Quick health checks
    • Create visualizations
    • Diagnose performance issues
    • Identify optimization opportunities
    • Review configuration
    • Search knowledge and coaching
    • Test agent responses
    • Deep-dive analysis
Login
LogoLogo
On this page
  • Example prompts
  • Parameters
  • Response
Tools

get_test_runs

Was this page helpful?
Previous

get_test_run_quota

Next
Built with

Retrieves test run results for an AI Agent. Use this to review pass/fail status, evaluation criteria outcomes, and rationale after triggering a test_run via propose_change.

Example prompts

  • “Show me the latest test run results for each of my test cases.”
  • “Which test cases failed in the last run, and why?”
  • “Get the full details for test run abc123.”

Parameters

ParameterTypeDescription
test_run_idstringOptional. Return full details for a single test run.
status_filterstringOptional. Limit to runs with a specific status (for example, passed, failed).
test_case_idsarrayOptional. Restrict results to runs for specific test case IDs.
latest_per_test_casebooleanOptional. When true, returns only the most recent run per test case.
cursorstringOptional. Pagination cursor for historical run listings.

Response

Returns per-run results including:

  • Test run ID and test case ID.
  • Overall pass/fail status.
  • Per-evaluation-criterion outcomes and rationale.
  • The simulated conversation transcript the evaluation was based on.
  • Timestamps and the user who triggered the run.