Agent Prompt Design

Agent Prompt Design

Process

Phase 1: Gather Requirements

Collect the following before drafting:

Required:

• Agent's purpose and role (what it does)
• Available tools and their capabilities
• Primary tasks the agent should perform

If improving an existing prompt:

• Current prompt text
• Specific failures or problems observed
• Example queries that don't work well

Phase 2: Draft the Prompt Structure

Build the prompt with these five components in order:

2.1 Role Definition

Write 1-2 sentences establishing identity and function.

You are a [role] that [primary function]. Your goal is to [main objective].

2.2 Dynamic Content Section

Add placeholders for context that will be injected at runtime. Focus on domain-specific data the framework won't provide automatically:

## Current Context
- User: {{user_name}}
- Account type: {{account_tier}}
- Permissions: {{user_permissions}}

Note: Conversation history and tool definitions are typically handled by the framework—don't include them unless the system requires manual injection.