M365 Agent Builder Helper

Figure out what you CAN build, HOW to build it, and WHEN to graduate to Copilot Studio

75 scenarios evaluated ☕ Support

Start Here: What do you want to build?

What data does your agent need?

Who will use this agent?

Does your agent need to take actions?

Filter:
📋 HR FAQ Bot Answer employee questions from SharePoint HR docs ✓ Yes
🛠️ IT Help Desk Agent Troubleshoot common issues from uploaded IT guides ✓ Yes
💼 Sales Playbook Quick access to pricing, objection handling, competitor info ✓ Yes
👋 Onboarding Assistant Help new hires find policies, processes, and contacts ✓ Yes
🔍 Research Assistant Search the web for any topic — no org data needed ✓ Yes
🌐 Public Website Helper Answer questions from up to 4 specific web pages ✓ Yes
📊 Data Analysis Assistant Generate charts, run calculations, analyse uploaded data ✓ Yes
📧 Email Finder Search and summarise across your entire Outlook mailbox ✓ Yes
🧠 Meeting Memory Bot Recall discussions from specific Teams chats and meetings ✓ Yes
📅 Meeting Prep Agent Summarise relevant emails and past context before meetings ⚠ Partial
💬 Customer Support Bot External-facing chatbot for customers on your website ✗ Studio
⚙️ Approval Workflow Multi-step approval process with email notifications ✗ Studio
🔗 External API Integration Connect to Salesforce, ServiceNow, or custom REST APIs ✗ Studio
🔔 Proactive Notifications Alert users when new content is published or conditions are met ✗ Studio
🏢 Multi-Source Enterprise Bot Combine SharePoint + email + Teams + connectors in one agent ⚠ Partial
Try the Agent Builder Simulator

Experience the Agent Builder workflow without leaving this page.

0 / 8,000
Step 1 of 5

Which licence tier do I need?

Free is enough if you only need:
  • Web search / public URLs
  • Code interpreter & charts
  • Image generation
No admin action needed
Pay-as-you-go if you also need:
  • SharePoint files & sites
  • Upload documents
  • Copilot connectors
  • Share with others
Ask admin to enable pay-as-you-go billing
Licensed if you also need:
  • Outlook email search
  • Teams chats & meetings
  • People / org chart data
  • Full Enterprise Graph
Ask admin for M365 Copilot licence

Full Capability Matrix

Last verified: April 2026 · MS Learn source

CapabilityFreePAYGLicensedNotes
Web search knowledge
Ground agents in public web content
Scoped web search (up to 4 URLs)
Add specific public URLs — max 2 levels deep, no query parameters
Code interpreter
Generate charts, analyse data, run calculations in-conversation
No licence required
Image generation (DALL-E)
Create images within agent conversations — when enabled by admin
No licence required
SharePoint knowledge
Ground agents in SharePoint sites, folders, and files — respects existing permissions
Upload files (up to 20)
Upload documents from your device — doc, docx, pdf, pptx, txt, csv, xlsx supported
M365 Copilot connectors
Connect to additional data sources configured by your admin (ServiceNow, Salesforce, etc.)
Share with organisation
Share agents with specific users, security groups, or everyone in org
Outlook email knowledge
Ground agents in your entire mailbox — cannot scope to specific folders
Licence only — pay-as-you-go does NOT work
Teams chat & meeting knowledge
Ground agents in Teams chats, channels, and meeting transcripts (up to 5 chats)
Licence only — pay-as-you-go does NOT work
People knowledge
Access people profiles, org chart, and directory information
Licence only — pay-as-you-go does NOT work
Enterprise Graph grounding
Full access to M365 data — files, emails, calendar, Teams, people
Licence only — the sum of email + Teams + people
Copy to Copilot Studio
Move your agent to Copilot Studio for advanced capabilities

Agent Builder vs Copilot Studio

FeatureAgent BuilderCopilot Studio
Coding requiredNone — natural language onlyLow-code / no-code
Build time5–15 minutesHours to days
Where to buildmicrosoft365.com/chat or Teamscopilotstudio.microsoft.com
Knowledge sourcesM365 data (SP, email, Teams, web, files)M365 + Dataverse + external APIs + custom
Actions & automationNo — Q&A onlyYes — Power Automate, HTTP, connectors
External API callsNot supportedHTTP actions, API plugins
Proactive messagingNo — user must start conversationYes — event triggers, scheduled messages
Conversation branchingSimple Q&A flowComplex topic trees with conditions
Deployment channelsM365 Copilot + Teams onlyTeams, web, Facebook, SMS, custom
Customer-facingInternal org onlyInternal + external customers
SharingShare link within orgTeams app store, managed deployment
CostIncluded with M365 / pay-as-you-go$200/tenant/month (25k messages)
AI modelGPT-4o (managed by Microsoft)GPT-4o + custom model options
Block general AI knowledgeCan prioritise but not fully blockFull control over knowledge scoping
Copy between platformsCopy TO Copilot Studio ✅Cannot copy back to Agent Builder

