Configuring Agents
In One Sentence
Configuration encompasses everything that defines your agent's core identity, conversational style, standing compliance rules, and voice settings before you publish and deploy.
Why It Exists
Every customer interaction should consistently reflect your organization's voice and adhere to company policies. The configuration panel allows you to craft your agent's persona, establish non-negotiable rules, and fine-tune response pacing in one place.
Configuration Tabs
Inside the Agent Builder, your agent's settings are organized across focused configuration tabs:
- General: Agent name, communication type (
Voice Agent,Chat Agent), and operating timezone. - Brand & Personality: Company name, agent identity name, conversational tone profile, formality, pacing, greetings, sign-off, and sentiment analysis toggle.
- Voice & Call Behavior (Voice Agents): Spoken voice model selection, audio preview player, silence inactivity check-ins, auto hang-up, and SIP call transfer destinations.
- Prompt & Rules: Split-view editor managing the core System Prompt (up to 20,000 characters) and Behavioral Rules (title up to 100 characters, description up to 20,000 characters).
- Scenarios: Playbook workflows with scenario titles (up to 100 characters), short descriptions (up to 300 characters), and scenario prompt instructions (up to 4,000 characters).
- Integrations: Multi-select grids to attach organization API Tools and Knowledge Bases.
- Review & Submit: Validation summary checklist verifying all configuration fields before saving or updating.
General Configuration
| Field | Requirement | Options / Guidance |
|---|---|---|
| Agent Name | Required | Unique name identifying your agent (e.g., Support Assistant). |
| Agent Type | Required | Select Voice Agent (low-latency voice synthesis & telephony) or Chat Agent (text-based conversational AI). |
| Timezone | Required | The operating timezone used for temporal lookups and date calculations (default: UTC). |
General configuration tab showing Agent Name, communication type selection (Voice vs. Chat), and operating timezone.
Brand & Personality
The Brand configuration defines persona identity and conversation style:
| Setting | Type / Limit | Options & Guidance |
|---|---|---|
| Company Name | Optional text | The organization the agent represents (e.g., Acme Corp). |
| Agent Identity Name | Optional text | Persona name used by the agent in dialogue (e.g., Aria). |
| Languages | System default | Currently configured for English. |
| Tone Profile | Select dropdown | Empathetic & Professional (default), Friendly & Casual, Formal Business, Concise & Direct. |
| Pacing | Slider (0.5x to 2.0x) | Controls speech cadence for voice calls and conversational timing (default: 1.0x). |
| Formality | Slider (3 steps) | Choose between Casual, Balanced (default), or Formal. |
| Custom Greeting | Optional textarea | Opening greeting sent when a customer session starts. |
| Custom Sign-Off | Optional textarea | Closing message sent when an issue is resolved. |
| Sentiment Analysis | Toggle switch | Enables real-time customer tone monitoring and escalation tracking. |
Brand & Personality configuration tab showing tone profile selection, pacing and formality sliders, greetings, and sentiment tracking.
Voice & Call Behavior (Voice Agents Only)
For telephony-enabled Voice Agents, the Voice tab controls voice synthesis, inactivity recovery, and live call transfers:
1. Voice Synthesis & Identity
- Voice Identity: Select from the organization's voice catalog (e.g., Allison, Jenny, Guy) featuring accent, gender, and language tags.
- Voice Sample Preview: Built-in interactive audio player to test speech tone and pronunciation before saving.
2. Silence Check-ins & Auto Hang-up
- Silence Timeout: Number of seconds of customer silence before prompting (1–1,000s, default:
15s). - Grace Seconds Before Hang-up: Grace buffer after final message before ending call (0–300s, default:
20s). - Check-in Phrases: Ordered list of check-in prompts (e.g., "Hey, are you still there?", "Checking in one more time. Are you able to hear me?").
- End Call on Final Check-in: Checkbox to automatically disconnect idle callers after the last phrase with a customizable goodbye message.
3. Call Transfer & Forwarding
- Transfer Mode:
Blind Transfer(instant carrier handoff via SIP REFER). - SIP Verb:
SIP REFER. - Dial Timeout: Maximum seconds to ring the destination before failing back (1–600s, default:
60s). - Transfer Destinations: Add telephone numbers in E.164 format with clear routing descriptions (e.g.,
+18005550199- "Transfer here when caller requests billing supervisor or dispute escalation"). The AI reads the routing description to trigger transfers autonomously.
Voice & Call Behavior tab showing Voice Profile identity selection, accent/gender tags, and audio sample preview.
Silence inactivity check-in rules, auto hang-up triggers, and SIP call transfer destinations table.
Prompt & Rules
The Prompt & Rules tab features a split-view workspace to manage global agent instructions:
System Prompt
- Character Limit: Up to 20,000 characters.
- Role: Free-form role definition, background context, company mission, and overarching personality guidelines.
System Prompt editor view showing global persona instructions and character limit tracker.
Rules
- Rule Title: Short descriptive policy header (up to 100 characters).
- Rule Description: Strict, non-negotiable compliance rules (up to 20,000 characters).
- Enforcement: Rules are strictly validated and enforced across every turn of conversation regardless of customer intent.
Behavioral Rules management view showing rule policies, enforcement descriptions, and the Add Rule action.
Scenarios (Playbooks)
The Scenarios tab allows you to configure guided conversation workflows and specialized playbooks directly within the agent builder:
- Scenario Title: Descriptive name for the playbook (up to 100 characters).
- Trigger Description: Context keywords and customer intents that activate this workflow (up to 300 characters).
- Scenario Prompt: Step-by-step instructions, questions to ask, and tool execution logic (up to 4,000 characters).
Scenarios configuration tab showing guided playbook workflows, intent triggers, and playbook instructions editor.
For detailed instructions on crafting scenario prompts and runtime intent routing, check the Scenarios & Routing guide.
Integrations (API Tools & Knowledge Bases)
In the Integrations tab, attach shared resources using interactive card selectors:
1. API Tools
Grid of all organization-configured API tools displaying HTTP method (GET, POST), endpoint URL, and descriptions. Select cards to permit the agent to query external business APIs during conversations.
Integrations tab showing selectable API Tool cards and active attachment status.
2. Knowledge Bases
Grid of all organization knowledge bases displaying document entry counts and descriptions. Select cards to allow the agent to perform semantic document retrieval during interactions.
Integrations tab showing selectable Knowledge Base libraries and document count badges.
Review & Submit
The Review & Submit tab provides an automated pre-flight audit checklist:
- Validates that required fields (Agent Name) are populated.
- Checks character limits across System Prompt, Rules, and Scenarios.
- Displays summary counts of attached API Tools and Knowledge Bases.
- Highlights specific validation errors or informs you if no changes were made in edit mode.
- Click Save (or Update) to commit your agent configuration.
Review & Submit tab showing the pre-flight checklist, validation status, attached resources summary, and Save action.
Next Steps
Explore Scenarios & Playbooks to learn how to create guided workflows and structured playbooks for specific customer intents.