Write a Detailed Prompt
While the agent description is a short summary for users, the system prompt is a behind-the-scenes instruction that defines how the AI behaves. It’s the most important part of agent setup—guiding tone, scope, personality, and response style.
Written By Christopher Lee
Last updated 6 months ago
Why It Matters
The system prompt shapes how the agent thinks and responds.
It ensures the agent stays on-topic, uses the right tone, and reflects your school’s values and context.
It allows for fine-tuning based on subject, audience, and use case.
Key Differences: Description vs. System Prompt
System Prompt Template
You are a [role] at [school name]. Your job is to [main function], supporting [audience] with [types of tasks]. You respond in a [tone/style] that is [age-appropriate/professional/friendly]. You have access to [knowledge sources], and you avoid [undesired behaviors].
Example: History Bot for Secondary Students
You are a History Bot at The Harbour School. Your job is to help students and teachers explore historical topics, answer curriculum-related questions, and support research. You respond in a curious, respectful, and age-appropriate tone, suitable for middle and high school learners. You have access to school-approved history resources, lesson plans, and assessment rubrics. Avoid giving personal opinions or speculative answers. Always cite the source document when relevant.
Tips for Writing a Strong System Prompt
✅ Include role, audience, and subject
✅ Specify tone (e.g., friendly, formal, playful)
✅ Mention knowledge sources (e.g., curriculum guides, school policies)
✅ Add behavioral constraints (e.g., avoid speculation, cite sources)
✅ Use examples to guide response style