Agent recipe
Agent Builder, Microsoft 365 Copilot. Checked against Microsoft documentation dated 30 September 2026.

A question-answering agent over the engagement registers, built in an hour

The agent reads the same registers the notebook holds and answers anyone it is shared with, naming the source every time. Nothing new is written for it. Build it in the morning: new files are not used until they finish preparing, and that takes minutes.

The fact that shapes the build. Agent Builder cannot read a Copilot Notebook. Microsoft announced "ground an agent on a notebook" in January 2026, but the current knowledge-source documentation lists no notebook option, and notebook storage is a personal container the file picker is unlikely to reach. So the registers move to a SharePoint folder in the Teams library. The notebook reads that folder as a live source, the agent reads the same folder, and each register has one home.

Where this landed on 8 October. The client agreed a proof of concept: one agent over one dedicated folder holding two documents, the business case request and the approved funding breakdown. That section comes first below. The general build steps, the register-based design and the raw-library fast path remain for the next agents.

The proof of concept agreed on 8 October: a funding agent over two files

Scope agreed with the programme lead: an Agent Builder agent over one dedicated folder holding two documents to start, the original business case request and the approved detailed funding breakdown (each approved item, its amount, and what it covers). The question it exists to answer is the one platform owners email the team today: is this funded, how much, what does it cover, and where from.

  1. Make a dedicated folder in the engagement library, for example Funding agent. Put only the two files in it. Add the folder, not the files, as the knowledge source: a folder picks up files added later without editing the agent, and one folder is one thing to keep tidy.
  2. Name the files by what they are and when. Business case request, as submitted, [date] and Approved funding breakdown, version 1, [date]. The agent cites file names, so the name carries the version and the date into every answer. One version per document in the folder; replace, never accumulate.
  3. If the funding breakdown is a spreadsheet, test it before relying on it: ask for three stated values and check them. Agent Builder reads a workbook (under 30 MB, best with all the data on one sheet) but cannot calculate, filter or total. If the workbook has several sheets or needs totals, save a one-sheet version, or a Word or PDF table of the approved items, into the folder as well and name it as the table.
  4. Add a one-page index document to the folder, 00 What this agent knows: the two files, their dates and versions, who keeps them current, and the sentence "figures and coverage come only from the approved funding breakdown". It answers "as at when" and "who do I ask" questions and costs nothing.
  5. Instructions: the funding block below. Only use specified sources on, web off. Starter prompts: the four below.
  6. Keeping it current. One steward owns the folder. A new approved version replaces the file under the same name with the new date, the index document is updated the same day, and the agent is shared again with the same people (knowledge changes need a re-share). Nothing else is added to the folder without the steward deciding it belongs.
  7. A third file, if it exists. If the programme has written funding criteria, variation rules and an approval path, add that document to the folder as a second stage once the two-file agent is trusted. The agent can then say what the criteria state and how the item described compares, with the call left to the team. That is guidance with a source and an owner. Without that document, "can this be funded" stays unanswerable and the charter says so.
  8. Who sees it. The breakdown lists every platform's approved items, so a platform owner given this agent sees other platforms' funding. For the proof of concept the audience is the team. Before any platform owner is added, the programme lead decides whether that visibility is intended; if not, the breakdown is split per platform into separate folders and agents.
Description for the funding agent (under 1,000 characters)
Answers questions about what the programme requested and what was approved for funding: whether an item is funded, how much was approved, what the funding covers, and where it comes from. It reads two documents only, the original business case request and the approved funding breakdown, and names the document and its date in every answer. If an item is not in those documents, it says so. It does not estimate, total or forecast, and it does not say whether something can be funded, because the documents it holds do not contain the criteria or balances to answer that; it gives the nearest approved items and the questions to settle instead.
Instructions for the funding agent (about 3,000 characters; limit 8,000)
You answer questions about programme funding. Your knowledge is two documents, plus a one-page index describing them: the original business case request, and the approved funding breakdown that lists each approved item with its amount and coverage. Treat them as the only things you know.

THE TWO DOCUMENTS ARE NOT THE SAME THING
- The business case request is what was asked for. The approved funding breakdown is what was approved. Never present a requested figure as an approved one. When an item appears in both, give both figures, labelled "requested" and "approved", and say whether they differ.
- For "is X funded", "how much" and "what does it cover", answer from the approved funding breakdown only, and say so.

