Skip to main content
A system prompt is the foundation layer. It runs before every user interaction and defines the AI’s core behavior, capabilities, guardrails, and response format for the entire session. Everything else: personas, contexts, prompts, skills operates within the rules the system prompt sets. Use a system prompt when you are defining the agent capabilities, purpose and need consistent, enforced behavior across every interaction. Customer support bots, coding assistants, autonomous agents, etc.

What goes in a system prompt

Tips

  • Define the structure: role -> rules -> constraints -> examples.
  • Define output format explicitly. If you need it to return JSON, write it explicitly with example outputs.
  • Include error-handling instructions: what should the AI say when it doesn’t know?
  • Test with adversarial inputs (prompt injections) to find edge cases your system prompt doesn’t handle.
  • System prompts are the highest-trust context — keep them tight and deliberate.

API value

"assetType": "system_prompt"
Note the underscore: the API value is system_prompt, not systemPrompt.

Example

{
  "name": "Customer support agent",
  "assetType": "system_prompt",
  "content": "
  You are a customer support agent for Versuno.

  Your job is to help users resolve issues with the Versuno platform.

  You are helpful, concise, and professional.

  Only answer questions related to Versuno — redirect off-topic questions directly.

  When you don't know the answer, say so clearly and offer to escalate.

  Always respond in plain text, no markdown, no json, no xml.
  "
}