Atlas AI Agent Testing and Customization#
Learn how to test and customize your AI agent's conversation script. In this video, you'll learn how to:Initiate a test conversation with your AI agent to understand what needs fine-tuning
Expand the script editor for a larger view and make manual edits to the conversation flow
Use dynamic variables (enclosed in double curly brackets) that can be injected into conversations
Use the generate button to provide modification instructions and automatically rewrite the script
Test the updated script immediately after making changes
Key Features Explained:#
Functions like a recording that plays at the start of every conversation
Cannot be interrupted by the caller while playing
After it completes, the conversation becomes dynamic and interruptible
A powerful tool for modifying AI agent behavior without changing the main script
Add instructions or feedback to guide how your agent responds to specific situations
Overrides information in the knowledge base (useful for temporary changes like holiday hours or special instructions)
Example use: Instruct the agent to redirect pricing questions to schedule a call with the founder
The notes section is particularly useful for quick adjustments and handling special circumstances without modifying your core knowledge base.This document will help you create effective scripts for our AI voice agents.
Following these formatting guidelines ensures optimal performance and natural conversation flow.
🧩 Basic Script Structure#
Required Elements#
✅ Waiting points for prospect responses
✅ Branching logic for different scenarios
✅ Explicit scripted lines marked with ~
Script Sections#
Line Marking#
Scripted lines that must be delivered exactly require specific formatting:~ "This is an exact script line that the AI will say word for word"
Note: The ~ symbol tells the AI this line must be delivered exactly as written.
Response Waiting Points#
After each scripted line where you expect prospect input, include:*Wait for prospect's response*
Branching Logic#
Format conditional branches as follows:[BRANCH: If prospect says X]
~ "Here is the response for situation X"
[BRANCH: If prospect says Y]
~ "Here is the response for situation Y"
Always write numbers in word form:✅ Correct: “fifty thousand dollars”
❌ Incorrect: “$50,000”
💬 Script Example#
Here’s a properly formatted script segment:## INITIAL GREETING
~ "Hi, this is Sarah from [[company_name]] Voice AI. How's your day going?"
*Wait for prospect's response*
[BRANCH: If positive response]
~ "That's great to hear! I'm reaching out because..."
[BRANCH: If negative response]
~ "I hear you. I'll keep this brief. I'm reaching out because..."
## QUALIFICATION
~ "I noticed you were looking into voice AI solutions. What sparked your interest?"
*Wait for prospect's response*
🧠 Objection Handling#
## OBJECTION HANDLING
[If prospect says "too expensive"]
~ "I understand cost is important. Actually, most of our clients see ROI within thirty days because..."
🔁 Transfer Protocols#
## TRANSFER PROTOCOL
~ "I'm going to connect you with our solutions team. Please stay on the line while I transfer you."
*Initiate transfer to department X*
⚙️ Technical Requirements#
Submit scripts in plain text or markdown
Use consistent indentation
Include clear section breaks
Character Limits#
Keep individual lines under 200 characters
Break longer statements into multiple lines
Special Characters#
Use only approved markers (~ for exact lines)
💡 Best Practices#
Keep Sentences Conversational#
Write how people speak, not how they write
Use contractions (e.g., “I’m” instead of “I am”)
Include natural speech patterns (e.g., “um,” “you know”)
Include Context Markers#
Help the AI understand the purpose of each section
Provide clear guidance for tone and delivery
🧩 Custom Variables#
| Variable | Description |
|---|
{{agentName}} | Agent Name |
{{companyName}} | Company Name |
{{industry}} | Industry |
{{firstName}} | First Name |
{{lastName}} | Last Name |
{{fullName}} | Full Name |
🧪 Testing Your Script#
Before implementing your script:1.
Read it aloud to ensure natural flow
2.
Verify all branches lead somewhere
3.
Confirm all required elements are marked with ~
4.
Check that numbers are written in word form
5.
Ensure all major objections have handling paths
🚫 Common Mistakes to Avoid#
Missing Response Wait Points#
Always include *Wait for prospect's response* after questions
Don’t stack multiple questions without wait points
Unclear Branching Logic#
Specify exact conditions for each branch
Provide clear guidance for returning to main script
Always use quotation marks for exact script lines
Maintain consistent spacing and section marking
🧭 Support and Resources#
Contact our script support team
Review our script template library
Schedule a script review session
Remember:
A well-formatted script is crucial for optimal AI voice agent performance.
Take time to verify your formatting before implementation.Modified at 2025-11-19 21:23:10