Introduction
Prompt engineering is the foundation of creating effective AI phone agents. A well-crafted prompt determines how your agent interprets situations, responds to users, and handles edge cases. This guide provides proven strategies for writing prompts that agents can follow reliably.This guide focuses on general prompt engineering principles. For agent-specific implementation:
- Single/Multi Prompt Agents: Apply these principles directly in your prompts
- Conversation Flow Agents: Use these principles within individual node instructions
Getting Started
To see examples of effective prompts, create a new agent in the Dashboard and explore our pre-built templates. These templates demonstrate best practices for various use cases.Best Practice 1: Use Sectional Prompts
Break large prompts into focused sections for better organization and LLM comprehension. This structured approach offers several benefits:- Reusability: Sections can be adapted across different agents
- Maintainability: Easy to update specific behaviors without affecting others
- Clarity: LLMs process structured information more accurately
Recommended Prompt Structure
Best Practice 2: Use Conversation Flow for Complex Tasks
When your agent needs to handle complex logic or multiple tools, consider using Conversation Flow agents instead of trying to manage everything in a single prompt.When to Switch to Conversation Flow:
- Multiple decision branches: More than 3-4 conditional paths
- Tool coordination: Using 5+ different functions/tools
- State management: Tracking multiple variables throughout the conversation
- Reliability concerns: Single prompt shows inconsistent behavior
Benefits of Conversation Flow:
- Each node focuses on one specific task
- Deterministic tool calling and transitions
- Easier to debug and optimize individual steps
- More predictable agent behavior
Best Practice 3: Explicit Tool Calling Instructions
This section applies only to Single/Multi Prompt Agents. Conversation Flow Agents handle function calls deterministically through their node configuration.
The Challenge
LLMs often struggle to determine when to call tools based solely on tool descriptions. Without explicit instructions, agents may:- Call tools at inappropriate times
- Fail to call tools when needed
- Use the wrong tool for a situation
Solution: Define Clear Triggers
Always specify exact conditions for tool usage in your prompts. Reference tools by their exact names.Example: Customer Service Agent
Best Practices for Tool Instructions
- Use trigger words: List specific words/phrases that should trigger tool calls
- Define sequences: Specify when tools should be called in order
- Set boundaries: Clarify when NOT to call certain tools
- Provide context: Explain why each tool is being called