> ## Documentation Index
> Fetch the complete documentation index at: https://developer.watson-orchestrate.ibm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

Build a comprehensive web-based testing tool for voice agents that provides real-time conversation testing, call recording, and CDR (Call Detail Record) monitoring capabilities.

This FastAPI application serves a browser-based interface for testing voice agents with three main features:

1. **Talk to Your Agent** - Interactive voice conversation testing with DTMF support
2. **Call Recording Server** - Record and playback voice conversations
3. **CDR Logs** - Monitor Call Detail Records and conversation analytics

## Features

<AccordionGroup>
  <Accordion title="Talk to Your Agent">
    Test your voice agent in real-time through the browser interface.

    **Key Capabilities:**

    * **Real-time Voice Conversation**: Connect to your voice agent via WebSocket
    * **DTMF Support**: Test touch-tone input using on-screen keypad or keyboard (0-9, \*, #)
    * **Audio Streaming**: Bidirectional audio streaming at 16kHz PCM
    * **Connection Management**: Start/stop conversations with visual status indicators

    **Configuration Settings:**

    * Agent ID
    * Environment ID
    * Access Token
    * Thread ID (optional)
    * WebSocket URL (defaults to current host)
  </Accordion>

  <Accordion title="Call Recording Server">
    Record, store, and playback voice conversations for analysis and debugging.

    **Recording Features:**

    * **Automatic Recording**: Captures both user and agent audio streams
    * **Multiple Audio Formats**:
      * `user.raw` - User audio (mono, 16kHz, 16-bit PCM)
      * `agent.raw` - Agent audio (mono, 16kHz, 16-bit PCM)
      * `interleave.raw` - Combined stereo audio (both channels mixed)
    * **Metadata Tracking**: Duration, frame counts, timestamps
    * **Browser Playback**: Built-in audio player with automatic PCM-to-WAV conversion
    * **Recording Management**: View, browse, and delete recordings

    **Recording Server URL:**

    ```
    ws(s)://<host>/record
    ```

    Configure your voice runtime to send recordings to this endpoint.
  </Accordion>

  <Accordion title="CDR Logs">
    Monitor and analyze Call Detail Records from your voice runtime.

    **CDR Monitoring Features:**

    * **Real-time Updates**: Auto-refresh every 5 seconds when viewing
    * **Statistics Dashboard**:
      * Total reports count
      * Successful calls
      * Failed calls
      * Last received timestamp
    * **Detailed Reports**: View complete CDR payloads including:
      * Transaction ID
      * Agent ID
      * Environment ID
      * Call duration
      * Turn count
      * End reason
      * Failure indicators
    * **Search Capabilities**: Find reports by transaction ID or thread ID
    * **Report Management**: Clear all reports or view individual details

    **CDR Webhook URL:**

    ```
    http(s)://<host>/cdr-webhook
    ```

    Configure your voice runtime to send CDR webhooks to this endpoint.
  </Accordion>
</AccordionGroup>