cekura 1.0.0rc2

Testing and Observability SDK for AI Agents

Cekura Python SDK

Testing and Observability for AI Voice Agents. Launch in minutes not weeks by ensuring your agents deliver a seamless experience in every conversational scenario.

Installation

pip install cekura

LiveKit Integration

Setup

1. Create a new agent in the Cekura dashboard
2. Select LiveKit as the provider in agent settings
3. Enable tracing for your agent
4. Copy your API key and Agent ID

Quick Start

import os
from livekit import agents
from cekura.livekit import LiveKitTracer

# Initialize Cekura tracer
cekura = LiveKitTracer(
    api_key=os.getenv("CEKURA_API_KEY"),
    agent_id=123
)

@server.rtc_session(agent_name="my_agent")
async def entrypoint(ctx: agents.JobContext):
    # Create your assistant and session
    assistant = YourAssistant()
    session = agents.AgentSession(...)

    # Track session with Cekura (automatic tool injection and export)
    await cekura.track_session(ctx, session, assistant)

    # Start your session
    await session.start(room=ctx.room, agent=assistant)

Next Steps

After integrating the SDK, you can:

• Run tests from the Cekura platform
• Monitor real-time conversations
• Analyze performance metrics
• Review conversation transcripts and tool calls

Features

• One-Line Integration: Simple track_session() API for seamless integration
• Automatic Metrics Collection: Captures STT, LLM, TTS, and End-of-Utterance metrics
• Conversation Tracking: Records complete chat history with tool calls
• Mock Tool Injection: Automatically replaces tools with mock versions configured in Cekura dashboard
• Session Reports: Generates comprehensive session reports from LiveKit

Mock Tools

The SDK automatically injects mock tools when running tests from the Cekura platform. Mock tools return predefined responses configured in the dashboard.

Setup:

1. Create mock tools in the Cekura dashboard under your agent settings
2. Define input/output pairs for each tool
3. When tests run, the SDK automatically replaces matching tools with mocks

Configuration

Parameters

• api_key (str, required): Your Cekura API key
• agent_id (int, required): Unique identifier for your agent from Cekura dashboard
• host (str, optional): API host URL (default: https://api.cekura.ai)
• enabled (bool, optional): Enable/disable tracing. Defaults to CEKURA_TRACING_ENABLED env var ("true" if not set)

Environment Variables

• CEKURA_TRACING_ENABLED (default: "true"): Enable/disable session tracing
• CEKURA_MOCK_TOOLS_ENABLED (default: "true"): Enable/disable mock tool injection

Data Collected

The SDK automatically collects:

• Session start/end timestamps
• Complete conversation transcripts
• Tool/function calls and outputs
• Performance metrics:
  • Speech-to-Text (STT) latency and duration
  • LLM token usage and timing
  • Text-to-Speech (TTS) generation time
  • End-of-Utterance detection timing
• Room and job information
• Custom metadata

Requirements

• Python 3.9+
• aiohttp>=3.9.0

License

MIT License - see LICENSE file for details.

Links

• Homepage
• Documentation
• Dashboard

Support

For support, email [e-mail]