Evidence-grounded customer journey

Supplier Claim Engagement Agent

Build this agent step by step, then show it to a customer. Easy mode lets AI do the clicks; Manual mode shows every step yourself.

Get the one-pager and demo video Office hours All solutions

About this workshop

Workshop mission: Turn motivated, open-minded, non-technical sales professionals into AI superheroes who can match the practical output and problem-solving pace of technical peers who are not using AI, while staying evidence-grounded, governed, and honest about what the tools proved.

Boundary: synthetic qualitative evidence only—not a customer KPI, measured production result, live connection, or publication approval.

Found something inaccurate? Use Report an issue at that point. It opens a prefilled GitHub issue for review and does not submit anything automatically.

Self-paced local achievements

Workshop achievements

0 total points 0 in this workshop

0 of 0 Easy checkpoints complete

No badges yet

View achievements and local profile

Optional public verification

These points and badges are local, self-reported workshop progress—not externally verified proof or a capability claim.

This opens one prefilled progress issue containing every badge currently earned here. Nothing syncs until you submit it. Resubmitting later merges newly earned badge IDs without duplicate score, and one public issue submission opts your GitHub account into a public verified profile.

Workshop setup

Open GitHub Copilot Chat

Start in GitHub Copilot Chat. No Frontier desktop app is required; the Easy Mode skill handles any additional setup.

Get ready

Open VS Code with the GitHub Copilot Chat extension installed.
Sign in to GitHub with an account that has Copilot access.
Open the Copilot Chat panel and select Agent mode.

Expected result

GitHub Copilot Chat is open in VS Code, signed in, and set to Agent mode.

I opened GitHub Copilot Chat in Agent mode.

What you will learn

Use the single Easy Mode skill.
Build and prove the portable agent.
Deploy the reviewed solution as an unpublished Draft.
Confirm the behavior yourself in Copilot Studio Preview.
Recognize the evidence that means the module is complete.

Before you begin

Use VS Code with GitHub Copilot Chat in Agent mode.
Sign in to GitHub with Copilot access.
Have access to a Copilot Studio environment.
The skill handles setup for you.
Do not publish. This module ends with a validated Draft.

Easy mode

Prepare your Copilot

Brief your Copilot with one line

One skill owns discovery, testing, Draft deployment, and Preview validation.

Do this

Open GitHub Copilot Chat in VS Code and select Agent mode.
Paste this one line and send it. Copilot reads the skill itself; nothing to download.

Send this message

Go and read https://raw.githubusercontent.com/microsoft/aibast-agents-library/main/skills/aibast-easy-mode/SKILL.md and run the Supplier Claim Engagement workshop for me.

Expected result

Copilot says it has read the skill and is running the workshop. The skill owns the remaining setup and validation.

I sent the one line and Copilot started the workshop.

Prove the solution locally

Ask Easy Mode to build and test Supplier Claim Engagement

This step proves the portable business logic before any Copilot Studio work begins. The harness retrieves the immutable package, verifies the source, loads the agent, and runs every locked case.

Send this message

Give me Supplier Claim Engagement using Easy Mode and test it for me.

Expected result

Copilot reports a verified source and 7/7 locked local cases passed.

Copilot should end by suggesting the next message: Deploy it into Copilot Studio for me.

I saw every locked local case pass.

Create the reviewed Draft

Deploy the already-tested solution to Copilot Studio

The harness now uses the verified Microsoft Copilot Studio plugin to reuse or create the source-controlled Draft, synchronize the reviewed instructions and assets, validate the PAC project, and leave publication off.

Send this message

Deploy it into Copilot Studio for me.

Expected result

Draft: Supplier Claim Manual
Model: Claude Opus 5
Knowledge files: 2
Skills: 7
Status: Draft; published: false

The harness then validates the real Preview front door before returning its final verdict.

I saw the Draft identity and unpublished state.

Verify the real experience

Confirm the Draft in Copilot Studio Preview

The harness already runs these checks automatically. Repeat them here so you understand what was proven and can recognize a correct result yourself.

Open the validated Draft.
Select Preview.
Choose New chat before each case.
Paste the exact prompt.
Compare the answer with the required and forbidden markers.

Open the Copilot Studio Draft ↗

Expected result

Every case passes in a fresh Preview conversation, and the agent still appears as Draft.

SC-01 · Supplier Claims Coordinator

Confirm the expected evidence

Show me our open supplier claims and what needs attention today.

Must include

Open claim value1,631.80CLM-5201

Must not claim

I do not have accessI cannot help

Visible positive anchors: CLM-5201; Open claim value; 1,631.80. The screenshot supports the learner checkpoint; the full case pass remains the deterministic machine gate. Source: 1424×863 JPEG. Download original.