What Does It Cost?

FreeIncluded

Web search, public URLs, code interpreter, image generation, basic instructions

No additional cost — included with any M365 licenceNo admin action needed
Pay-as-you-goPer Copilot credit

Everything free + SharePoint, file uploads, connectors, sharing

Organisation pays per credit consumed — billed to Azure subscriptionAdmin must enable pay-as-you-go billing in M365 Admin Centre
LicensedPer user/month

Everything pay-as-you-go + email, Teams, people, Enterprise Graph

Per-user M365 Copilot add-on licence assigned by adminAdmin assigns licence to individual users

Quick Reference — All Limits

Last verified: April 2026 · MS Learn source

Instructions8,000 charactersDon't fill all 8,000 — focused instructions work better
Public URLs4 (max 2 levels deep)Most Learn URLs are rejected — download as .txt instead
SharePoint filesUp to 100Some docs say 20 sources overall — test your specific limits
Uploaded files20Max 512MB for doc/pdf/pptx/txt; 30MB for xlsx
Teams chats5 specific chatsScoping to specific chats improves accuracy
EmailsAll or nothingCannot scope — use instruction guidance to focus
Supported formats.doc .docx .pdf .ppt .pptx .txt .csv .xlsx.md NOT supported — rename to .txt

Which knowledge source should I use?

Detailed Source Guide

🌐Public Website URLs4 URLsFree or Paid

Add specific public websites as knowledge. The agent can answer from page content.

Rules and Limits

  • Maximum 4 URLs per agent
  • URLs must be maximum 2 levels deep (e.g. example.com/docs/guide)
  • URLs cannot contain query parameters (e.g. ?id=123)
  • URLs must be publicly accessible — no login-required pages

Tips

  • Choose content-rich pages rather than navigation pages
  • Microsoft Learn URLs are typically 4-5 levels deep and WILL be rejected — download as .txt instead
  • Use the 'Search all websites' toggle for broader web grounding beyond your 4 URLs
  • Test every URL in Agent Builder before relying on it

Gotchas

  • Most Microsoft Learn article URLs are too deep (4-5 levels) and will be rejected
  • Agent Builder doesn't always show a clear error — the URL may silently not be added
📂SharePoint ContentUp to 100 filesPay-as-you-go or Paid

Ground your agent in SharePoint sites, folders, and files. The most powerful knowledge source for enterprise agents.

Rules and Limits

  • Up to 100 SharePoint files per agent (per current Microsoft Learn docs)
  • Some documentation references a broader '20 knowledge sources' limit — try adding more files within existing folders if you hit a limit
  • Agent respects existing user permissions — users only see files they have access to
  • Sensitivity labels on files carry over to agent access
  • Restricted SharePoint Search blocks SharePoint as a knowledge source

Tips

  • Add specific folders rather than entire sites for more accurate answers
  • Keep documents concise — short, well-structured files work better than massive ones
  • Excel works best with data in ONE sheet within a workbook
  • Communication sites may not appear in the picker — try 'More Places' or enter URL directly
  • 3 ways to add: Enter URL, file picker (cloud icon), or search bar

Gotchas

  • New SharePoint sites can take HOURS to appear in the file picker
  • New files take several minutes to index — 'Preparing' status shown until ready
  • Excel files need 'Generate docs' capability enabled just to READ them
📎Uploaded (Embedded) Files20 filesPay-as-you-go or Paid

Upload files from your device. These become embedded in the agent and available to anyone with access.

Rules and Limits

  • Maximum 20 files per agent
  • Files take 1-2 minutes to upload (shown as grey until ready)
  • Information Barriers (IB) NOT supported — anyone with agent access sees all embedded content
  • Highest sensitivity label from any file applies to the whole agent

File Size Limits

FormatMax Size
.doc, .docx512 MB
.pdf512 MB
.ppt, .pptx512 MB
.txt512 MB
.xls, .xlsx30 MB
.csv150 MB

