Skip to content

docs: add optional Backer Concierge AI Agent exercise (VS Code harness) - #178

Open
juliamuiruri4 wants to merge 3 commits into
mainfrom
vscode-foundry-agent
Open

juliamuiruri4 wants to merge 3 commits into
mainfrom
vscode-foundry-agent

Conversation

@juliamuiruri4

Copy link
Copy Markdown
Collaborator

Summary

Adds a new optional exercise to the VS Code harness where learners build a hosted Microsoft Foundry backer concierge AI agent. This step is clearly positioned as optional — the required workshop path does not depend on it in any way, and learners can stop after Exercise 6.

Type of change

  • Workshop content (lesson Markdown, images)

Verification

  • Type checks and a clean site build pass.
  • Affected pages and translations match their source and intended routes.
  • Offline internal link checks pass.
  • Changed external links have been checked separately.

Screenshots

Backer Concierge chat widget recommending a game

22738d79-161a-40e4-9440-b4d28c4a98ab-tailspin-toys-backer-concierge-agent.mp4

…rness)

Add a new optional lesson to the VS Code harness that walks learners
through the Microsoft Foundry Toolkit: discovering and deploying a
model, scaffolding an agent locally, deploying it as a Foundry hosted
agent, and wiring it into the Tailspin Toys site as a backer concierge
chat widget.

- New lesson: docs/vscode/7-foundry-toolkit.md (title follows the
  harness's 'Exercise N - Title' convention) plus its 9 screenshots
  under docs/_images/.
- Wire the lesson into navigation: sidebar entry and README lesson
  table row ('7. Create a Backer Concierge AI Agent (Optional)'),
  and an explicit non-blocking pointer from Exercise 6's 'Review and
  next steps' section and nav table, so finishing the required
  harness is never gated on the optional lesson.
- Add the standard public-preview/billable-Azure-resources callout
  for consistency with the equivalent app and cli harness lessons.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot AI lite review requested due to automatic review settings September 15, 2026 22:26

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟡 Changes recommended

Unresolved critical and moderate issues affect endpoint security, reproducibility, deployment, and workflow correctness.

Get a fresh assessment by requesting another Copilot review.

Review tier: Lite
Findings: 1 High severity · 4 Medium severity · 3 Low severity

Open (8)
What changed in this PR

Adds an optional VS Code exercise for building a hosted Microsoft Foundry Backer Concierge AI agent. Exercise 6 remains the required workshop endpoint.

Changes:

  • Adds the Foundry Toolkit lesson and agent workflow.
  • Links the optional exercise from the VS Code navigation.
  • Adds the exercise to the website sidebar.
File Reviewed changes
website/​astro.config.mjs Adds Exercise 7 to the VS Code sidebar.
docs/​vscode/​README.md Lists and links the optional exercise.
docs/​vscode/​7-foundry-toolkit.md Adds the agent workflow; findings cover endpoint security, deployment and threading, data/model assumptions, workflow continuity, testing, navigation, accessibility, formatting, and resource-link issues.
docs/​vscode/​6-iterating.md Links to the optional next lesson and identifies Exercise 6 as the required endpoint.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread docs/vscode/7-foundry-toolkit.md Outdated
Comment thread docs/vscode/7-foundry-toolkit.md
Comment thread docs/vscode/7-foundry-toolkit.md Outdated
Comment thread docs/vscode/7-foundry-toolkit.md Outdated
Comment thread docs/vscode/7-foundry-toolkit.md Outdated
Comment thread docs/vscode/7-foundry-toolkit.md Outdated
Comment thread docs/vscode/7-foundry-toolkit.md Outdated
Comment thread docs/vscode/7-foundry-toolkit.md Outdated
Keep model selection region-aware, scope the Functions proxy to local development, add secure conversation handling and end-to-end verification, and align the lesson with Markdown accessibility conventions. Remove the duplicated model recommendation screenshot.\n\nCo-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Comment thread docs/vscode/7-foundry-toolkit.md
Comment thread docs/vscode/7-foundry-toolkit.md Outdated
Comment thread docs/vscode/7-foundry-toolkit.md
Updated prompt details for the Backer Concierge AI agent and modified last updated date.

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🔵 Needs a closer look

The new lesson has four unresolved moderate findings affecting learner execution.

Review tier: Lite
Findings: None

Resolved since last review (3)
Previously missed (1)

In code that hasn't changed since last review

Medium severity Start the Astro site before the final end-to-end check

docs/​vscode/​7-foundry-toolkit.md:341

After the proxy is generated, the lesson only asks Copilot to start the Functions host; it never starts the Astro dev server. Since the preceding exercise does not guarantee that server is still running, the final prompt's requirement to keep both the Function and site running leaves the widget and Playwright check unable to reach a page unless the learner infers an omitted command. Add an explicit npm run dev step in a separate terminal before this verification.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants