Skip to main content

​
Overview

Test your LiveKit agents with automated room and token management. Cekura handles room creation and token generation automatically.
Run tests directly from the frontend without writing code.
1

Configure LiveKit credentials

Go to your agent settings and configure LiveKit integration:LiveKit ConfigurationRequired fields:
  • Provider: Select LiveKit from the dropdown
  • LiveKit API Key: Your LiveKit API key
  • LiveKit API Secret: Your LiveKit API secret
  • LiveKit URL: Your LiveKit server URL (e.g., wss://your-server.livekit.cloud)
Optional fields:
  • Agent Name (Optional): The specific agent name to dispatch in LiveKit
When to use Agent Name: Use this field when you have configured a specific agent name in your LiveKit agent setup. When provided, Cekura will dispatch to agents matching this exact name during test execution.Leave this field empty if:
  • You’re using the default agent dispatching behavior
  • Your LiveKit setup doesn’t use named agents
  • You want any available agent to handle the request
  • LiveKit Config (JSON): Additional room configuration parameters
Accessing Config in Your Agent: Config parameters you might be using in your livekit agent’s code. The configuration JSON is stored in the LiveKit room’s metadata. Access it in your agent’s entrypoint:
import json
from livekit.agents import JobContext

async def entrypoint(ctx: JobContext):
    await ctx.connect()

    # Access room metadata
    room_metadata = ctx.room.metadata
    config = json.loads(room_metadata) if room_metadata else {}

    # Use config values
    empty_timeout = config.get("empty_timeout", 300)
    max_participants = config.get("max_participants", 10)
2

Run tests from frontend

Select scenarios and run tests using the UI:Run LiveKit TestsClick “Run with LiveKit” to execute your tests. Cekura automatically:
  • Creates unique rooms for each scenario
  • Generates access tokens
  • Executes tests and cleans up resources
3

View results

Results appear in your dashboard. Track test status, metrics, and conversation details in real-time.

​
Next Steps