Tips

  • Use .txt or .docx for best results — Markdown syntax in .txt is still readable by AI
  • .md files are NOT supported — rename to .txt
  • Remove files with restrictive sensitivity labels to avoid blocking users
  • Upload curated reference docs rather than raw data dumps

Gotchas

  • Files with user-defined permissions cause agent creation to fail SILENTLY
  • Double Key Encrypted files embed but aren't used as knowledge (no error shown)
  • Uploading ONE Confidential file makes the whole agent require Confidential access
  • Password-protected files show an error message
💬Teams Chats & Meetings5 specific chatsM365 Copilot licence only

Ground your agent in Teams chats, channels, and meeting transcripts.

Rules and Limits

  • Select up to 5 specific chats (channels, group chats, meeting chats)
  • Or select 'My Teams chats and meetings' for ALL your chats and transcripts
  • Cannot scope to individual meetings when using 'all' option
  • Very long transcript histories may not be fully available

Tips

  • Scoping to specific chats improves accuracy significantly
  • Channel conversations work great for project-specific agents
  • Meeting transcripts create powerful 'meeting memory' agents

Gotchas

  • Requires M365 Copilot paid licence — not available on free tier
  • The 'all' option searches everything including personal chats
📧Outlook EmailAll or nothingM365 Copilot licence only

Search, summarise, and answer from your Outlook mailbox. Cannot scope to specific folders.

Privacy: When you share an agent with email knowledge, each user who uses the agent accesses THEIR OWN mailbox. Your emails are NEVER exposed to other users.

Rules and Limits

  • Adds ALL email in your mailbox as knowledge — cannot filter
  • Cannot scope to specific folders, senders, or date ranges
  • When shared, each user sees THEIR OWN emails — not yours
  • Requires M365 Copilot paid licence

Tips

  • Great for 'What did I discuss about project X?' type questions
  • Use instructions to focus: 'Only search emails related to Project Alpha'
  • Consider SharePoint/Teams as alternatives if you don't need email-specific data

Gotchas

  • Personal emails are included — be aware in professional contexts
  • No way to exclude specific folders or date ranges
  • All-or-nothing can lead to noisy results — use instruction guidance
🔌M365 Copilot ConnectorsAdmin-controlledPay-as-you-go or Paid

Connect to additional data sources configured by your admin.

Rules and Limits

  • Must be enabled by your organisation's administrator
  • Available only with M365 Copilot paid licence
  • Configured in the M365 Admin Centre

Tips

  • Ask your IT admin if connectors are available in your tenant
  • Common connectors include ServiceNow, Salesforce, and custom APIs

Gotchas

  • Not visible in Agent Builder if admin hasn't enabled them
🔍Web Search ToggleOn/OffFree or Paid

When enabled, your agent can search the public web beyond your specific knowledge sources.

Rules and Limits

  • Toggle 'Search all websites' on the Configure tab
  • Searches public web — not org-specific data
  • Can be combined with other knowledge sources

Tips

  • Enable for agents that need up-to-date information
  • Disable for agents that should ONLY answer from org knowledge
  • Use instructions to prioritise: 'Check uploaded documents first, only search web if not found'

Gotchas

  • Web results may override your curated knowledge if not managed via instructions

Before You Start — Admin Dependencies

Many Agent Builder features depend on admin settings. If something isn't working, check these first.

Agent Builder access

Users need access to microsoft365.com/chat or Teams desktop

No special admin action — available to all M365 users by default
Pay-as-you-go billing BLOCKER

Required for SharePoint, file uploads, connectors, and sharing

M365 Admin Centre → Copilot → Settings → enable pay-as-you-go billing via Azure subscription
M365 Copilot licence BLOCKER

Required for email, Teams, people data, and Enterprise Graph

Assign M365 Copilot add-on licence to specific users
Copilot connectors BLOCKER

Connect to external data sources like ServiceNow or Salesforce

M365 Admin Centre → Copilot → Connectors → enable and configure
Sharing controls

Who can share agents and with whom

M365 Admin Centre → Copilot → Settings → Data access → Agents
Restricted SharePoint Search BLOCKER

If enabled, blocks SharePoint as a knowledge source

SharePoint Admin Centre → check if Restricted Search is active
Image generation

DALL-E image creation in agent conversations

M365 Admin Centre → Copilot → Settings → enable image generation

Admin Email Generator

Generate a professional email to send your IT admin.

Quick Instruction Generator

Generate ready-to-paste agent instructions.

Agent Health Checker

Paste your instructions and get a quality score.

