You want to tailor Copilot agents to respond consistently with your company voice, enforce specific business rules, or restrict topics. Without custom system instructions, agents rely on general Microsoft Graph data and generic behavior, which can produce vague or off-brand answers. Custom system instructions let you define the agent persona, tone, data scope, and response boundaries directly in the Copilot Studio editor. This article explains how to create and apply those instructions step by step, including prerequisites and common configuration mistakes.
Key Takeaways: Configuring Custom System Instructions for Copilot Agents
- Copilot Studio > Agents > System Instructions: The exact location where you define the agent persona, tone, and response rules.
- Microsoft Graph data sources toggle: Controls whether the agent can reference tenant SharePoint, OneDrive, and Exchange content in its responses.
- Instruction length limit of 2,000 characters: Hard cap enforced by Copilot Studio; longer instructions are truncated silently.
What Are Custom System Instructions for Copilot Agents
Custom system instructions are a set of rules and context that you write in natural language and attach to a Copilot agent in Copilot Studio. These instructions act as the agent’s permanent behavior baseline, overriding generic defaults. The agent reads these instructions before processing any user query, which means the tone, allowed topics, data sources, and response format are all controlled from one location.
Prerequisites for using custom system instructions include a Microsoft 365 license that includes Copilot for Microsoft 365, a Copilot Studio license (standalone or bundled), and the Agent Author or System Administrator role in Copilot Studio. You do not need developer skills or code. The instructions are plain text with optional Markdown formatting for headings and lists.
The system instructions field supports up to 2,000 characters. This limit applies to the combined text of all rules you write. Instructions longer than 2,000 characters are truncated automatically, which can break rules you intended to enforce. Plan your instructions to fit within this limit.
Steps to Add Custom System Instructions to a Copilot Agent
The following steps assume you have already created a Copilot agent in Copilot Studio or are using an existing agent. If you are starting from scratch, create a new agent first by selecting Agents > New agent in Copilot Studio.
- Open your agent in Copilot Studio
Go to Copilot Studio and sign in with your work or school account. Select Agents from the left navigation, then click the name of the agent you want to configure. The agent overview page opens. - Navigate to the System Instructions section
In the agent overview, select the Settings tab. Scroll down to the Advanced section. Click System instructions. A text editor panel opens. - Write your custom instructions
In the text editor, type the rules and context for your agent. Use clear, direct sentences. For example: “You are a customer support agent for Contoso Ltd. Respond in a professional tone. Only answer questions about Contoso products listed in the company SharePoint site. Do not speculate about pricing or release dates.” You can use Markdown for structure but keep the total text under 2,000 characters. - Configure data sources for grounded responses
Below the instructions field, locate the toggle for Microsoft Graph data sources. Turn this toggle on if you want the agent to search your tenant’s SharePoint, OneDrive, and Exchange content for answers. Turn it off if you want the agent to rely only on its internal knowledge and your custom instructions. This toggle is independent of the system instructions text. - Save and test your agent
Click Save at the top of the panel. Return to the agent overview and select Test. Type a sample query that should trigger your custom rules. For example, if you banned pricing speculation, ask “What will the next product cost?” and verify the agent refuses to answer. Adjust the instructions if the response does not match your rules.
Common Mistakes to Avoid When Writing System Instructions
Instructions are too vague or generic
Writing “Be helpful” or “Answer accurately” does not change agent behavior because those are default expectations. Instead, specify exact behaviors: “Do not mention competitors by name” or “Always start responses with a greeting.” Test each rule with a query that would violate it.
Instructions exceed the 2,000 character limit
Copilot Studio truncates instructions silently when the limit is exceeded. After truncation, the last rules you wrote may be cut off. To check the length, paste your instructions into a character counter tool before saving. If you need more space, consolidate rules by combining related items into single sentences.
Data source toggle is set incorrectly
The Microsoft Graph data sources toggle and the system instructions field are independent settings. If you turn off Graph data but your instructions tell the agent to “search the company SharePoint,” the agent will attempt to comply and return an error or empty response. Ensure the toggle matches the behavior you describe in the instructions.
Instructions conflict with each other
Writing “Respond in formal language” and then “Use casual greetings like Hey” creates a conflict. The agent may follow one rule inconsistently. Review your instructions for contradictory directives and remove or merge them.
Copilot Agent With Custom Instructions vs Default Agent: Key Differences
| Item | Custom Instructions Agent | Default Agent |
|---|---|---|
| Response tone | Defined by your instructions (formal, casual, technical) | Generic assistant tone based on base model |
| Topic restrictions | You specify allowed and blocked topics | No topic restrictions beyond safety filters |
| Data source control | Independent toggle for Graph data plus instruction-based rules | Graph data toggle only, no instruction layer |
| Persona consistency | Fixed persona across all sessions | Persona varies by user query context |
| Character limit for rules | 2,000 characters | Not applicable |
The custom instructions agent gives you precise control over responses. The default agent is simpler but cannot enforce business-specific rules without external prompt engineering.
You can now configure any Copilot agent in Copilot Studio with custom system instructions that define its tone, data scope, and behavior. Test each rule with a violating query to confirm enforcement. As a next step, try adding a second agent with different instructions for a separate department, such as HR policies versus IT support. To avoid truncation, always verify your instruction length stays under 2,000 characters before saving.