The Preview response matched this contract.

SC-02 · Supplier Claims Coordinator

Confirm the expected evidence

Triage the new damage claim CLM-5201. Who is responsible and what are the terms?

Must include

P2 - HighNorthwind Packaging24 hours

Must not claim

I do not have accessI cannot help

Visible positive anchors: Northwind Packaging; 24 hours. The screenshot supports the learner checkpoint; the full case pass remains the deterministic machine gate. Source: 1424×863 JPEG. Download original.

The Preview response matched this contract.

SC-03 · Receiving Supervisor

Confirm the expected evidence

Is the evidence for CLM-5201 complete, and what is the claim worth?

Must include

Evidence statusRIR-4471591.00

Must not claim

I do not have accessI cannot help

Visible positive anchors: Evidence status; RIR-4471; 591.00. The screenshot supports the learner checkpoint; the full case pass remains the deterministic machine gate. Source: 1424×863 JPEG. Download original.

The Preview response matched this contract.

SC-04 · Supplier Claims Coordinator

Confirm the expected evidence

Draft the claim notice to the supplier for CLM-5201, but don't send it.

Must include

Draft, Not SentApr 15, 2026 10:00Nothing was sent

Must not claim

I do not have accessI cannot help

Visible positive anchors: Draft, Not Sent; Apr 15, 2026 10:00; Nothing was sent. The screenshot supports the learner checkpoint; the full case pass remains the deterministic machine gate. Source: 1424×863 JPEG. Download original.

The Preview response matched this contract.

SC-05 · Claims Team Lead

Confirm the expected evidence

Which supplier claims are at risk of missing their response deadline?

Must include

Breached by 2 hCLM-5203At risk

Must not claim

I do not have accessI cannot help

Visible positive anchors: CLM-5203; Breached by 2 h; At risk. The screenshot supports the learner checkpoint; the full case pass remains the deterministic machine gate. Source: 1424×863 JPEG. Download original.

The Preview response matched this contract.

SC-06 · Supplier Claims Coordinator

Confirm the expected evidence

Litware Snacks replied on CLM-5204. What did they offer, and what's the gap?

Must include

Partial acceptance45.00Unrecovered gap

Must not claim

I do not have accessI cannot help

Visible positive anchors: Partial acceptance; 45.00; Unrecovered gap. The screenshot supports the learner checkpoint; the full case pass remains the deterministic machine gate. Source: 1424×863 JPEG. Download original.

The Preview response matched this contract.

SC-07 · Claims Team Lead

Confirm the expected evidence

Prepare an escalation for the overdue shortage claim CLM-5202.

Must include

Escalation Brief38 hNo escalation or message was sent

Must not claim

I do not have accessI cannot help

Visible positive anchors: Escalation Brief; 38 h; No escalation or message was sent. The screenshot supports the learner checkpoint; the full case pass remains the deterministic machine gate. Source: 1424×863 JPEG. Download original.

The Preview response matched this contract.

Recognize completion

Know what “done” looks like

The workshop is complete only when both the portable agent and the Copilot Studio front door prove the same behavior.

Local proof7/7 locked cases passed

Preview proof7/7 locked cases passed

Draft identitySupplier Claim Manual

ModelClaude Opus 5

Inventory2 knowledge · 7 skills

Publication gateDraft · published false

Positive visual checkpoint. Source: 1424×863 JPEG. Download original.

Final expected verdict

The harness reports status: complete, exact case totals, the Draft identity, and published: false. The module ends here; it does not offer publication.

I confirmed the final Draft verdict.

Troubleshooting

What you see	What it means	What to do
Copilot ignores the workshop	The wrong skill was read, or the chat began before the one line was sent.	Start a new Agent-mode chat and send the one line first.
Local validation is not 7/7	The portable source, package, or locked behavior does not match.	Stop. Do not deploy. Let the harness report the exact failed case and marker.
No active Copilot Studio environment	PAC has no selected environment.	Sign in or select the intended environment, then resend the deploy message.
The Draft already exists	The recorded schema is already in the environment.	The harness should clone and reconnect automatically. Treat an attendee choice prompt as a harness defect.
A Preview case misses a marker	The real front door does not match the reviewed contract.	Keep the case failed. Inspect instructions and assets; do not retry until it happens to pass.
The agent is Published	The workshop crossed its safety boundary.	Stop immediately. The module must end at Draft with `published: false`.

Facilitator evidence and portable download

These links support audit, troubleshooting, and offline delivery. They are not learner steps.

Field guide Locked evidence Evidence report Download audit manifest Download portable bundle Download Copilot Studio solution Deployment settings Export details Download generic workshop agent Download SKILL.md

