Skip to main content

Overview

When issues arise with your voice agent, effective debugging techniques help you identify and fix problems quickly.

Enable Debug Logging

Increase Log Verbosity

Log Tool Execution

Common Issues

1. Connection Problems

Symptom: Agent won’t connect to platform Debug:
Common Causes:
  • Invalid API key or customer ID
  • Network connectivity issues
  • Firewall blocking WebSocket connections
Solution:

2. Tool Not Being Called

Symptom: AI doesn’t call your tool Debug:
Common Causes:
  • Tool description unclear
  • Tool not registered properly
  • Tool name conflicts
Solution:

3. Tool Execution Errors

Symptom: Tool throws exceptions Debug:

Debugging Tools

Interactive Debugging

Use Python debugger:
Add strategic print statements:

Test Mode

Create a test mode for debugging:

Checking State

Inspect Conversation State

Testing Individual Tools

Test Tools Directly

Best Practices

1. Use Structured Logging

2. Add Error Context

3. Test Tools in Isolation

Troubleshooting Checklist

When debugging issues:
  • Check logs for errors
  • Verify API credentials
  • Test tool functions directly
  • Verify tool descriptions are clear
  • Check conversation state
  • Test with debug logging enabled
  • Review error handling in tools

Getting Help

If you’re still stuck:
  1. Check Conversimple documentation
  2. Review logs for specific error messages
  3. Test with minimal example agent
  4. Contact support with logs and details

Next Steps

Error Handling

Handle errors gracefully

Logging

Set up proper logging