M365 Agent Builder Helper
Figure out what you CAN build, HOW to build it, and WHEN to graduate to Copilot Studio
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?
Try the Agent Builder Simulator
Experience the Agent Builder workflow without leaving this page.
Which licence tier do I need?
- Web search / public URLs
- Code interpreter & charts
- Image generation
- SharePoint files & sites
- Upload documents
- Copilot connectors
- Share with others
- Outlook email search
- Teams chats & meetings
- People / org chart data
- Full Enterprise Graph
Full Capability Matrix
Last verified: April 2026 · MS Learn source
| Capability | Free | PAYG | Licensed | Notes |
|---|---|---|---|---|
| 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
| Feature | Agent Builder | Copilot Studio |
|---|---|---|
| Coding required | None — natural language only | Low-code / no-code |
| Build time | 5–15 minutes | Hours to days |
| Where to build | microsoft365.com/chat or Teams | copilotstudio.microsoft.com |
| Knowledge sources | M365 data (SP, email, Teams, web, files) | M365 + Dataverse + external APIs + custom |
| Actions & automation | No — Q&A only | Yes — Power Automate, HTTP, connectors |
| External API calls | Not supported | HTTP actions, API plugins |
| Proactive messaging | No — user must start conversation | Yes — event triggers, scheduled messages |
| Conversation branching | Simple Q&A flow | Complex topic trees with conditions |
| Deployment channels | M365 Copilot + Teams only | Teams, web, Facebook, SMS, custom |
| Customer-facing | Internal org only | Internal + external customers |
| Sharing | Share link within org | Teams app store, managed deployment |
| Cost | Included with M365 / pay-as-you-go | $200/tenant/month (25k messages) |
| AI model | GPT-4o (managed by Microsoft) | GPT-4o + custom model options |
| Block general AI knowledge | Can prioritise but not fully block | Full control over knowledge scoping |
| Copy between platforms | Copy TO Copilot Studio ✅ | Cannot copy back to Agent Builder |
What Does It Cost?
Web search, public URLs, code interpreter, image generation, basic instructions
No additional cost — included with any M365 licenceNo admin action neededEverything 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 CentreEverything pay-as-you-go + email, Teams, people, Enterprise Graph
Per-user M365 Copilot add-on licence assigned by adminAdmin assigns licence to individual usersQuick Reference — All Limits
Last verified: April 2026 · MS Learn source
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
| Format | Max Size |
|---|---|
| .doc, .docx | 512 MB |
| 512 MB | |
| .ppt, .pptx | 512 MB |
| .txt | 512 MB |
| .xls, .xlsx | 30 MB |
| .csv | 150 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.
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.
Users need access to microsoft365.com/chat or Teams desktop
No special admin action — available to all M365 users by defaultRequired for SharePoint, file uploads, connectors, and sharing
M365 Admin Centre → Copilot → Settings → enable pay-as-you-go billing via Azure subscriptionRequired for email, Teams, people data, and Enterprise Graph
Assign M365 Copilot add-on licence to specific usersConnect to external data sources like ServiceNow or Salesforce
M365 Admin Centre → Copilot → Connectors → enable and configureWho can share agents and with whom
M365 Admin Centre → Copilot → Settings → Data access → AgentsIf enabled, blocks SharePoint as a knowledge source
SharePoint Admin Centre → check if Restricted Search is activeDALL-E image creation in agent conversations
M365 Admin Centre → Copilot → Settings → enable image generationAdmin 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.
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.
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."
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
Emails, Teams chats, and files are scoped to the current user's permissions. Your data is never exposed.
Files you upload become part of the agent. Anyone with access sees all uploaded content — use SharePoint for sensitive docs.
If a user can't access a SharePoint file normally, the agent won't show it to them either.
The highest sensitivity label from any embedded file applies to the whole agent. Users without extract rights are blocked.
IB policies don't apply to embedded file content. Use SharePoint-based knowledge instead for IB compliance.
What's Going Wrong?
Detailed Troubleshooting
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)
Cause: Instructions too vague or knowledge sources too broad
Fix: Add specific skills/workflows to instructions. Narrow knowledge to focused documents
Cause: Boundaries too soft
Fix: Use the CAPS technique — CAPS keywords + exact fallback text + positive redirect
Cause: Uploaded file has unsupported sensitivity label
Fix: Remove files with user-defined permissions, DKE, or disabled extract rights
Cause: Restricted SharePoint Search enabled or permission issue
Fix: Check admin settings. Verify user has access to the SharePoint site
Cause: 'Generate docs' capability not enabled
Fix: Enable 'Generate docs' in agent settings. Keep data in ONE sheet
Cause: Sensitivity label on embedded content blocks them
Fix: Check that target users have extract rights to the highest label on embedded files
Cause: No 'unknown' handling in instructions
Fix: Add explicit fallback: 'If you don't know, say so. DO NOT guess.'
Common Mistakes
'Be helpful' — agent doesn't know what helpful means
Define specific tasks and workflows
Overwhelming the AI with too much context
Focus on top 5-6 skills. Move reference content to knowledge docs
'Be concise' AND 'Always provide full context'
Choose one approach and be consistent
Agent makes up answers when unsure
Always include 'what to do when you don't know' section
'Don't do X, don't do Y' — agent focuses on what NOT to do
Lead with positives: 'DO this' first, then restrictions
Agent guesses the format you want
Provide 1-2 example interactions for complex scenarios
Agent varies between formal and casual randomly
Set tone explicitly: 'Professional, friendly, concise'
Testing Your Agent
Try each one — does the agent respond accurately with specific numbers and sources?
Ask questions OUTSIDE the agent's scope. Do boundaries hold?
Ask the same question different ways. Are answers consistent?
Ask the same question to your agent AND plain M365 Copilot. Your agent should be better.
Share with 2-3 trusted people. What unexpected questions do they ask?
Refine instructions based on testing. Tighten boundaries, add examples, adjust tone.
What Changes Over Time?
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.
SharePoint: changes are picked up automatically over time (not instant). Uploaded files: you must re-upload the updated version manually.
The agent continues to work. Other users can still use it. However, only the creator (or an admin) can edit instructions and knowledge sources.
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).
Open microsoft365.com/chat → find your agent in the left panel → click the three dots → Edit. Changes take effect immediately.
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
Agent Builder is Q&A only — no actions or automation
Agent Builder can't make HTTP calls or connect to non-M365 services directly
Agent Builder agents are reactive — users must start the conversation
Agent Builder agents only work within your M365 tenant
Agent Builder can prioritise but can't fully block general knowledge
Agent Builder supports simple Q&A; Copilot Studio supports complex topic trees
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.
HR Policy BotHRpaygo
Answers employee questions about leave, benefits, dress code, and workplace policies from SharePoint HR docs.
Knowledge: sharepoint
By: IT Admin, Healthcare
Project Status ReporterProject Managementpaid
Pulls project updates from SharePoint project sites and summarises status, risks, and next steps.
Knowledge: sharepoint, teams
By: PMO Lead, Tech
IT TroubleshooterITpaygo
Guides users through common IT issues using uploaded troubleshooting guides. Escalates when stuck.
Knowledge: file_upload
By: Service Desk Lead
Brand Voice CoachMarketingpaygo
Reviews draft content against uploaded brand guidelines and suggests improvements for tone and style.
Knowledge: file_upload
By: Marketing Manager
Expense Policy GuideFinancepaygo
Answers questions about expense limits, receipt requirements, and approval workflows from finance policy docs.
Knowledge: file_upload, sharepoint
By: Finance Analyst
Competitive Intel TrackerSalesfree
Searches the web for competitor news, pricing changes, and product announcements. Summarises weekly.
Knowledge: web_search
By: Strategy Analyst
Meeting Recap BotOperationspaid
Summarises Teams meeting discussions into action items, decisions, and follow-ups organised by person.
Knowledge: teams
By: EA, Executive Team
Training NavigatorHRpaygo
Recommends training courses and learning paths based on role and career goals from the SharePoint learning catalogue.
Knowledge: sharepoint
By: L&D Coordinator
Contract Clause FinderLegalpaygo
Searches uploaded contract templates to find specific clauses, terms, and conditions quickly.
Knowledge: file_upload
By: Legal Paralegal
Data Insight GeneratorAnalyticsfree
Analyses uploaded spreadsheets and generates charts, trends, and summaries using code interpreter.
Knowledge: code_interpreter
By: Business Analyst
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
- 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
- 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
- Initial launch with 5 tabs
- 15 assessed scenarios
- Capability matrix
- Knowledge source detailed guides
- CAPS technique
- Graduate to Studio checklist
🤖 Your Copilot Decision Toolkit
Are you ready?
📊FeaturesWhat can it do?
💰ROIIs it worth it?
📜LicensingWhat licence?
🛒Licence PickerCheapest combo
🎬Demo ScriptsShow the value
⚙️StudioBuild agents
💬 Got feedback? Share it here →