Manual mode · see how it was built

See how Supplier Claim Engagement Agent is built, one capability at a time.

Optional. Easy mode already did all of this for you from one skill file. This path replays every action the AI took, one real browser frame per step, so you can understand the agent before you adapt it. No PAC CLI, YAML import, or plugin architect; stop at Draft.

Synthetic disclosure: this is qualitative workflow evidence using packaged synthetic inputs. It is not a customer KPI or a live-system result.

Found something inaccurate? Use Report an issue on that step. It opens a prefilled GitHub issue for review and does not submit automatically.

Open standalone Manual-mode guide ↗ Download source bundle Download Copilot Studio solution Deployment settings Export details

0 of 26 complete

Manual-mode progress is saved on this device and contributes to the same achievement profile.

Build and verify

Create a blank Copilot Studio agent

Step 1 of 26

Action

Create a blank Copilot Studio agent

Expected resultA blank Copilot Studio agent is visible in the captured Draft workspace.

Positive visual checkpoint: Untitled Agent. Source capture: 1424×863 JPEG. The full pass remains the deterministic machine gate. Download original.

Name Supplier Claim Manual

Step 2 of 26

Action

Supplier Claim Manual

Name Supplier Claim Manual

Expected resultThe page header shows the recorded manual build name: Supplier Claim Manual.

Positive visual checkpoint: Supplier Claim Manual. Source capture: 1424×863 JPEG. The full pass remains the deterministic machine gate. Download original.

Enter the reviewed global instructions

Step 3 of 26

Action

# Supplier Claim Engagement Agent — Manual Global Instructions

You are a synthetic supplier-claims pilot for a retailer's claims team. Explain the fixed claims snapshot and prepare reviewable drafts without sending, accepting, or escalating anything.

## Fixed synthetic snapshot

- Use only the uploaded Supplier Claim Engagement synthetic records, rules, and seven
packaged skills.
- Fabrikam Grocers and every supplier, purchase order, item, cost, evidence reference, deadline, and response are invented. The fixed demo clock is Apr 14, 2026 10:00.
- Do not browse, consult external sources, or add current-date, market, legal,
or customer facts. Never invent a record, value, deadline, decision, or
transaction.
- Never match a fictional organization, person, or record to a real one or
claim access to a live system.

## Natural-language routing

- Use **supplier claims queue** for: a coordinator asks for open supplier claims, their value and severity, recovery to date, or what needs attention today.
- Use **claim triage** for: a coordinator asks for a claim's severity, responsible supplier, purchase order, and supplier response and resolution windows.
- Use **evidence pack check** for: someone asks which photos and documents a claim needs, what is on file, and the claim value by line.
- Use **supplier claim notice draft** for: a coordinator asks to prepare or draft the claim to a supplier; the notice stays Not Sent with the response dates it would carry.
- Use **response deadline tracker** for: the team asks which claims are breached, at risk, or on track against supplier response windows.
- Use **supplier response evaluation** for: a coordinator asks what a supplier replied or offered and how it compares with the claim value.
- Use **escalation brief draft** for: the team asks to escalate a claim that is past its supplier response window; returns a draft for approval.

## Human and side-effect gates

- Never send a claim, contact a supplier, start a deadline clock, accept or reject a credit, escalate, or change a case.
- Every decision stays with authorized supplier claims coordinators and the claims team lead. Present drafts as drafts.
- Include only the evidence needed for the question.

## Evidence-first response contract

1. Lead with the specific figure, record, or draft status that answers the question.
2. Keep the agent's tables and figures exactly as returned; do not round or recompute.
3. State the recommended next step and who decides it.
4. Make the no-action boundary explicit; never speculate.
5. End substantive answers with: **Synthetic claims evidence only. No claim was sent, no credit was accepted or rejected, and no escalation occurred.**

## Skill routing map

Route from the user's natural-language intent to the correct skill below. Do not narrate internal retrieval, tool selection, restrictions, or implementation mechanics; present only the user-facing result.

- `SC-01` uses skill `claims-queue`.
- `SC-02` uses skill `triage-claim`.
- `SC-03` uses skill `evidence-pack`.
- `SC-04` uses skill `draft-supplier-claim`.
- `SC-05` uses skill `sla-tracker`.
- `SC-06` uses skill `supplier-response`.
- `SC-07` uses skill `escalation-brief`.

These skill names above are the ONLY valid skill identifiers. Never invent, guess, or reference any other skill name. If the correct skill or its knowledge cannot be loaded after one retry in the same turn, say so honestly and stop. Do not answer using values you already know from these instructions or from general knowledge -- a response with no real citation is not acceptable output.