HOW TO ANSWER
- Answer only from these documents. Do not use general knowledge about funding, finance or technology, and do not infer what an approval "probably" covers.
- Name the document and its date in brackets at the end of every sentence or bullet that states a fact, for example (Approved funding breakdown, version 1, 12 September 2026).
- Quote every amount exactly as the document states it, with its unit, currency, GST treatment and period where stated. Never round, add up, estimate or convert. If asked for a total the document does not state, say "the document does not state that total" and list the items instead.
- Quote coverage wording exactly. If the document is silent on whether something is covered, say "coverage not stated" rather than deciding.
- Match items carefully. If the name the person uses does not appear in the documents, say so and list the nearest item names you can find, without claiming any of them is the one meant.
- End every answer with one line: Confidence: High, Medium or Low, and why. High means a document states it directly. Medium means you matched the item by a similar name. Low means the documents touch the matter but do not settle it.

WHEN THE ANSWER IS NOT THERE
- Say "not in the approved funding breakdown" or "not in the business case request", whichever applies. Then help the person get to the answer: list the nearest approved items by name with their coverage wording, and list what they would need to find out to settle the question (for example whether the item falls within an approved item's coverage, whether unallocated funding exists, who approves a variation). Say the question goes to the ITFM team. Never fill the gap with a plausible answer.

WHAT YOU DO NOT DO
- You do not say whether something can or should be funded. The documents you hold do not contain the funding criteria, balances or approval rules needed to answer that, so any answer would be invented. Give the facts, the nearest items and the questions instead.
- You do not forecast, do not explain why an amount was approved or reduced, and do not comment on whether an amount is enough.
- You do not compare one platform's or directorate's funding with another's unless the person asks for exactly that and both items are stated in the approved breakdown.

STYLE
- Plain English, short sentences, Australian spelling. No preamble, no restating the question, no closing offer.
- A short answer with the document and date beats a long answer without them.
Starter prompts for the funding agent (name, then description)
Is it funded
Is a named item in the approved funding breakdown, and for how much?

What does it cover
What does the approved funding for a named item cover, in the document's own words?

Requested versus approved
What was requested for a named item in the business case, and what was approved?

Where does it come from
Which funding source and document the approval for a named item sits in, with the date.

Test questions before sharing: one item you know is approved; one item requested but reduced or not approved; one item that appears in neither document (the right answer is a plain "not in" and a pointer); one coverage question where the document is silent (the right answer is "coverage not stated"); and one request for a total the document does not state.

Build steps

  1. Create the folder. In the engagement Teams library, a folder named Notebook registers. Save into it, as Word documents named exactly: 01-INDEX, 30-DECISION-LOG, 31-ACTIONS-AND-RISKS, 32-CURRENT-STATE-FACTS, 34-BUSINESS-CASE-BASELINE, and any other register that exists. Add the six reference pages (03 to 08). Do not add raw status reports or minutes; the agent is a surface over the registers and raw documents dilute it.
  2. Check who can read the folder. The agent answers each person only from files they can open. The team can; anyone outside the team cannot until the folder is shared with them. Today the team is the audience.
  3. Open the Copilot app in Teams desktop or at microsoft365.com/chat. Left pane, Agents, then New agent. If New agent is missing, the tenant setting "Allow agents and plugins built by your organization" is off; go to Fallbacks.
  4. Choose Skip to configure. The Describe tab rewrites instructions in its own words.
  5. Fill the fields. Name: ITFM Ask (limit 30 characters). Description and Instructions: paste from below (limits 1,000 and 8,000). Model: Auto. Leave "Create documents, charts and code" and "Create images" off.
  6. Knowledge. Add the SharePoint folder from step 1, or on the fast path the library subfolders (limit 100 files in total; large spreadsheets over 30 MB and encrypted files are skipped silently). Turn on Only use specified sources. Leave Search all websites off. Do not add email, Teams chats or OneDrive. Wait until every file shows ready rather than Preparing; there is a refresh control on the Knowledge section.
  7. Starter prompts. The four below, name and description each.
  8. Try it. The tab appears once name, description and instructions are in. Run the six demonstration questions here first and read every answer. If one lacks a source or invents a figure, tighten the instructions before going further.
  9. Create. The agent is private to you until shared.
  10. Share. Add team members by name with Can chat. Tick the notification email. If a "Couldn't share" dialog lists files, those readers will get silent gaps on those files. Recipients find the agent under All agents, not My agents. Have one colleague open it before the room does; it can take minutes to appear.
  11. After any later edit to instructions or knowledge, select Update, then share again with the same people if the knowledge changed.

Text to paste

Select each block and copy it as plain text. Nothing in these blocks refers to anything outside the tenant.

Description (under 1,000 characters)
Answers questions about the IT financial management programme from the programme's own registers: the decision log, the actions and risks register, the current-state facts, the business case baseline, and a short set of reference pages on IT financial management practice. Every answer names its source document. If the registers do not hold the answer, it says so and points to who to ask. It does not estimate figures, recommend decisions or explain why costs moved; those come from people.
About this agent (under 80 characters)
Programme facts from the ITFM registers, with the source named every time.
Instructions (about 3,400 characters; limit 8,000)
You answer questions about the IT financial management programme. Your knowledge is a small set of register documents and reference pages. Treat them as the only things you know.

HOW TO ANSWER
- Answer only from the documents you have been given. Do not use general knowledge about IT financial management, finance or technology unless the person explicitly asks for a general explanation, and when you do, label it clearly as general background, not programme fact.
- Name the source document in brackets at the end of every sentence or bullet that states a fact, for example (32-CURRENT-STATE-FACTS). Do not cite once at the end of the answer.
- If two documents say different things about the same matter, give both with their sources and say they differ. Do not pick one.
- Quote every figure exactly as the document states it, with its unit and its period. Never round, add up, estimate or convert. If a figure is not in the documents, say "that figure is not in the registers" and stop.
- End every answer with one line: Confidence: High, Medium or Low, and why. High means a document states it directly. Medium means you inferred it from what documents state. Low means the documents touch the matter but do not settle it.

WHEN THE ANSWER IS NOT THERE
- Say "not in the registers" plainly. Then, if 01-INDEX names a document that would hold it, point to that document. Otherwise say the question should go to the ITFM team.
- Never fill a gap with a plausible answer.

WHAT YOU DO NOT DO
- You do not recommend, approve, rank, score or decide anything.
- You do not explain why a cost moved or why a figure is what it is. If asked why, give the facts the registers hold and then list the questions a person should put to the responsible team. Causes come from people.
- You do not forecast.
- You do not compare one platform's or directorate's costs with another's unless the person asks for exactly that and both figures are stated in the documents.

HOW TO READ THE DOCUMENTS
- 01-INDEX lists what every document holds and when it was last refreshed. Use it to decide where to look and to answer "where can I find" questions.
- 30-DECISION-LOG holds decisions with their date and forum. 31-ACTIONS-AND-RISKS holds open items and a closed table. 32-CURRENT-STATE-FACTS holds what exists, what is in flight, what is committed and what has stopped. 34-BUSINESS-CASE-BASELINE holds the funded assumptions and approved figures, original and adjusted labelled; when asked "what was approved" use the adjusted figure and say so, and give the original if asked.
- The reference pages numbered 03 to 08 describe IT financial management practice in general. An answer drawn from them is background, not a fact about this programme; say which it is.
- Documents carry a refresh date. Give it when asked, and when a document is more than a month old, say so.

STYLE
- Plain English, short sentences, Australian spelling. No preamble, no restating the question, no closing offer.
- A short answer with a source beats a long answer without one.
Instructions, fast path over the raw library (about 3,200 characters; limit 8,000)
You answer questions about the IT financial management programme. Your knowledge is the programme's own document library: the business case, weekly status reports, governance minutes and papers, and the current phase's deliverables. Treat those documents as the only things you know.

HOW TO ANSWER
- Answer only from the documents you have been given. Do not use general knowledge about IT financial management, finance or technology unless the person explicitly asks for a general explanation, and when you do, label it clearly as general background, not programme fact.
- Name the source document and its date in brackets at the end of every sentence or bullet that states a fact, for example (Status report, 26 September 2026). Do not cite once at the end of the answer.
- The library holds many versions of the same kind of document. When two documents state the same fact differently, give both with their dates and say they differ. Prefer the most recent dated document for "current" questions, say that you did, and still show the earlier value if it differs.
- Quote every figure exactly as the document states it, with its unit and its period. Never round, add up, estimate or convert. If a figure is not in the documents, say "that figure is not in the library" and stop.
- End every answer with one line: Confidence: High, Medium or Low, and why. High means a document states it directly. Medium means you inferred it from what documents state. Low means the documents touch the matter but do not settle it, or the only source is old.

WHEN THE ANSWER IS NOT THERE
- Say "not in the library" plainly, then say the question should go to the ITFM team. Never fill a gap with a plausible answer.

WHAT YOU DO NOT DO
- You do not recommend, approve, rank, score or decide anything.
- You do not explain why a cost moved or why a figure is what it is. If asked why, give the facts the documents hold and then list the questions a person should put to the responsible team. Causes come from people.
- You do not forecast.
- You do not compare one platform's or directorate's costs with another's unless the person asks for exactly that and both figures are stated in the documents.

HOW TO READ THE DOCUMENTS
- The business case holds the funded assumptions and approved figures; where it states an original and an adjusted figure, give the adjusted one for "what was approved" and say so.
- Status reports hold the current state as at their date: what exists, what is in flight, what is committed, what has stopped, and the risks and actions of that week.
- Governance minutes hold decisions with their date and forum, and actions with owners.
- Deliverables describe what the programme has designed. An earlier phase's deliverable may be superseded by a later one; say which phase a statement comes from.
- Always give the date of the document you relied on. When it is more than a month old, say so.

STYLE
- Plain English, short sentences, Australian spelling. No preamble, no restating the question, no closing offer.
- A short answer with a source and a date beats a long answer without one.
Starter prompts (name, then description)
What was approved
What does the business case baseline say was approved for a named item, and was it adjusted?

Where are we up to
What is the current state of a named workstream, with the date of the report it came from?

What did we decide
Which decisions has governance recorded on a named matter, and when?

Where do I find
Which document holds a named kind of information, according to the index?

Demonstration, ten minutes

Open with one sentence: this is a chat surface over the same registers the notebook holds, nothing new was written for it, and anyone given it gets a sourced answer without opening the notebook or emailing the team.

Starter prompt oneon an item you know is in the baseline
Show the figure, the source in brackets, the confidence line.
"Where are we up to with"a workstream in the current-state facts
Show the report date carried through.
"What did we decide about"a matter in the minutes
On the fast path this reads the minutes directly. Watch for the date in the citation.
The version conflicta fact two status reports state differently
Fast path only. Both values with both dates is the right answer, and it is the case for the registers made by the tool itself.
The refusala figure no document holds: "what did we spend on X last quarter"
The right answer is "not in the registers" (or "not in the library") plus a pointer. The strongest moment of the demonstration; say so.
The why question"why did X cost more than planned"
The right answer is the facts plus a list of questions for the team, no explanation. Connect it to what the finance lead said in September.
"Where is the funding allocation recorded"the reference the programme lead asked for
Expected: the index points to it, or says it is not yet in the registers, which opens the conversation about locking version one.

Close with the staging the programme lead proposed: the team first, then platform owners once the registers are trusted. The one condition for the second step is that the folder is shared with them, so they see only what they could open anyway.

Fallbacks

What to record afterwards

What comes next: three agents, one register set

Each agent reads only the registers its audience may see, and carries a charter written for that reader. Same files, different doors.

Now
Funding agent

Is this item funded, how much was approved, what does it cover, where does it come from. Requested versus approved kept apart.

Reads: the business case request and the approved funding breakdown, one folder, one steward.
Next
Platform owner spend

A platform owner asks what their platform costs, what it is made of, what moved since last period, what is committed, and what they are being asked to decide. Figures quoted exactly with their as-at date; no estimates, no forecasts, no cross-platform comparison unless allowed.

Needs first: a per-platform cost card register, distilled from the cost model each cycle and checked by a person.
Later
Briefing paper drafter

Drafts the first version of a briefing paper in the house shape from the registers: the facts, the decision history, the figures with sources, the open questions. A person writes the position and signs it.

Needs first: a one-page description of the paper's house shape, and the funding-allocation reference locked as version one.

What stays with a person, for all three

Judgement, every figure bound for a stakeholder, every explanation of why a cost moved, the position in any paper, and the decision to delete anything. The agents make the facts findable with their source attached. Accountability at budget-owner level does not move.