Best practices

Effective prompt engineering requires careful thought and attention to detail. Improved structure, clarity, and precision can transform an unreliable prompt to a successful one. This guide explores proven techniques for creating consistent and reliable prompts.

The foundation: Clarity and precision

AI models interpret instructions literally, making clarity and precision essential elements of effective prompts. Consider these instructions as a technical specification - every detail matters, and ambiguity can lead to unexpected results.

Establish clear parameters

When crafting prompts, precision and specificity are crucial. It is important to clearly define what you aim to achieve, set the boundaries and limitations of your project, specify the desired output formats, and outline the criteria for measuring success.

Here are examples demonstrating effective and ineffective approaches:

❌ Ineffective Approach

✅ Effective Approach

This type of vague, unstructured prompt leads to inconsistent results and lacks the necessary parameters for reliable AI responses.

1 Hey, we need help with our customer support. Just handle whatever questions come in and try to be helpful. Make sure customers are happy and don't say anything wrong.

Critical context elements

The effectiveness of a prompt is shaped by several factors, including its overall purpose and end goals, the characteristics of the target audience, the necessary background information, and the requirements of the interaction medium.

Defining boundaries

Successful prompts require clear parameters that define measurable criteria for success, establish specific operational constraints, set any response length requirements, and prioritize key information.

Leverage common knowledge

Think about asking someone to hang a picture in your home. You wouldn’t need to explain how to use a hammer or what a nail is - that’s common knowledge. However, you would need to specify where you want the picture hung, which frame to use, and how high to place it. These specific details are crucial for achieving the desired outcome.

This same principle applies when working with AI. Like a capable assistant, AI systems come with a foundation of general knowledge. The key is understanding what information you need to provide versus what the AI already knows.

Avoid overprompting

When someone asks “Can you hang this picture?”, they assume the person understands how to use basic tools, which ones are needed, basic safety precautions, and standard hanging techniques. However, it remains essential to specify where exactly the picture should be hung, the desired height and layout, the frame to be used, and any special mounting instructions.

Similarly, when prompting an AI, you don’t need to explain:

Basic grammar and formatting
Common professional conventions
Standard writing structures
General knowledge concepts

Instead, focus on providing:

Specific requirements for your use case
Unique constraints or parameters
Domain-specific context
Special formatting needs

Examples in practice

❌ Over-prompting

✅ Balanced prompting

Including unnecessary common knowledge dilutes the important specific requirements.

1 # Role definition
2 You are the receptionist at Bright Smile Dental.
3 
4 ## Communication guidelines
5 - Use proper English and maintain professional tone
6 - Speak clearly and listen carefully to patients
7 - Be polite and courteous at all times
8 - Use complete sentences with appropriate pauses
9 - Ask clarifying questions when needed
10 - End conversations professionally
11 
12 ## Scheduling information
13 - Available appointments: Tuesday-Friday, 9 AM to 5 PM
14 - Verify patient identity:
15   * Date of birth
16   * Phone number
17 - Handle with extra care and politeness
18 - Confirm details clearly with patient
19 
20 ## Emergency protocol
21 - Listen carefully for mentions of tooth pain
22 - Understand this requires urgent attention
23 - Prioritize scheduling within 24 hours
24 - Show empathy and concern
25 
26 ## Special instructions
27 - Direct insurance inquiries politely to extension 2
28 - Explain doctor specialties clearly:
29   * Dr. Smith: Cosmetic dentistry
30   * Dr. Chen: Pediatrics
31 - Inform professionally about 90-minute new patient appointments
32 - Always end by asking if they need anything else

Structure prompts with Markdown or XML

AI Agents can interpret instructions in plain text. However, structuring your prompt in a consistent and recognizable way increases the AI Agent’s adherence to your intended structure, and embeds additional information about order, precedence, and hierarchies of content.

Rather than relying solely on bullet points, consider that a well-structured prompt is composed of several components: a clearly defined role, a comprehensive knowledge base, clear response guidelines, a precise task definition, and any necessary constraints. This integrated approach helps ensure that both humans and AI understand the intended context and desired outcomes.

Markdown and XML are both recognized by AI Agents and are appropriate for structuring prompts. This added structure helps the AI understand relationships between concepts and prioritize information appropriately.

Markdown format

XML format

test

1 # Task overview
2 Create a customer response template for common support queries.
3 
4 ## Context
5 Support team needs standardized responses for frequently asked questions.
6 
7 ## Requirements
8 - Maintain professional tone
9 - Include relevant documentation links
10 - Provide step-by-step instructions
11 
12 ## Constraints
13 - Keep responses under 200 words
14 - Use simple, clear language

If you’re not sure, pick the one you’re more familiar with.

Prompt development benefits from systematic refinement. Begin by establishing essential requirements by defining the core functionality, identifying critical components, and setting a clear baseline for success. Next, focus on testing and optimization by evaluating the prompt in various scenarios, carefully documenting response patterns, and addressing any emerging edge cases. Finally, implement quality control by resolving any contradictions, maintaining thorough version control, and continuously tracking the effectiveness of your prompt.

Avoid over-optimization. Complex prompts can impede natural interaction or cause hallucinations. Sometimes a simple prompt is more effective.

Let’s examine how iterative refinement works in practice. Below is an example showing the evolution of a prompt through several refinement stages:

Initial prompt

First refinement

Second refinement

Final version

1 Handle customer support inquiries about billing issues.