Skip to main content
Use Coval from your application, Terraform configuration, or terminal.

Choose a tool

API SDKs

Manage resources, launch runs, and read results with the Python and TypeScript API clients.

Agent SDK

Connect your existing Python voice pipeline to simulated callers through an outbound audio connection.

Terraform Provider

Manage test configuration in version control.

CLI

Manage configuration and run evaluations from your terminal or scripts.

Build a testing workflow

Configure tests in code, run them from your application or CI, and review the results in Coval.
1

Configure your tests

Define personas, test sets, cases, and evaluation metrics with the Terraform provider, or manage them directly with the API SDKs. Reuse the resulting resource IDs when you run tests.
2

Run your agent

Use the Agent SDK to exchange audio between your existing voice pipeline and Coval’s simulated caller. Your application owns its framework, model providers, and conversation state.
3

Review the results

Open the run in Coval to inspect recordings, transcripts, evaluations, and optional traces. Use the API SDKs or CLI when you need to read results programmatically.
See Using Terraform with the Agent SDK for an example.

Reference and setup

API reference

Explore the HTTP endpoints and request and response schemas.

API keys

Create and manage credentials for your application or CI environment.