Your First Copilot Studio Agent

Build a grounded agent from one source, recognize the classic and new authoring experiences, and keep saved, tested, published, and deployed evidence separate.


What you'll learn

  • Configure a focused agent with one grounded knowledge source
  • Write source-bound instructions with a missing-information rule
  • Tell the classic and new agent experiences apart on sight
  • Separate saved, tested, published, and deployed as distinct evidence
On this page

A small agent can be ready to try before lunch. Give it a name, connect one document, and ask a question in the test pane on the right. That speed is useful, but it says nothing yet about reliability. Copilot Studio can produce fluent answers before those answers are dependable, and a result in the editor doesn't tell you what a colleague will receive in Teams.

This lesson has two jobs. You'll build a focused, one-source agent. You'll also keep track of four different kinds of evidence: a saved draft, a test result, a published version, and a response observed by a real user. Each supports a different claim.

A first agent has four parts

Microsoft describes Copilot Studio as a graphical, low-code tool for building agents and agent flows. The editor brings together instructions, knowledge sources, topics, tools, and triggers. For this first build, pay attention to four parts:

  • Purpose names the audience and the job. "Explain introductory Copilot Studio concepts to first-time makers, using one approved source" is specific enough to test. "Help with stuff" isn't.
  • Instructions tell the agent how to use the source, how to format its answers, and what to do when information is missing.
  • Knowledge is the approved material behind its factual claims.
  • Published version is the particular version available through a deployment surface your organization has approved.

Begin with one purpose and one source. In that setup, you can still trace an answer back to the material that supports it. Add five sources and three tools at once, and a wrong answer has many more places to hide. Expand after the small version behaves reliably and you know how to diagnose it.

Are you in Classic or the new experience?

Before you touch a control, find out which of two authoring experiences you are in: they are different products wearing one name. The classic experience organizes an agent around topics, triggers, nodes, entities, and variables in separate areas. The new agent experience is instruction-based and lays everything out under four tabs: Build, Preview, Evaluate, and Monitor. Microsoft documents the new experience as a production-ready preview as of mid-2026.

You can tell them apart on sight, and you should, because the agent's name tells you nothing about which one made it:

Dimension Classic experience New agent experience
Authoring model Topics, triggers, and nodes Natural-language instructions
Layout Separate Topics, Entities, and Flows areas Build, Preview, Evaluate, and Monitor tabs
Best for Deterministic, scripted branching Instruction-led reasoning over Microsoft 365 context
Transfer Stays classic: no migration path Stays new: no migration path

Reach for classic when you need deterministic, scripted conversation paths or a feature only classic exposes. Start in the new experience for an instruction-led agent that reasons over Microsoft 365 organizational context. Build in one and you can't convert it to the other later.

There is no undo on the experience choice

Microsoft documents no transfer path between the classic and new experiences in either direction. If you build in the wrong one, you rebuild. Confirm the authoring model from the visible layout before you invest hours in topics or instructions.

Keep the agent inside its source

Grounding means giving the agent specific material to compose answers from. A connected source doesn't make every generated sentence true: the agent can still blend in general knowledge or fill a gap with something plausible. Your instructions close that gap, and two rules do most of the work. Tell the agent to answer product facts only from the configured source, and give it an exact sentence to say when the source doesn't cover the question. Skip that second rule and "I don't know" turns into an invented answer.

Then test both sides of the boundary in fresh conversations. Ask one question the source clearly answers, and one it clearly does not. The supported question checks that real facts survive. The unsupported question checks that the agent refuses to invent. Grade the supported answer sentence by sentence: every factual claim must map to a passage in the source. One fluent sentence with no supporting passage fails the whole response, no matter how good the rest looks. Run this check before you trust any other part of the build.

Source-bound instructions for a first agent· copilot-studio
Bad example

Help new makers with Copilot Studio questions. Keep answers clear and useful.

Good example

You help first-time makers understand Microsoft Copilot Studio. Use plain English and keep answers under 120 words, with no more than three bullets when a list helps. Use only the configured knowledge source for product facts. If the source does not contain the answer, say: "I couldn't find that in the configured source." Do not invent prices, dates, product capabilities, deployment recommendations, or company policies. If a request is ambiguous, ask one clarifying question.

Why this works: An agent that answers briefly from its one source and, when the source is silent, says so instead of guessing.

The supported-question probe· copilot-studio
Bad example

What is Copilot Studio, and how should our team deploy it?

Good example

What is Copilot Studio, and what can a first-time maker use it to build? Answer in no more than three bullets.

Why this works: A short answer that names Copilot Studio as a low-code tool for building agents, with every sentence traceable to your source and no extra recommendation bolted on.

The missing-fact probe· copilot-studio
Bad example

What's our travel reimbursement limit? Just give me the number.

Good example

What is our company's 2026 travel reimbursement limit?

Why this works: The agent reports that the configured source does not contain the information: no invented amount, no made-up policy. If it names a figure, your no-invention rule needs strengthening.

