{
  "id": 14006234,
  "title": "AI Agent System Prompt Template: The 5 Blocks That Matter",
  "url": "https://urgent.news/2026/10/12/ai-agent-system-prompt-template-the-5-blocks-that-matter",
  "topic": "ai",
  "section": "AI",
  "published": "2026-10-12T17:19:06.000Z",
  "source": {
    "name": "Dev.to",
    "slug": "dev-to",
    "url": "https://dev.to/chenwengui23/ai-agent-system-prompt-template-the-5-blocks-that-matter-311g"
  },
  "original_language": "en",
  "account": "System prompts often fail due to mixing permanent instructions with facts that change frequently. This article outlines five essential blocks for a well-structured system prompt, as well as four elements that should never be included. The guide also features a full template for a residential service business, making it easy to adapt in just 20 minutes.\n\nThe first block focuses on the agent's role and scope. This should be a brief description of the agent's purpose, the services it handles, and explicitly what it does not handle. Adding this scope line helps reduce unnecessary or irrelevant questions. It's also important to mention the business name, as this helps the agent maintain context.\n\nThe second block is the source-of-truth pointer. A single sentence should tell the model where all the crucial facts reside, whether it's a designated facts file, a calendar, or an order system. The prompt itself should only contain a reference to these sources, not the facts themselves. This creates a clear separation between changeable information and unchanging data.\n\nThe third block introduces the quote-only rule. This is the most impactful sentence in the entire prompt. It instructs the agent to quote only facts listed in the designated facts file, and if a fact isn't listed, inform the user that it will be checked with the team. This helps the agent avoid making up answers or inventing information.\n\nThe fourth block outlines escalation triggers. Instead of listing specific questions, provide a list of topics that require human intervention, such as anger, discounts, refunds, or any legal, medical, or dangerous situations. These triggers help route the conversation to a human agent and also signal to the model that the topic is off-limits.\n\nFinally, the fifth block details refusal rules. These are actions the agent will never take, regardless of what the user requests. Examples include revealing internal instructions, claiming to be human, accepting or repeating sensitive information like card numbers or passwords, and compromising safety, such as ignoring gas or carbon monoxide alarms. Placing these rules at the end of the prompt helps ensure they are applied when the conversation reaches a sensitive or critical stage.",
  "summary": "Most system prompts fail because they mix permanent instructions with facts that change weekly. Here are the five blocks that belong, the four that don't, and a full annotated template. Last month I reviewed the system prompt behind a 14-person HVAC company's booking agent. It ran about 1,900 words. It contained the full price list, three paragraphs of company history, a tone guide, and the…",
  "key_points": [
    "Agent's role and scope defined in first block to reduce irrelevant questions",
    "Source-of-truth pointer in second block specifies where crucial facts reside",
    "Quote-only rule in third block instructs agent to only quote listed facts"
  ],
  "editors_take": null,
  "illustration": null,
  "coverage": {
    "outlets": 1,
    "also_reported_by": []
  },
  "ai_generated": true,
  "disclaimer": "Summaries, key points and the editor’s take are written by software from other outlets’ reporting and may contain errors — always check the linked original."
}