NovaSynth Setup
Configure your agent connection in NovaSynth — set up the agent profile, choose a provider, and verify the connection before running tests.
Setup Wizard
The first time you open NovaSynth in a project, the Setup Wizard guides you through two steps:
- Agent profile — describe your agent
- Provider connection — connect to your deployment platform
You can update either step at any time from the Agent Config page.
Step 1 — Agent profile
| Field | Description |
|---|---|
| Agent name | A display name for this agent in NovaSynth (e.g., production-support-bot) |
| System prompt | The system prompt your agent uses. NovaSynth uses this to help the synthetic user understand what kind of agent it is talking to. |
| Additional instructions | Extra context for the synthetic user (e.g., "The agent only handles billing questions") |
| Agent type | voice — real-time audio via LiveKit/SIP; phone — outbound SIP call |
| Language | The primary language for synthetic sessions (50+ languages supported, including English, Spanish, French, German, Hindi, Japanese, Mandarin, Portuguese, Arabic, and more) |
Step 2 — Provider connection
Choose your agent's deployment platform and enter the required credentials.
LiveKit
Connect when your agent is built with the LiveKit Agents SDK.
| Field | Description |
|---|---|
| LiveKit URL | Your LiveKit server URL (e.g., wss://my-project.livekit.cloud) |
| API key | LiveKit API key with room join permissions |
| API secret | Corresponding API secret |
| Agent name | The LiveKit agent worker name to dispatch (e.g., my-agent) |
Pipecat Cloud
Connect when your agent uses the Pipecat framework (cloud or self-hosted).
| Field | Description |
|---|---|
| WebSocket URL | Pipecat bot server WebSocket endpoint (e.g., wss://your-bot.example.com/ws) |
| API key | API key for authenticating with your Pipecat server |
ElevenLabs
Connect when your agent is deployed as an ElevenLabs Conversational AI agent.
| Field | Description |
|---|---|
| Agent ID | ElevenLabs agent identifier (from your ElevenLabs dashboard) |
| API key | ElevenLabs API key with agent access |
Retell
Connect when your agent is deployed on the Retell platform.
| Field | Description |
|---|---|
| Agent ID | Retell agent identifier |
| API key | Retell API key |
VAPI
Connect when your agent is deployed as a VAPI assistant.
| Field | Description |
|---|---|
| Assistant ID | VAPI assistant identifier |
| API key | VAPI API key |
Phone / SIP
Place outbound calls directly to your agent's phone number.
| Field | Description |
|---|---|
| SIP trunk | The SIP trunk configuration to use for outbound calls |
| Phone number | The phone number to call (E.164 format, e.g., +14155551234) |
| Max duration | Maximum call duration in seconds (default: 300) |
Agent Config
After initial setup, the Agent Config page lets you:
- Update the agent name, system prompt, and instructions
- Add additional key-value parameters that are passed to the provider when starting a session (useful for custom headers, API versions, or feature flags)
- Switch to a different provider connection
Agent Connections
Before running a batch test, verify your credentials on the Agent Connections page:
Managing multiple connections
You can configure connections to multiple providers within the same project. This is useful when:
- You're migrating from one provider to another and want to compare results
- You have different agent variants deployed on different platforms
Each connection (created on the Agent Connections page) maps a persona+scenario combination to a specific provider, so you can run the same scenarios against different deployments in parallel.
Next steps
- Personas, Scenarios & Runs — create test cases and start running sessions
- NovaSynth Overview — understand how sessions flow into evaluations
Get Early Access to Noveum.ai Platform
Be the first one to get notified when we open Noveum Platform to more users. All users get access to Observability suite for free, early users get free eval jobs and premium support for the first year.