Agent Setup Guide

​

Create an Agent

1. Go to the Agents section from the left navigation bar.
2. Click the Create Agent button in the top right, or if you’re a new user, click Create your first agent in the center of the page.
3. Fill in basic info: agent name, language, and description.
4. Configure a provider and connection type.

​

Basic Info

​

Agent Description

By clearly articulating your agent’s description, you enable us to generate automatic, accurate evaluators.

​

Type of Agent

Single Prompt Agent

For Single prompt agents, you can copy the agent’s main prompt here.

Multi State Agent

If you have multi-state agent, you can build a description in a json structure.
Note - We are very flexible with description so even if you copy paste all your prompts and paste as one huge prompt, we can process. JSON is the recommended approach.

[
  {
    "node_name": "<>",
    "node_description": "<>"
  },
  {
    "node_name": "<>",
    "node_description": "<>"
  }
]

Retell Workflows

If you have an agent with Retell workflows, you can export the agent’s details as json from Retell.
Go to agents -> select the agent -> click on export button (this will download a .json file) -> copy the content of the file and paste it in agent description field.

Vapi Workflows

If you have an agent with Vapi workflows, you can export the agent’s details as json from Vapi.
Go to workflows -> select the agent -> click on code button on top right -> copy the content shown and paste it in agent description field.

​

Configuration

​

Provider

Custom

LiveKit

Pipecat

ElevenLabs

Chirp

Retell

VAPI

Cisco Webex

Bland AI

Synthflow

Kore.ai

Trillet

Genesys

Agentforce

Agora

​

Connection

​

Voice Connection

Telephony

Connect via a phone number. Cekura will dial your agent directly over the PSTN network, making it the simplest way to test a phone-based voice agent.

1

Enter your phone number

Add the phone number your agent receives calls on or makes calls from.

2

Choose call direction

Toggle Inbound on if you want Cekura’s agent to call you on the above number. Leave it off for outbound — Cekura will dial your agent instead.

SIP

Connect via a SIP trunk. Suited for enterprise telephony setups where your agent is reachable through a SIP endpoint rather than a regular phone number.

1

Enter your SIP Endpoint

Add the SIP address your agent is reachable on (e.g. sip:user@example.com).

2

Add SIP Authentication credentials

If your SIP server uses Digest Auth, enter the Username and Password to authenticate the connection.

WebRTC

WebRTC enables real-time browser-based voice testing without needing a phone number or external device.WebRTC is configured automatically upon choosing your provider and filling in the relevant details.

WebRTC calls are only supported by LiveKit, Pipecat, VAPI, Retell, and Agora.

​

Chat Connection

SMS

Connect via SMS. Enter the phone number your agent sends and receives chat messages on.

Already configured if you’ve set up Telephony — the same number is used automatically.

WhatsApp

Connect via WhatsApp. Enter the WhatsApp-enabled phone number your agent sends and receives chat messages on.

Already configured if you’ve set up Telephony — the same number is used automatically.

Configure Twilio credentials in Settings → Provider API Keys for WhatsApp integration.See WhatsApp Testing Guide for detailed setup.

WebSocket

WebSocket enables real-time, two-way chat between your agent and the LLM, allowing dynamic and continuous conversation testing.

1

Enter your WebSocket URL

Add the WebSocket endpoint your chatbot is reachable on (e.g. wss://your-chatbot-endpoint.com).

2

Enter your WebSocket Secret

Add a secret that Cekura will send in the X-VOCERA-SECRET header with every request, so your server can verify the connection.

Provider Chat

Connect directly through your provider’s native chat interface — no phone number or messaging service required.

Native provider chat is only available with ElevenLabs, VAPI, LiveKit, Retell, and Bland AI.

Provider chat is configured automatically using your voice agent settings. However, Retell and Bland AI require some additional configuration — you’ll need to provide a separate chat agent ID for those providers.

​

Additional Settings (Optional)

Knowledge Base

Upload reference material your agent uses, so Cekura can generate more accurate evaluators grounded in your content.We support two options for Knowledge Base:

• Upload a document — drag and drop or select a file directly. Supported formats: PDF, TXT, JSON, MD, CSV, XML.
• Connect an external source — click Add Connector to sync knowledge base content from an external source such as Google BigQuery or a Website Scraper.

Mock Tools

Define mock input/output data for tool calls so Cekura can simulate your agent’s tool usage during testing.There are two ways to add mock tools:

• Auto-Fetch — automatically pulls your tool definitions directly from your provider, so you don’t have to add them manually.
• Add Tool manually — create a mock tool yourself and define its behaviour using Input/Output Mappings in JSON.

Read more about Mock Tools.

Dynamic Variables

Dynamic variables are values injected at call time during scenario generation — letting you parameterise your test scenarios with real-world data like names, addresses, or account IDs instead of hardcoding them.Click Add Variables to define a new variable. Each variable has a name (e.g. address, name) and a default value that Cekura uses when running simulations.Read more about Dynamic Variables.