The CAPS Technique for Instruction Boundaries

When you need agents to stay strictly within their role, use this three-part formula.

CAPS Keywords

Use CAPITAL LETTERS for critical boundary instructions

You MUST ONLY answer questions about marketing campaigns.
You MUST NOT provide information about HR, finance, or personal topics.
Exact Fallback Text

Provide the exact text the agent should use when declining

If asked about topics outside marketing, respond EXACTLY with:
"I'm the Marketing Campaign Bot — I can only help with campaign-related questions."
Positive Redirect

Instead of just refusing, redirect to the right resource

ALWAYS redirect politely. Example:
"That's a great question, but it's outside my area. For IT support, try the IT Help Desk agent."

Without all three parts, the AI tends to 'be helpful' and answer off-topic questions anyway. CAPS draw attention, exact fallback gives a concrete response, and the redirect keeps it positive.

Sharing & Privacy Rules

🔒Each user sees THEIR OWN data

Emails, Teams chats, and files are scoped to the current user's permissions. Your data is never exposed.

⚠️Embedded files ARE shared with everyone

Files you upload become part of the agent. Anyone with access sees all uploaded content — use SharePoint for sensitive docs.

SharePoint respects existing permissions

If a user can't access a SharePoint file normally, the agent won't show it to them either.

🏷️Sensitivity labels gate access

The highest sensitivity label from any embedded file applies to the whole agent. Users without extract rights are blocked.

🚧Information Barriers NOT supported

IB policies don't apply to embedded file content. Use SharePoint-based knowledge instead for IB compliance.

What's Going Wrong?

Detailed Troubleshooting

Agent doesn't use my knowledge sources

Cause: Files still indexing or unsupported format

Fix: Wait for 'Preparing' to finish. Check file type is supported (.doc, .docx, .pdf, .pptx, .txt, .csv, .xlsx)

Agent gives generic answers

Cause: Instructions too vague or knowledge sources too broad

Fix: Add specific skills/workflows to instructions. Narrow knowledge to focused documents

Agent answers off-topic questions

Cause: Boundaries too soft

Fix: Use the CAPS technique — CAPS keywords + exact fallback text + positive redirect

Agent creation fails silently

Cause: Uploaded file has unsupported sensitivity label

Fix: Remove files with user-defined permissions, DKE, or disabled extract rights

SharePoint content not showing

Cause: Restricted SharePoint Search enabled or permission issue

Fix: Check admin settings. Verify user has access to the SharePoint site

Agent can't read Excel data

Cause: 'Generate docs' capability not enabled

Fix: Enable 'Generate docs' in agent settings. Keep data in ONE sheet

Users can't access shared agent

Cause: Sensitivity label on embedded content blocks them

Fix: Check that target users have extract rights to the highest label on embedded files

Agent makes up answers

Cause: No 'unknown' handling in instructions

Fix: Add explicit fallback: 'If you don't know, say so. DO NOT guess.'

Common Mistakes

Instructions too vague

'Be helpful' — agent doesn't know what helpful means

Define specific tasks and workflows

Filling all 8,000 characters

Overwhelming the AI with too much context

Focus on top 5-6 skills. Move reference content to knowledge docs

Contradictory rules

'Be concise' AND 'Always provide full context'

Choose one approach and be consistent

No error handling

Agent makes up answers when unsure

Always include 'what to do when you don't know' section

Only negative rules

'Don't do X, don't do Y' — agent focuses on what NOT to do

Lead with positives: 'DO this' first, then restrictions

No examples

Agent guesses the format you want

Provide 1-2 example interactions for complex scenarios

Missing tone spec

Agent varies between formal and casual randomly

Set tone explicitly: 'Professional, friendly, concise'

Testing Your Agent

1
Test conversation starters

Try each one — does the agent respond accurately with specific numbers and sources?

2
Test edge cases

Ask questions OUTSIDE the agent's scope. Do boundaries hold?

3
Test consistency

Ask the same question different ways. Are answers consistent?

4
Compare vs base Copilot

Ask the same question to your agent AND plain M365 Copilot. Your agent should be better.

5
Test with colleagues

Share with 2-3 trusted people. What unexpected questions do they ask?

6
Iterate

Refine instructions based on testing. Tighten boundaries, add examples, adjust tone.

What Changes Over Time?

⏱️How long does indexing take?

SharePoint content: several minutes to hours for new sites. Uploaded files: 1-2 minutes (shown as grey until ready). New SharePoint sites may not appear in the picker for hours.

