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 10 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