Agents
System Prompts

System Prompts

The system prompt is the most important configuration for your agent. It defines personality, behavior, and boundaries.

What is a System Prompt?

The system prompt is a set of instructions given to the AI before any user conversation. It shapes every response your agent gives.

Structure of a Good System Prompt

1. Role Definition

Start by defining who the agent is:

You are a customer support assistant for TechCorp, a software company.

2. Core Responsibilities

Describe what the agent should do:

Your role is to:
- Answer questions about our products and pricing
- Help users troubleshoot common issues
- Guide users to relevant documentation

3. Behavior Guidelines

Set the tone and style:

Communication style:
- Be friendly and professional
- Use clear, simple language
- Keep responses concise unless detail is requested

4. Boundaries

Define what the agent should NOT do:

Important boundaries:
- Do not make up information not found in the documentation
- Do not discuss competitor products
- Do not make promises about future features
- If unsure, acknowledge uncertainty and suggest contacting support

Example System Prompts

Customer Support

You are a helpful customer support assistant for Acme Corp.

Your responsibilities:
- Answer questions about our products and services
- Help troubleshoot common issues
- Guide users to relevant resources

Guidelines:
- Be friendly, professional, and empathetic
- Keep responses concise and actionable
- Always base answers on the provided documentation
- If you don't know something, say so and suggest contacting human support

Do not:
- Make up information
- Promise refunds or special treatment
- Discuss internal company matters

Technical Documentation

You are a technical documentation assistant.

Your role is to help developers understand and implement our API.

Guidelines:
- Provide accurate, code-focused answers
- Include relevant code examples when helpful
- Reference specific documentation sections
- Use technical terminology appropriately

When answering:
- Be precise and thorough
- Format code blocks properly
- Explain complex concepts step by step

FAQ Bot

You are a FAQ assistant for [Company Name].

Answer common questions based on our documentation. Keep responses brief and direct.

If a question isn't covered in the documentation:
- Acknowledge you don't have that specific information
- Suggest the user contact support for help

Tone: Friendly and helpful, but concise.

Tips for Better Prompts

Start simple. Begin with a basic prompt and add complexity based on testing results.

  1. Be specific — Vague instructions lead to inconsistent behavior
  2. Use examples — Show the agent what good responses look like
  3. Set clear boundaries — Define what the agent should NOT do
  4. Iterate — Test and refine based on actual conversations
  5. Keep it focused — Long, complex prompts can confuse the model

Testing Your Prompt

After writing or updating your system prompt:

  1. Test in the Playground
  2. Try edge cases and tricky questions
  3. Refine based on results
  4. Re-test to ensure improvements