Fix Common Agent Settings Issues with This Guide
If your AI agent isn’t responding correctly, isn’t following prompts, or is facing scheduling issues, this troubleshooting guide will help you identify and fix common settings problems efficiently.
✔ Step-by-step solutions for AI agent errors
✔ Fix issues with prompts, voice settings, and call actions
✔ Use the "Test Your Agent" feature to refine AI behavior
✔ Know when to contact Awaz.ai support
📌 Need help optimizing prompts? Check out our Fine-Tuning Agent Prompts Guide.
Follow This Step-by-Step Troubleshooting Checklist
If you’re experiencing issues with AI agent settings, use this checklist to diagnose and resolve problems quickly.
🔹 AI Not Responding or Acting Incorrectly
✔ Check if the agent is active – Go to Agents > Edit the Agent and ensure it’s properly configured.
✔ Review Freestyle Prompting – The AI might not have clear enough instructions in its prompt settings.
✔ Use the "Test Your Agent" feature – Run test calls to simulate different interactions and analyze AI responses.
✔ Modify and update prompts based on test results – This also trains the AI model to improve future responses.
💡 Tip: The more real-world scenarios you test, the better the AI adapts to customer interactions.
🔹 Voice or Tone Not Matching Expectations
✔ Go to Voice Settings in Agent Settings > Edit Agent.
✔ Adjust tone, speaking pace, and backchanneling options.
✔ Ensure boosted keywords are set for proper pronunciation of unique names or terms.
📌 Want to adjust AI speech? Read our Adjusting Tone & Speaking Pace Guide.
🔹 Call Scheduling Issues
✔ Ensure a calendar is linked in the Calendar section of the menu.
✔ Verify that the agent has scheduling actions enabled under Agent Settings > Actions.
✔ If using Zapier, check that triggers are correctly set for scheduling workflows.
🔹 AI Not Following Scripts or Skipping Parts of Conversations
✔ Check prompt clarity – Ensure prompts direct the AI properly without ambiguity.
✔ Test AI responses using the "Test Your Agent" feature.
✔ Refine the Freestyle Prompt with specific conditions like:
"If the user declines, offer a follow-up question instead of ending the call."
✔ Re-test and modify prompts until responses are aligned with expectations.
🔹 Call Transfers Not Working Properly
✔ Verify that call transfers are enabled in Actions settings.
✔ Ensure the right phone number is set for human agent transfers.
✔ Test call routing with different scenarios to confirm proper redirection.
📌 Want to improve AI call handling? Read our Customizing Agent Behavior for Outbound Calls Guide.
When in Doubt, Contact Support
If issues persist despite troubleshooting, reach out to Awaz.ai support for assistance.
📧 Support Email: [email protected]
📖 Help Center: Visit our knowledge base
📺 Tutorial Videos: Watch step-by-step guides
💡 Tip: When contacting support, include details like error messages, screenshots, and steps already taken to help resolve the issue faster.