🔄What happens when source files change?

SharePoint: changes are picked up automatically over time (not instant). Uploaded files: you must re-upload the updated version manually.

👤What happens when the agent creator leaves?

The agent continues to work. Other users can still use it. However, only the creator (or an admin) can edit instructions and knowledge sources.

🔐Why does it work for me but not my colleague?

Most likely a permission issue — your colleague may not have access to the SharePoint files, or they may not have the required licence tier (e.g. email needs M365 Copilot licence).

✏️How do I update my agent?

Open microsoft365.com/chat → find your agent in the left panel → click the three dots → Edit. Changes take effect immediately.

👥Can multiple people edit the same agent?

No — only the creator can edit. To collaborate, copy the agent to Copilot Studio where multiple makers can work together.

When to Graduate to Copilot Studio

You need multi-step workflows or approvals

Agent Builder is Q&A only — no actions or automation

You need to call external APIs (Salesforce, ServiceNow, etc.)

Agent Builder can't make HTTP calls or connect to non-M365 services directly

You need proactive messaging (alerts, notifications)

Agent Builder agents are reactive — users must start the conversation

You need customer-facing deployment (website, Facebook, SMS)

Agent Builder agents only work within your M365 tenant

You need stricter knowledge control (block ALL general AI knowledge)

Agent Builder can prioritise but can't fully block general knowledge

You need advanced conversation flows with branching logic

Agent Builder supports simple Q&A; Copilot Studio supports complex topic trees

You want to publish to the Teams app store for the whole org

Agent Builder sharing is simpler; Copilot Studio supports full Teams app packaging

Agent Gallery — What Others Built

Curated agent ideas from real IT admins. Click to see instructions.

Frequently Asked Questions

What is Agent Builder in M365 Copilot?

Agent Builder is the no-code experience inside Microsoft 365 Copilot for creating lightweight AI agents. You define instructions, add knowledge sources, and share with your team — all without writing a single line of code.

Do I need a paid licence to use Agent Builder?

Not for basic agents! Code interpreter, image generation, and web search are free. For SharePoint, file uploads, and connectors you need pay-as-you-go billing. For email, Teams chats, and people data you need a per-user M365 Copilot licence.

What are the knowledge source limits?

4 public URLs (max 2 levels deep), up to 100 SharePoint files, 20 uploaded files (512MB max), 5 Teams chats, and all emails (cannot scope to folders). Check the Knowledge Sources tab for full details.

What happens when I share my agent that reads my emails?

Each user sees THEIR OWN emails, not yours. The agent runs in the context of whoever is using it. Your email data is never exposed to other users.

Should I use Agent Builder or Copilot Studio?

Use Agent Builder for Q&A agents grounded in M365 content (80% of use cases). Use Copilot Studio when you need multi-step workflows, external APIs, proactive notifications, customer-facing deployment, or advanced conversation branching.

What's the difference between pay-as-you-go and a Copilot licence?

Pay-as-you-go unlocks SharePoint, file uploads, connectors, and sharing — billed per credit. But email, Teams chats, people data, and Enterprise Graph require a per-user M365 Copilot licence ($30/user/month). Pay-as-you-go does NOT cover these.

Can I move my Agent Builder agent to Copilot Studio later?

Yes! The 'Copy to Copilot Studio' option lets you transfer your agent for advanced features. Available at all licence tiers.

Is this tool still being improved?

Yes! This is V1. Visit our feedback page to suggest improvements or share your Agent Builder experiences.

Changelog

V32026-04-18
  • Agent Builder Simulator
  • Instruction Generator with templates
  • Agent Health Checker (score your instructions)
  • Knowledge Source Recommender
  • Agent Gallery with 10 curated ideas
  • Agent Builder vs Copilot Studio comparison
  • Admin email generator
  • My Agent Plan export
  • Scenario filters by department and tier
  • Progress tracker
  • Deep-link sharing
  • Video walkthrough links
V22026-04-18
  • Guided 3-step wizard
  • Structured evaluator replacing keyword matching
  • Playbook templates with copy-to-clipboard
  • Plain-English licensing decision guide
  • Admin prerequisites section
  • Cost model guidance
  • Symptom-based troubleshooter
  • Lifecycle Q&A section
  • Search across all tabs
  • Accessibility improvements
V12026-04-18
  • Initial launch with 5 tabs
  • 15 assessed scenarios
  • Capability matrix
  • Knowledge source detailed guides
  • CAPS technique
  • Graduate to Studio checklist
Your Progress
💬