Skip to main content

​
Overview

Test your LiveKit agents with automated room and token management. Cekura handles room creation and token generation automatically.
  • No-code
  • Code
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: LiveKit
  • LiveKit API Key: Your API key
  • LiveKit API Secret: Your API secret
  • LiveKit URL: Server URL (e.g., wss://your-server.livekit.cloud)
Optional - Room Config (JSON):
{
  "empty_timeout": 300,
  "max_participants": 10,
  "departure_timeout": 60,
  "min_playout_delay": 0,
  "max_playout_delay": 0,
  "sync_streams": false
}
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