Skip to content

🏗️ M365 Agent Builder Helper

Live at: aguidetocloud.com/agent-builder-guide/ Built: April 2026 | Version: 3.0 Cost: $0 — 100% client-side JavaScript, zero API calls

What It Does

The #1 interactive guide to M365 Copilot Agent Builder. Helps users figure out what they CAN build, HOW to build it, and WHEN to graduate to Copilot Studio. Covers both Copilot Chat (free) and M365 Copilot licensed users.

Not just a reference — it's a decision engine with a wizard, simulator, instruction generator, health checker, and agent gallery.

Architecture Overview

┌──────────────────────────────────────────────────────────────┐
│              100% Client-Side (No API Calls)                  │
├──────────────────────────────────────────────────────────────┤
│                                                              │
│  TOML Data Layer (5 files)                                   │
│     licensing.toml  → tiers, capabilities, 15 scenarios      │
│     knowledge_sources.toml → 7 source types with rules/tips  │
│     tips.toml → admin prereqs, cost, lifecycle, symptoms     │
│     gallery.toml → 10 curated agent ideas                    │
│     comparison.toml → 15 AB vs CS comparison features        │
│                                                              │
│  Hugo Template (list.html)                                   │
│     5 tabs, 25+ interactive sections                         │
│     Hugo renders TOML → HTML at build time                   │
│                                                              │
│  JavaScript (25KB) — All client-side interactions             │
│     Wizard engine, simulator, health checker,                │
│     instruction gen, filters, recommender, progress tracker  │
│                                                              │
│  CSS (15KB) — Dark glassmorphism, responsive                 │
│     .abguide-* namespace, animations, mobile support         │
│                                                              │
└──────────────────────────────────────────────────────────────┘

5-Tab Structure

Tab 1: Can I Build This?

  • Guided wizard — 3 steps: data sources → audience → actions → verdict
  • Scenario filters — by tier (Free/PayGo/Licensed) and verdict (Possible/Needs Studio)
  • 15 scenario cards with ✅/⚠️/❌ verdicts, click for detail + playbook
  • Playbooks — sample instructions, conversation starters, test prompts (copy-to-clipboard)
  • Agent Builder Simulator — 5-step walkthrough (name → instructions → sources → starters → preview)
  • Plan export — generates printable agent plan in new window
  • Deep-link sharing — URL hash #scenarios/hr-faq-bot

Tab 2: Capability Matrix

  • Plain-English decision guide — 3 cards: Free / PayGo / Licensed with admin actions
  • 14-row capability table — side-by-side ✅/❌ with notes column
  • AB vs Copilot Studio comparison — 15-row feature table with winner highlighting
  • Cost model — 3-tier pricing guidance with admin notes
  • Verified dates with MS Learn source links

Tab 3: Knowledge Sources

  • Quick reference grid — 7 limit pills (instructions, URLs, SP files, uploads, chats, emails, formats)
  • Knowledge Source Recommender — "Where is your data?" → recommendation + tier + tips
  • 7 expandable source cards — rules, tips, gotchas, file size tables, privacy notes

Tab 4: Tips & Tools

  • Admin prerequisites — 7 items with BLOCKER flags and admin actions
  • Admin email generator — 4 request types → professional email with copy button
  • Instruction generator — purpose + company + tone + boundary → full instructions
  • Agent Health Checker — paste instructions → 10-check rubric → score 0-100
  • CAPS Technique — 3-part instruction boundary formula with code examples
  • Privacy rules — 5 cards (each user sees own data, embedded files shared, etc.)
  • Symptom troubleshooter — 8 clickable symptoms → causes + quick fix
  • Detailed troubleshooting — 8 problem/cause/fix cards
  • Common mistakes — 7 mistake cards
  • Testing steps — 6-step checklist
  • Lifecycle Q&A — 6 "what changes over time" cards
  • Graduate to Studio — 7-signal checklist

Tab 5: Community & FAQ

  • Agent Gallery — 10 curated agents with copy-paste instruction previews
  • FAQ — 8 questions (first open, rest collapsed)
  • Changelog — V1/V2/V3 version history

Floating

  • Progress tracker — 6-item checklist persisted in localStorage

Key Data Files

File Content Size
data/agent_builder_guide/licensing.toml 3 tiers, 14 capabilities, 15 scenarios with playbooks ~12KB
data/agent_builder_guide/knowledge_sources.toml 7 knowledge source types with rules, tips, gotchas ~5KB
data/agent_builder_guide/tips.toml Changelog, CAPS technique, troubleshooting, mistakes, testing, limits, admin prereqs, cost, lifecycle, symptoms, privacy, graduate ~12KB
data/agent_builder_guide/gallery.toml 10 curated agent ideas with instruction previews ~5KB
data/agent_builder_guide/comparison.toml 15 AB vs CS comparison features ~3KB

Research Sources

All capability data verified against:

Key Data Corrections (from research)

Capability Previous Corrected Source
Code interpreter Paid only Free (no licence needed) MS Learn knowledge-sources table
Image generation Paid only Free (no licence needed) MS Learn knowledge-sources table
Outlook email Pay-as-you-go works Licence only (paygo does NOT work) MS Learn "Yes (license only)"
Teams chats Pay-as-you-go works Licence only (paygo does NOT work) MS Learn "Yes (license only)"
People data Not listed Licence only (new capability row) MS Learn knowledge-sources table

Site Integration

Item Location Status
toolkit_nav.toml [[tools]] entry, category "copilot" ✅
tool_colours.toml #00A4EF, hue 199, shares with Agent 365 ✅
baseof.html page-agent-builder-guide body class ✅
free-tools/list.html Card in "For Copilot Decision Makers" section ✅
taglines.toml OG image tagline added ✅
cache_version Bumped to 2026041823 ✅
manifest.json Tool count updated ✅
tool-ecosystem.html Uses "copilot" group ✅

Maintenance Guide

Updating capability data

Edit data/agent_builder_guide/licensing.toml — the [[capabilities]] section drives the Tab 2 matrix table. Check MS Learn quarterly.

Adding new scenarios

Add a [[scenarios]] block in licensing.toml with: title, description, icon, verdict (yes/partial/no), requires (free/paygo/paid/studio), knowledge array, tip, and optionally sample_instructions, conversation_starters, test_prompts.

Add an [[agents]] block in gallery.toml with: name, author, department, description, knowledge, tier, stars, instructions_preview, tags.

Updating the changelog

Add a new [[changelog]] entry at the TOP of the changelog section in tips.toml.

Version History

Version Date Key Changes
V3.0 2026-04-18 14 new features: wizard, simulator, health checker, instruction gen, admin email gen, AB vs CS comparison, knowledge recommender, gallery, filters, plan export, progress tracker, deep-links, changelog. 7 bug fixes.
V2.0 2026-04-18 Guided wizard, structured evaluator, playbook templates, licensing guide, admin prerequisites, cost model, symptom troubleshooter, lifecycle section, search, accessibility.
V1.0 2026-04-18 Initial launch — 5 tabs, 15 scenarios, capability matrix, knowledge source guides, CAPS technique, graduate checklist.