Test Agents in the Browser

Test your agent in the browser without phone calls. Click Test to start voice or chat conversations with real-time transcripts. What you’ll learn: Starting test conversations, choosing test modes, and reviewing results.

Start a test conversation

Open your agent

Go to Agents in the sidebar and select your agent.

Click Test

Click Test in the Quick Actions panel.

Choose your mode

Select Voice, Chat, or Phone from the mode selector.

Have a conversation

Speak or type to interact with your agent. The transcript displays in real time.

End the call

Click End Call when finished. Call results become available for review.

Test modes

Mode	Description	Best for
Voice	Real-time voice conversation using STT and TTS	Final validation, voice quality, latency testing
Chat	Text-based conversation with instant responses	Prompt iteration, debugging, quick scenarios
Phone	Call a real phone number	End-to-end telephony testing

Test controls

Control	Function
Mode selector	Switch between Voice, Chat, and Phone modes
Text input	Type messages (chat mode)
End Call	Stop the current conversation

Reviewing results

After ending a test call, view the call result:

End the call

Click End Call when finished.

View the result

Click Show on the Result indicator in the dev toolbar.

Export for debugging

Copy to clipboard or Download as JSON.

Result structure:

Example: Result structure

{
  "callId": "660e8400-e29b-41d4-a716-446655440001",
  "status": "Completed",
  "agentId": "agent-abc123",
  "endpoint": "web",
  "duration": "00:02:15",
  "inspectorUrl": "https://inspector.blackbox.ai/..."
}

For detailed analysis, open the Call Inspector using the inspectorUrl.

Pre-deployment checklist

Troubleshooting

Test won't start

Possible causes: Incomplete configuration, network issues, unsaved agentSolutions:

Verify all required fields are completed (LLM config, TTS config, STT config)
Check that API keys are valid and have necessary permissions
Save the agent before attempting to test
Clear browser cache and reload the page

Microphone not working

Possible causes: Permission denied, wrong device selectedSolutions:

Click the lock icon in the address bar → Allow microphone access
Check system privacy settings
Try a different browser (Chrome works best)

Agent doesn't respond

Possible causes: LLM configuration error, prompt issueSolutions:

Verify the LLM API key is valid
Check the model name is correct
Test with a minimal prompt: “You are a helpful assistant.”

API testing

Schedule test calls programmatically for automation:

API example: Schedule test call

const response = await fetch('https://blackbox.dasha.ai/api/v1/calls?agentId=your-agent-id', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    endpoint: "web",
    priority: 7,
    callDeadline: new Date(Date.now() + 600000).toISOString(),
    additionalData: {
      testSession: true,
      testScenario: "basic-greeting"
    }
  })
});

const call = await response.json();
console.log(`Test call scheduled: ${call.callId}`);

What’s next

Call Inspector

Analyze completed calls

Troubleshooting

Common issues and solutions

Testing Guide Call Inspector

⌘I

Introduction

Create

Test

Deploy

Monitor

Advanced Features

Troubleshooting

Start a test conversation

Test modes

Test controls

Reviewing results

Pre-deployment checklist

Troubleshooting

API testing

What’s next

Call Inspector

Troubleshooting

​Start a test conversation

​Test modes

​Test controls

​Reviewing results

​Pre-deployment checklist

​Troubleshooting

​API testing

​What’s next

Call Inspector

Troubleshooting

Start a test conversation

Test modes

Test controls

Reviewing results

Pre-deployment checklist

Troubleshooting

API testing

What’s next