Skip to main content

Framework Node

The Framework node is the heart of every Voiceblox flow. It receives all component connections, acts as the entry point for the conversation step chain, and determines the runtime. Every flow must have exactly one Framework node.

Providers

ProviderStatus
livekit✅ Stable
pipecat🔜 Coming soon

Parameters

ParameterTypeDefaultDescription
providerenumlivekitRuntime framework (livekit)
allow_interruptionbooleantrueWhether the user can interrupt the agent while it’s speaking

Input handles

HandleTypeMax connectionsDescription
persona_inpersona1Agent identity and system prompt
llm_inllm1Language model
tts_intts1Text-to-speech engine
stt_instt1Speech-to-text engine
avatar_inavatar1Visual avatar (optional)
transfer_inframeworkunlimitedIncoming transfers from Transfer nodes
tools_incontextunlimitedMCP servers and Exa search tools

Output handle

HandleTypeDescription
outputcontrolConnects to the Start node

Interruption behavior

When allow_interruption is false, the agent disconnects the user’s audio input while speaking. Useful for scripted announcements or compliance-sensitive flows.
A flow without a Persona, LLM, TTS, and STT connected to the Framework node will fail to run.