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

Aspect

Agent Description

System Prompt

Length

~20 words

100–300 words

Audience

Human users

AI model

Purpose

Set expectations

Define behavior

Tone

Public-facing

Instructional

Detail Level

Basic role and scope

Deep context, tone, examples, constraints


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