Skip to main content
Each agent configuration acts as a reusable connection profile that can be referenced across multiple simulations, evaluations, and conversations without requiring reconfiguration.

​
How to Configure Agents

​
Adding an Agent

Connect Agent Demo
  1. Navigate to the Agents section in your dashboard
  2. Click “Add New Agent”
  3. Configure the connection parameters. These are specific to each agent type — see Connect Your Agent for the fields your connection requires.
  4. Set operational parameters:
    • Language Preferences: Primary and fallback language configurations
    • Agent Behavior Prompts: System prompts or behavioral guidelines
    • Simulator Types: Compatible simulation environments

​
Attributes

In your agents, you can set specific attributes associated with that agent. For example, if you have multiple agents representing different restaurant reservation services, you could define the attributes such as “opening_hours” and “menu_items”. You can embed these agent attributes into test case scenarios or metric prompts by inserting {{agent.attribute_name}}. In the example above, you could create a metric that asks: 
Did the agent give the correct opening hours?  
Opening hours are `{{agent.opening_hours}}`
or, if you could use it in a test case: 
Order two items from this list: {{agent.menu_items}}

​
Test Your Connection

Once your agent is configured and saved, use the Test connection button in the agent config page to verify connectivity before running simulations. What gets tested: Reading the result:
  • Success — A green confirmation appears and auto-dismisses after 60 seconds.
  • Failure — A red alert stays visible with the error details. Expand the result to see the raw JSON response for debugging.
The button is disabled when you have unsaved changes. Save first, then test.

​
Version history

Every config-changing save of an agent is recorded in its version history, so you can see how its connection and behavior configuration changed over time and tell which version a run executed against. See Versioning for how copy-on-save works and how to pull the history through the v1 API.

​
Connect Your Agent

Inbound Voice

Receive incoming phone calls for customer service scenarios

Outbound Voice

Make calls to users for sales and scheduling

Chat agent

Standard HTTP chat, including OpenAI-compatible APIs

Chat WebSocket

Text chat over persistent WebSocket connections

Chat A2A (JSON-RPC)

Text chat over the A2A v2 JSON-RPC protocol

OpenAI Realtime

Voice-to-voice agents on the OpenAI Realtime API

Gemini Live

Voice-to-voice agents on Google Gemini Live

Pipecat Cloud

Integrate with Pipecat Cloud agents

LiveKit

Advanced real-time communication platform