Use Conversation and Agent Nodes

Global prompt and current stage

The workflow global system prompt establishes universal rules. Every active workflow Agent receives it. A node then adds its current-stage instruction, which prevents the Agent from handling another step prematurely.

Conversation

Conversation does not create a new LiveKit Agent. It updates the current active Agent’s instructions and completion policy.
The first two stages use the same main Agent. The specialist node creates a new scoped Agent.

Direct Agent

An Agent node starts a fresh scoped Agent. Use it when the next stage needs its own prompt, model, voice, transcriber, tools, files, or resolution outputs. It remains the active Agent after Say, Logic, Function, integration, and Task nodes until a later Agent or Subagent handoff. Configure:
  • Instructions and completion contract
  • Model provider and model
  • TTS provider, voice, and language
  • STT provider, model, and language
  • Organization tools and files
  • Timeout/recovery routing

Subagent

Subagent loads an existing Assistant and applies its optional overrides. Existing saved Subagent workflows remain supported, but use a direct Agent in new workflows when you want the workflow to own the configuration.