AI Knowledge & Logic

System Prompt

Every section of the instructions your AI agent reads before it replies, in order: where each comes from, and the expert sections you can edit directly.

Before every reply, your AI agent reads its system prompt: a fixed sequence of sections that together say who it is, how to behave and what it knows about this conversation. Settings -> Automation -> System Prompt lists every section in that order and shows where each one comes from.

Most sections come from other settings or are built in, so this page is mainly for understanding why the AI agent behaves the way it does. The sections you can edit here start from tuned defaults and rarely need changing. Try the writing style, bot rules and workflows first.

For how the AI agent uses its prompt and tools, see the Bot Operating Model.


The sections, in order

#SectionComes from
1TaskEdited here
2Time & ChannelBuilt in: conversation start, current time and the customer's channel
3SafetyEdited here
4Internal confidentialityBuilt in
5Instruction followingEdited here
6Tool callingEdited here
7Customer attachmentsBuilt in: how to read images and files
8How to writeWriting style, plus output syntax edited here
9Business descriptionEdited here
10Additional rulesBot rules
11WorkflowsWorkflows
12ArticlesKnowledge base
13HandoffHandoff settings, when the AI agent keeps answering after a handoff
14Social media pageBuilt in, for Messenger and Instagram DMs
15Customer EmailBuilt in, when known
16Previous conversationsBuilt in, when the customer's email is known
17Customer PhoneBuilt in, when known
18Browser HistoryBuilt in, for Octocom web chat
19Recently viewed productsBuilt in, when product sync is set up
20ProductsBuilt in, from the synced catalog
21Custom instructionsYour Python prompt section

Sections with nothing to say for a conversation are left out. For example, Additional rules is missing when the business has no bot rules for the customer's channel.


The sections you can edit here

Each one shows Default or Customized. Your text replaces the default; it doesn't add to it. For Safety and Instruction following that means you are now responsible for the guardrails the default provided, so carry over what you still need. Reset to default brings the default back.

Task

Who the AI agent is: a customer service agent for your business, and how it answers whether it is an AI. The default names your business, or leaves it unnamed when the business is anonymized. Your own text does neither, so only replace it when you need to rewrite that foundation.

Safety

The guardrails it always keeps: staying on topic and not making commitments the business hasn't approved.

Instruction following

Which sources of truth win, for example that workflow instructions outrank articles.

Tool calling

How and when the AI agent uses tools. The default adapts to your live workflows on the customer's channel (embedded or loaded on demand) and is left out when there are none. Your own text is used on every channel and replaces that adaptation, so a bad override can stop the AI agent from calling tools correctly.

Output syntax

The formatting rules for replies: markdown, no raw HTML, no tables. Web chats that show widget elements also get the chat window rules, which win where the two disagree. Change it only when your channel has specific rendering limits.

Business description

A short overview of your company, as context for every reply. It's empty by default and left out until you write one. Keep it an overview: the AI agent searches your catalog and knowledge base on demand, so a product list here only makes every prompt longer.

Custom instructions (Python)

Python you write once per business. It runs on every reply and adds its result as the last section. Editing it needs permission to edit automations. See Custom System Prompt Sections.


See the prompt behind a reply

The settings show how the prompt is built for a business. To see the exact prompt a reply used, with every section filled in for that conversation, ask Copilot to show the system prompt of that message (get_response_system_prompt).


Managing

  • In the dashboard: Settings -> Automation -> System Prompt.
  • With Copilot or MCP: get_system_prompt returns every section in order with its source, the text of the editable sections and systemPromptSectionCode. update_system_prompt patches them: send a text to override a section, null to reset it, or leave it out to keep it. Code supports targeted edits.
  • With the REST API: GET and PATCH /rest/v1/system-prompt, with the same fields. Sending systemPromptSectionCode needs the automations:write scope.
FieldSection
taskTask
safetySafety
instructionFollowingInstruction following
toolCallingTool calling
outputSyntaxHow to write: output syntax
businessDescriptionBusiness description
systemPromptSectionCodeCustom instructions (Python)

Reads return the text the AI agent uses, and customizedFields lists the sections your business set. Every change is recorded in the configuration history.

On this page