Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.voxworks.ai/llms.txt

Use this file to discover all available pages before exploring further.

What is a Flow?

A Flow is a subcomponent of a conversation. If you were speaking to a friend, you might first talk about the weather, then about your day, then about your plans for the weekend. Each of these topics is a flow. In Voxworks, a Flow a consists of:
  • Steps — Individual turns of speech the assistant performs, as well as any actions the assistant takes (speak, execute logic, call tools)
  • Conditions — Rules that determine which path to take to the next step based on user responses
  • Variables — Any data that is expected to be different for each conversation, such as the participant’s first name or account number. Variables can be captured, modified, and used throughout the conversation

Flow Architecture

Voxworks uses a hierarchical flow structure:
Script
   Main Flow (entry point)
       Step 1 (Voice)
          Condition A → Step 2
          Condition B → Step 3
       Step 2 (Voice)
          Condition → Step 3
       Step 3 (Flow)
           Sub-Flow
               Step 1
               Step 2 → Return to Main Flow
  • Main Flow — The primary conversation path
  • Sub-Flows — Modular conversation branches that can be reused across flows
  • Steps — The individual units of work within a flow

Step Types

Flows contain four types of steps:
TypePurposeInteractive
VoiceSpeak to the user and wait for a responseYes
FunctionExecute custom logic (validation, calculations)Yes
ToolCall external services and APIs (SMS, calendar, etc.)Yes
FlowJump to a sub-flowDepends on sub-flow

How Flows Execute

  1. Start — The agent begins at the main flow, step 0
  2. Execute Step — The current step is executed based on its type
  3. Evaluate Conditions — For voice steps, user response determines the next path
  4. Navigate — The LLM decised which step to move to the next step based on conditions
  5. Repeat — Continue until a the main flow “end flow” condition is reached then the call will end

Conditions and Branching

Voice steps include conditions that determine where to go next:
Step: "Are you interested in scheduling a demo?"
   Condition: "User expresses interest" → Go to booking flow
   Condition: "User has questions" → Go to FAQ step
   Condition: "Otherwise" → Stay on same step
Conditions are evaluated by the AI based on the user’s actual response, not keyword matching. This allows natural, flexible conversations.

Key Concepts

ConceptDescription
Main FlowThe primary conversation entry point
Sub-FlowA reusable conversation module
Voice StepInteractive turn with the user
Function StepBackend logic execution
Tool StepExternal service integration
Flow StepNavigation to a sub-flow
VariablesData storage and retrieval

Next Steps