Prompt engineering
Master the craft of writing effective prompts for SignalWire AI agents
SignalWire DocsSignalWire AI Agents combine ASR, conversational intelligence, function calling, integrated RAG, and TTS, all in a powerful and easy-to use tool that is integrated with and optimized for telecommunications.
Prompts are used to design and configure an AI Agent. In addition to its primary (or “Main”) prompt, each SignalWire AI Agent has additional areas that accept prompts, like Context Steps, SWAIG Functions, Conscience, and the Post-Prompt.
Think of prompt engineering like giving detailed instructions to a new team member: for them to succeed, you need to be clear about what you want them to do, how to do it, and what boundaries to respect. A good prompt tells the AI exactly how to handle user questions, what tone to use, what information to focus on, and what topics to avoid.
You can use all these prompt engineering techniques with either SWML or the AI agent resource.
Prompt engineering isn’t just about writing instructions - it’s about crafting them in a way that gets the best results from your AI. It’s part technical skill, part creative problem-solving. The goal is to write prompts that are crystal clear and leave no room for confusion.
Here’s what goes into making great prompts:
For SignalWire users, getting prompt engineering right is crucial. It’s what turns a basic AI into a reliable team member that can handle complex customer conversations day in and day out.
The way you write your prompts makes or breaks your AI’s performance. Good prompts create AI agents that stay consistent - whether they’re talking to a first-time customer or someone who’s been around for years.
The goal is to help AI handle real conversations, understand context, manage back-and-forth discussions, and recover smoothly when things get confusing.
The impact of good prompt engineering touches everything:
The best prompts for SignalWire AI agents share some common traits that make them effective in real conversations. Here’s what to look for:
Crystal clear language - Be specific and leave no room for confusion. AI takes instructions literally, so vague language leads to unexpected results. Use concrete examples and clear directions.
Smart organization - Structure information in a way that makes sense. Use headers, subheaders, and consistent formatting to help the AI understand how everything fits together.
Flexibility - Real conversations rarely follow a script. Your prompts should help the AI handle different ways of asking questions, topic changes, and misunderstandings naturally.
Brand voice - Make sure your AI sounds like your company. This means using your terminology, keeping the right tone, and focusing on what matters to your business.
Avoid over-prompting when designing your AI agents. Excessive instructions and constraints can degrade both performance and reliability. When prompts become too lengthy or complex, the AI may struggle to prioritize information, leading to inconsistent responses and reduced effectiveness. Focus on clear, essential guidance rather than exhaustive details - this creates AI agents that respond more consistently and handle conversations with greater flexibility.
Context awareness is crucial too. Good prompts help your AI remember what was said earlier in the conversation, making sure responses make sense throughout longer interactions.
And when things go wrong? Your prompts should help the AI recover gracefully - asking for clarification when needed, offering alternatives, or steering the conversation back on track without frustrating users.
A solid prompt is like a well-organized recipe - it has all the right ingredients in the right order. Here’s how to structure your prompts for SignalWire AI agents:
Role definition forms the foundation of your prompt. Begin by establishing who your AI is supposed to be. This identity sets the tone and expertise level for all interactions. When you tell your AI “You’re a telecom support specialist with five years under your belt,” you’re giving it a clear persona to embody throughout the conversation.
Every conversation happens within a context that shapes understanding. Your AI needs critical background information to perform effectively - details about user demographics and technical knowledge, system capabilities and limitations, or relevant history that might influence the interaction. This contextual awareness prevents the AI from making inappropriate assumptions.
Response guidelines shape how your AI communicates. By defining whether you want “friendly, simple language with clear steps” or “professional but approachable, getting straight to the point,” you ensure the conversation feels natural and aligned with your brand voice. These guidelines maintain consistency across all interactions.
Finally, boundaries protect both users and your business. By clearly stating what the AI shouldn’t do - “Don’t ask for passwords,” “Don’t promise specific delivery times,” or “Don’t compare us to competitors unless asked” - you prevent potential problems while maintaining the flexibility needed for natural conversation.
Here’s a real-world example of a well-structured prompt for a pizza ordering AI:
The following diagram illustrates the above prompt in a real conversation and how it influences the AI’s responses:
This diagram demonstrates how:
Each component plays a crucial role in creating a natural, efficient ordering experience while maintaining service standards.
Follow these steps to create a basic set of prompts, then test and iterate until your agent is ready for production.
Start by establishing specific, measurable goals for your AI agent. Create a mission statement that defines its purpose, scope, and success criteria.
Gather detailed information about your audience and their experiences:
Use these audience insights to enhance your prompts and test them from different user perspectives.
This layered approach prevents prompt bloat while ensuring comprehensive coverage.
Develop a systematic testing framework:
Document all test cases and results to track improvements over time.
Make continuous improvement part of your process. Watch how real users interact with your AI, spot patterns of success and failure, and adjust your prompts accordingly. This cycle of improvement helps your AI get better and better at handling real-world situations.
Now that you’ve got the basics down, you’re ready to dive deeper into advanced prompt engineering techniques. Explore our guides on best practices, where to apply prompts, and advanced techniques.