Conversation flow
The flow builder is the primary interface where you visually design your conversation flow by creating and connecting states on a canvas. This visual editor allows you to map out the entire conversation structure of your agent.
Types of nodes
The flow builder uses three types of nodes to structure conversations:
Greeting Message Node
The greeting message serves as the entry point for every conversation. It is read out verbatim at the beginning by Sarvam’s voice agents, for both inbound and outbound calls. Keep it short (under 2 lines) and make use of variables to personalize this message, e.g., user_name, product_name. Read more here.
This node is pinned and cannot be removed.
Global Instructions Node
Defines the core personality and behavior guidelines of the agent. Learn more about writing global instructions here.
This node is pinned and cannot be removed.
State Node
Main conversation states that define the flow of interaction. Learn more about writing state instructions here.
Working with states
Adding & editing states
Create a New State
Click the “Add State” button to create a new state on the canvas.
Configure State Settings
Click any state to open the configuration sidebar, where you can:
- Edit the state’s name
- Write instructions using the rich text editor
- Add variables from a multi-select dropdown
- Configure transitions (Next Available States) from a multi-select dropdown
- Add tools from a multi-select dropdown
Save Changes
Click the Save button to apply your state configurations
Managing state connections
Edges (lines connecting states) are created automatically based on your state configurations. When State B is added to the “Next Available States” list of State A, an arrow is automatically created from A to B.
The direction of arrows indicates the flow:
- The tail of the arrow is at the state where you added the transition (State A)
- The head points to the state being referenced (State B)
An arrow always appears from the Greeting Message node to whichever state is marked as the Initial State
Important guidelines
Mandatory requirements
Every conversation flow must maintain these requirements:
- At least one state must exist on the canvas
- Exactly one state must be marked as the ‘initial state’
State management rules
Configuration options
When you click on a state, the configuration sidebar opens with these options:
- Name: Provide or edit the state name
- Allowed characters:
0-9,a-z,A-Z,_,- - Must be unique across all states
- Allowed characters:
- Instructions: Enter conversation instructions in a rich text editor
- See State Instructions for detailed guidelines
- Tools: Add from a multi-select dropdown
- Variables: Add from a multi-select dropdown
- Next Available States: Add references to other states from a multi-select dropdown
- Save: Save the state’s configuration
When you click on a state, the configuration sidebar opens with these options:
- Name: Provide or edit the state name
- Allowed characters:
0-9,a-z,A-Z,_,- - Must be unique across all states
- Allowed characters:
- Instructions: Enter conversation instructions in a rich text editor
- See State Instructions for detailed guidelines
- Tools: Add from a multi-select dropdown
- Variables: Add from a multi-select dropdown
- Next Available States: Add references to other states from a multi-select dropdown
- Save: Save the state’s configuration
When clicking on Greeting Message node or Global Instructions node:
- Rich text editor for content
- Save option
Saving your changes
After making any modifications (adding, editing, or deleting states), click “Update Agent” to save your changes. The update will only be allowed if all constraints are satisfied.