Enter the reviewed global instructions

Expected resultThe reviewed manual/GLOBAL-INSTRUCTIONS.md policy is visible or saved without unrecorded edits.

Positive visual checkpoint: Supplier Claim Engagement Agent — Manual Global . Source capture: 1424×863 JPEG. The full pass remains the deterministic machine gate. Download original.

Save the instruction policy

Step 4 of 26

Action

Save the instruction policy

Expected resultThe reviewed manual/GLOBAL-INSTRUCTIONS.md policy is visible or saved without unrecorded edits.

Positive visual checkpoint: Draft. Source capture: 1424×863 JPEG. The full pass remains the deterministic machine gate. Download original.

Remove default web search

Step 5 of 26

Action

Remove default web search

Expected resultThe captured inventory no longer lists the default web-search capability.

Positive visual checkpoint: Provide trusted context to guide decisions. Source capture: 1424×863 JPEG. The full pass remains the deterministic machine gate. Download original.

Add knowledge: aibast_supplier-claim-engagement-rules-and-guardrails.md

Step 6 of 26

Action

Add knowledge: aibast_supplier-claim-engagement-rules-and-guardrails.md

Expected resultThe exact knowledge file linked for this step is attached under its complete filename. Wait for processing to finish before continuing. This step does not require the final inventory or prove the other uploads.

Positive visual checkpoint: aibast_supplier-claim-engagement-rules-and-guard. Source capture: 1424×863 JPEG. The full pass remains the deterministic machine gate. Download original.

Add knowledge: aibast_supplier-claim-engagement-synthetic-records.md

Step 7 of 26

Action

Add knowledge: aibast_supplier-claim-engagement-synthetic-records.md

Positive visual checkpoint: aibast_supplier-claim-engagement-synthetic-recor. Source capture: 1424×863 JPEG. The full pass remains the deterministic machine gate. Download original.

Add skill: aibast_claims-queue_01

Step 8 of 26

Action

Add skill: aibast_claims-queue_01

Expected resultThe linked SKILL.md appears with its frontmatter name and description. Open it and compare the complete instructions with the source file. This step does not require the final inventory or prove the other uploads.

Positive visual checkpoint: claims-queue. Source capture: 1424×863 JPEG. The full pass remains the deterministic machine gate. Download original.

Add skill: aibast_draft-supplier-claim_04

Step 9 of 26

Action

Add skill: aibast_draft-supplier-claim_04

Positive visual checkpoint: draft-supplier-claim. Source capture: 1424×863 JPEG. The full pass remains the deterministic machine gate. Download original.

Add skill: aibast_escalation-brief_07

Step 10 of 26

Action

Add skill: aibast_escalation-brief_07

Positive visual checkpoint: escalation-brief. Source capture: 1424×863 JPEG. The full pass remains the deterministic machine gate. Download original.

Add skill: aibast_evidence-pack_03

Step 11 of 26

Action

Add skill: aibast_evidence-pack_03

Positive visual checkpoint: evidence-pack. Source capture: 1424×863 JPEG. The full pass remains the deterministic machine gate. Download original.

Add skill: aibast_sla-tracker_05

Step 12 of 26

Action

Add skill: aibast_sla-tracker_05

Positive visual checkpoint: sla-tracker. Source capture: 1424×863 JPEG. The full pass remains the deterministic machine gate. Download original.

Add skill: aibast_supplier-response_06

Step 13 of 26

Action

Add skill: aibast_supplier-response_06

Positive visual checkpoint: supplier-response. Source capture: 1424×863 JPEG. The full pass remains the deterministic machine gate. Download original.

Action

Confirm Draft and stop before publish

Expected resultThe agent remains Draft and no Publish action is taken.

Positive visual checkpoint: Supplier Claim Manual. Source capture: 1424×863 JPEG. The full pass remains the deterministic machine gate. Download original.

Manual-mode troubleshooting

A screenshot or browserfilm frame is missing

Stop. Do not invent, recreate, or substitute an image. Capture the real frame, update the browserfilm manifest, and regenerate without --allow-pending.

A knowledge file is still processing

Wait for ingestion to finish before Preview. A partial answer is not evidence.

A skill upload fails

Use the linked raw SKILL.md. Fix the reviewed source deliberately; do not silently skip the action.

The model differs from Easy mode

Record the substitution and stop the parity claim until Easy and Manual use the same reviewed model.

The Preview answer misses an identifier

Mark the recorded case failed, inspect instructions and inventory, then replay the exact prompt in a fresh conversation.

Should I publish?

No. Keep this manual duplicate in Draft unless publication is separately approved. Do not choose Publish as part of this tutorial.