Skip to main content

​
Troubleshooting

​
The agent doesn’t respond

Check:
  • LLM API key is set in .env.local
  • The LLM node is connected to the Framework node
  • Restart the dev server after adding keys

​
No voice output (silent agent)

Check:
  • TTS API key is set
  • TTS node is connected to the Framework node’s tts_in
  • Try a different TTS provider

​
No voice input (agent can’t hear me)

Check:
  • Browser microphone permissions are granted
  • STT API key is set
  • STT node is connected to the Framework node’s stt_in
  • DEEPGRAM_API_KEY is set (used for builder voice dictation)

​
Session fails to start

Check:
  • LIVEKIT_URL, LIVEKIT_API_KEY, LIVEKIT_API_SECRET are all set
  • LiveKit credentials are valid (test in your LiveKit Cloud dashboard)
  • No typos in the URL (must start with wss://)

​
AI generator returns an error

Check:
  • ANTHROPIC_API_KEY is set
  • You have Anthropic API credits
  • The flow has the required nodes (framework, LLM, TTS, STT, start, end)

​
Flow validation error

Voiceblox validates the graph before applying AI-generated operations. Common validation errors:
ErrorFix
Missing framework nodeAdd a LiveKit node
No start nodeAdd a Start node connected to the Framework
If/Else directly after StartAdd a Burst or Open Talk between Start and If/Else
Categorize has no categoriesAdd at least two categories to the Categorize node

​
Step highlighting not working

Check:
  • The LiveKit SDK is connected to the room
  • Check browser console for WebSocket errors

​
Restarting the agent

If the agent gets into a bad state, click End Session and then Start Session again to restart with a fresh session.