Saved, tested, published, deployed: four different claims

Treating any single step as proof of the whole chain turns a good build into an embarrassing one. Copilot Studio produces four distinct kinds of evidence, and each one licenses only a narrow conclusion.

What you did What it proves What it doesn't prove
Saved a draft The configuration was recorded That any answer is correct
Ran the test pane That draft produced that result, once That a deployed host behaves the same
Published The publish operation completed That users received the intended answer
Tested the deployed host The published agent behaved that way there That future edits will behave the same

The test pane is an authoring-time inspection surface inside the editor. You can reset the conversation and try again there. Publishing makes a version available through associated channels, and practitioners have reported cases where a published Teams agent answered differently than the same agent in the test pane. That is why the only evidence an agent works where people use it is a fresh conversation in the actual deployment surface, run after publishing. Earlier steps support narrower claims about saving, testing, or publishing. You will run that real-host verification in Autonomous Agents, Testing, and Publishing. For now, keep "it saved," "it passed the test," and "it works" as separate claims.

Keep four columns, not one verdict

In your evidence log, record saved, tested, published, and deployed as separate rows with their own results. The habit costs seconds and stops you from ever telling a stakeholder an agent is "live" on the strength of a test-pane screenshot.

A first agent is done only with evidence

A first agent is finished when its evidence can be reviewed. Concretely: the supported question returns only source-backed claims, the unsupported question returns your missing-information sentence, and (if you have somewhere to publish) the same two questions pass again in a fresh conversation in the real host. Write down the prompt, the full response, the matching source passage, your verdict, and any correction for each run. The log turns a general impression into evidence a reviewer can check.

If you are in the new experience, its four tabs give you this loop by design: Build to configure, Preview to try realistic prompts, Evaluate for whatever repeatable checks your tenant exposes, and Monitor for whatever runtime views it surfaces. Move through them in that order and you will rarely ship an answer you haven't inspected. The next lesson, Knowledge Grounding and Conversation Design, makes the grounding half of this more reliable.

Try it yourself

Ground a tiny agent and try to break it

Build (or simulate on paper) a one-source agent and prove it both answers from its source and refuses to invent. Ten minutes, fictional data.

  1. 01

    Give the agent this three-fact source. A North Building meeting-room FAQ explains room access. After-hours access needs a Facilities Access Request submitted at least two business days ahead. Room questions go to the facilities desk.

  2. 02

    Set source-bound instructions: answer only from the FAQ, keep it under 80 words, and if the FAQ is silent say "The Facilities FAQ does not provide that information." Forbid inventing procedures, deadlines, or fees.

    Hint: Reuse the instruction pattern from the prompt card, swapping only the source.

  3. 03

    In a fresh conversation, ask how to request after-hours access. Check that every sentence (the request name, the destination, the two-business-day timing) maps to a fact, with nothing added.

  4. 04

    In another fresh conversation, ask how much parking reimbursement you can claim. Confirm the agent uses the missing-information sentence and names no amount.

  5. 05

    If either answer fails, change one instruction, save, and rerun both questions so the unchanged case is checked again.

A small agent whose supported answer is fully traceable and whose unsupported answer admits the gap, plus a claim-to-source log you could hand to a reviewer.

Everything in this module comes back to evidence: what you configured, what you tested, what got published, and what a person actually received. You just practiced separating those for a one-source agent. Conversation design, tools and flows, autonomy, and publishing apply the same separation to a larger surface, not a different one.

Key takeaways

  • A Copilot Studio agent is an assembly you configure: purpose, instructions, knowledge, and tools.
  • Classic (topics and nodes) and the new experience (Build, Preview, Evaluate, Monitor) are different authoring models with no transfer path.
  • Ground on one source, then grade every factual sentence against it. Fluent phrasing alone does not earn a pass. Only a supporting passage for each claim does.
  • Source-bound instructions need both a source-only rule and an exact sentence for when the source is silent.
  • Saved, tested, published, and deployed are four separate claims: never let one stand in for another.

Check your understanding

  1. 1. You saved a draft, it passed the test pane, and publishing completed. What is still required before you can say the agent was observed working where colleagues use it?

  2. 2. Which statement about the classic and new agent experiences is correct?

  3. 3. You open an agent and want to know which experience it uses. What is the reliable tell?

  4. 4. Your grounded agent answers a question your source never covers, and the answer is fluent and confident. What should you conclude?

  5. 5. What does a successful publish operation prove on its own?

Frequently asked questions

Terms used in this lesson

agent
An AI application you build in Copilot Studio from instructions, knowledge, topics, and tools, with triggers that start it.
grounding
Giving an agent specific material to base answers on, so factual claims come from your source rather than the model's general knowledge.
deployment surface
The place your organization lets people use a published agent, such as Teams or an approved web page.
classic experience
The Copilot Studio authoring model organized around topics, triggers, nodes, entities, and variables.
new agent experience
The instruction-based Copilot Studio authoring model organized around the Build, Preview, Evaluate, and Monitor tabs.

Further reading