Ideas · 2026-09-19

Agent Builder

Instructions, knowledge, agent.
FIG. 01 · DECLARATIVE AGENT

Agent Builder is the guided path to declarative agents inside Microsoft 365 Copilot — instructions, knowledge and starter prompts without standing up Studio first.

What it is

Microsoft Learn describes Agent Builder in Microsoft 365 Copilot as an easy way to build declarative agents: customised Copilot experiences that declare instructions, knowledge (SharePoint, connectors, web) and capabilities. Agents run on the same orchestrator and models as Microsoft 365 Copilot. For complex actions and integrations, Microsoft points makers to Copilot Studio instead.

Declarative vs custom engine.
FIG. 02 · AGENT TYPES

Where it sits in the stack

Above Chat/Copilot, below Studio. Good for personal and team productivity agents. SharePoint agents are a sibling path for site-scoped knowledge. Foundry is for custom engines.

Stack from Chat to Foundry.
FIG. 03 · STACK

Key features / capabilities

  • Natural-language or Configure-tab authoring (instructions, up to configured knowledge sources, starter prompts).
  • Knowledge from SharePoint, Copilot connectors and public web (as enabled).
  • Test pane before sharing; share with others or submit to the organisational catalog.
  • Available from microsoft365.com/chat, office.com/chat, and Teams desktop/web (not mobile per Learn).
  • Licensing: included with Microsoft 365 Copilot for agents built this way; Chat users may have limited agent capabilities; pay-as-you-go may apply for some agent scenarios — verify Learn prerequisites.

Who it is for / when to use

Business users and makers who need a scoped helper quickly. Escalate to Studio when you need authenticated actions, complex workflows or multi-channel publish.

When Builder is the wrong tool

Learn’s tool comparison is blunt: Agent Builder is weak at complex workflows and integrations; some advanced features arrive in Agents Toolkit first. If your scenario needs authenticated API actions, multi-channel publish, or ALM across environments, start in Copilot Studio or the Microsoft 365 Agents Toolkit rather than forcing Builder past its design point. Builder shines for coaching agents, onboarding helpers and knowledge-scoped Q&A with a short path to first value.

Cost layer

Often covered by the Copilot licence for declarative agents built in Agent Builder; some grounding and custom agents meter. Keep Studio Credits separate. See Managing cost and the feature matrix.

Seat, add-on, metered.
FIG. · COST LAYERS

Risk and governance

Knowledge sources inherit SharePoint permissions. Require an owner and a review before org-catalog publish. More: Managing risk.

Entra, Purview, Defender, Agent 365.
FIG. · READINESS

Adoption tip

Template the instructions field. Ban agents without a named business owner in the description. Habits: Adoption.

Task, short unit, measure again.
FIG. · ADOPTION

Related Ideas

SharePoint agents · Copilot Studio · Connectors · M365 Copilot

Source note: check Microsoft Learn and Product Terms before you brief finance or legal. Products, names and meters change. This site is independent commentary, not Microsoft official documentation.

← Ideas · Features · Cost · Risk · Adoption

AI draft note Parts of this page may be drafted or illustrated with AI. Check important facts against Microsoft Learn and your own counsel. This is not professional advice.