From 6a1609e4659bdcf903872f28741f0845ded6b68f Mon Sep 17 00:00:00 2001 From: Alejandro Lopez Date: Tue, 21 Jul 2026 08:11:01 -0500 Subject: [PATCH 1/4] Redesign FastTrack landing page + add metadata-driven catalog pipeline (#48) Promote the new Linear-style resource catalog to the site root (index.html) and introduce a front-matter -> catalog.json -> site data pipeline so contributions flow efficiently into both the repo and the page. Site (index.html) - Modern, filterable catalog: comfortable + compact (table) densities, whole-card navigation, per-resource detail pages (what it is / why use it / how to use / prerequisites / author / version). - Engagement layer: views + upvotes with Popular / Trending / New / Engaging sorts. Microsoft branding, service description + contact links. - Microsoft Clarity analytics preserved; reduced-motion respected. Metadata pipeline - YAML front-matter in each resource README (authorship + semver versioning; git history is authoritative). - tools/catalog-build generator produces catalog.json (schema in docs/CATALOG-METADATA.md); the site fetches it at runtime. - .github/workflows/build-catalog.yml validates front-matter on PRs and regenerates catalog.json on push to master. - CONTRIBUTING.md + TEMPLATE-README.md updated with the new requirements. - Seeded front-matter across 30 resources. Copilot-Session: b0067184-a71b-474a-98d0-6d8009659085 Co-authored-by: soyalejolopez <88358406+soyalejolopez@users.noreply.github.com> Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- .github/workflows/build-catalog.yml | 65 + .gitignore | 1 + .nojekyll | 0 CONTRIBUTING.md | 80 +- TEMPLATE-README.md | 69 +- catalog.json | 1089 ++++++ .../da-CompareDocs/README.md | 27 + .../da-DeepResearch/README.md | 27 + .../da-ManagerSimulator/README.md | 28 + .../da-OmniAgent/README.md | 27 + .../da-ReasoningAgent/README.md | 27 + .../da-VibeWritingAgent/README.md | 33 + .../ca-AutoReplyAgent/README.md | 34 + .../ca-PowerClawAgent/README.md | 36 + .../ca-ProductQuoteAgent/README.md | 41 + .../github-copilot-agents/Council/README.md | 41 + .../copilot-studio-workflow/README.md | 46 + .../copilot-agent-brainstorm/README.md | 32 + .../copilot-agents-cost-tool/README.md | 33 + .../copilot-agents-guide/README.md | 32 + .../Copilot_Audit_PBI/README.md | 36 + .../README.md | 32 + .../copilot-interaction-report/README.md | 41 + .../Researcher-OrganizationInsights.md | 32 + docs/CATALOG-METADATA.md | 100 + index.html | 3425 +++++++++++------ scripts/Analyze-SharePointRisk/README.md | 37 + scripts/Create-EngageCommunities/README.md | 30 + scripts/Export-CopilotInteractions/README.md | 42 + scripts/Export-M365CopilotReports/README.md | 31 + scripts/Get-AADAdminRoleMembers/README.md | 34 + scripts/Get-LicenseUsage/README.md | 34 + scripts/Get-M365CopilotReadiness/README.md | 44 + scripts/Get-TeamsUserActivityReport/README.md | 32 + scripts/Migrate-CopilotStudioAgents/README.md | 39 + scripts/Preflight-OneDrive/README.md | 33 + scripts/Teams Phone User Migration/README.md | 33 + scripts/get-siteinventory/README.md | 33 + tools/catalog-build/README.md | 20 + tools/catalog-build/index.js | 246 ++ tools/catalog-build/package-lock.json | 164 + tools/catalog-build/package.json | 14 + 42 files changed, 5004 insertions(+), 1296 deletions(-) create mode 100644 .github/workflows/build-catalog.yml create mode 100644 .nojekyll create mode 100644 catalog.json create mode 100644 docs/CATALOG-METADATA.md create mode 100644 tools/catalog-build/README.md create mode 100644 tools/catalog-build/index.js create mode 100644 tools/catalog-build/package-lock.json create mode 100644 tools/catalog-build/package.json diff --git a/.github/workflows/build-catalog.yml b/.github/workflows/build-catalog.yml new file mode 100644 index 00000000..68911d5e --- /dev/null +++ b/.github/workflows/build-catalog.yml @@ -0,0 +1,65 @@ +name: Build catalog + +on: + pull_request: + paths: + - "scripts/**" + - "copilot-agent-samples/**" + - "copilot-agent-strategy/**" + - "copilot-analytics-samples/**" + - "copilot-prompt-samples/**" + - "tools/catalog-build/**" + - "docs/CATALOG-METADATA.md" + - ".github/workflows/build-catalog.yml" + push: + branches: + - master + +permissions: + contents: write + +jobs: + validate: + if: github.event_name == 'pull_request' + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v4 + with: + fetch-depth: 0 # Updated dates can fall back to Git history. + - uses: actions/setup-node@v4 + with: + node-version: 20 + cache: npm + cache-dependency-path: tools/catalog-build/package-lock.json + - run: npm ci + working-directory: tools/catalog-build + - run: npm run check + working-directory: tools/catalog-build + + publish: + if: github.event_name == 'push' && github.actor != 'github-actions[bot]' + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v4 + with: + fetch-depth: 0 + - uses: actions/setup-node@v4 + with: + node-version: 20 + cache: npm + cache-dependency-path: tools/catalog-build/package-lock.json + - run: npm ci + working-directory: tools/catalog-build + - run: npm run build + working-directory: tools/catalog-build + - name: Commit generated catalog + run: | + if git diff --quiet -- catalog.json design-concepts/catalog.json; then + echo "Catalog is already current." + exit 0 + fi + git config user.name "github-actions[bot]" + git config user.email "41898282+github-actions[bot]@users.noreply.github.com" + git add catalog.json design-concepts/catalog.json + git commit -m "chore: rebuild catalog" + git push diff --git a/.gitignore b/.gitignore index ba698c7d..e791bd71 100644 --- a/.gitignore +++ b/.gitignore @@ -1 +1,2 @@ .vscode/launch.json +node_modules/ diff --git a/.nojekyll b/.nojekyll new file mode 100644 index 00000000..e69de29b diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 71ec7dc2..991d143b 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,35 +1,73 @@ # Contribute to Microsoft FastTrack -Thank you for your interest in contributing to Microsoft FastTrack's open source program! This article outlines the guidance you should follow to ensure we can accept your contribution. If you have any questions please open an issue so we help get things sorted. +Thank you for contributing to the Microsoft FastTrack public catalog. Keep each pull request focused on one resource, bug fix, or documentation change. If you have questions, open an issue before investing in a large contribution. -## All Contributions +## Before you start -The details in this section apply to all contributions. +- Create a topic branch; pull requests from `master` are not accepted. +- Sync your branch with the current `master` before opening the pull request. +- Do not include personal data, customer-specific information, credentials, or other private details. +- Do not include software, dependencies, or copied code that conflicts with the repository licenses. +- Put scripts in a slug-cased folder under `scripts/`. Follow the existing content-root structure for agents, strategy resources, analytics, prompts, and skills. -* Create a branch for you contributions, we will not accept contributions from a MASTER branch [How-To](https://help.github.com/articles/creating-and-deleting-branches-within-your-repository/) | [Why](https://guides.github.com/introduction/flow/index.html) -* Before sending a pull request, please sync/update your branch with our master HEAD -* Contributions MUST NOT contain any PII, company specific information, or other private details -* Contributions MUST NOT contain any software, references, dependencies, or "copied" code that would break our [license](LICENSE) -* Each PR should contain one thing - a bug fix, new script, new sample, etc +## Resource README and catalog metadata -## New Samples & Scripts +Every catalog resource needs a `README.md` that explains what the resource does and how to install or use it. Start from [TEMPLATE-README.md](TEMPLATE-README.md). -* Include sufficient detail so we can understand what is being added by completing the PR template -* Scripts and Samples MUST include a README.md that describes the contents and how to install/run, see the [template](TEMPLATE-README.md) to get started -* Scripts should be added in their own folder to the scripts folder -* Samples should be added in their own folder to the samples folder -* For large samples or scripts please open an issue before you start to discuss so we can ensure your work is appropriate before you invest the time -* Folder names should be "slug cased" (ex: my-cool-script) and be descriptive but not overly long +The README must begin with YAML front matter that follows [the catalog metadata schema](docs/CATALOG-METADATA.md). The catalog uses this metadata for cards and detail pages. In particular: -## New Tools +- Keep `summary` at 140 characters or fewer. +- Write concrete `whatItIs`, `whyUseIt`, and `howToUse` content based on the resource. +- Use `status: preview` for resources that are not production-ready and `status: archived` for retained historical resources. +- Never edit `catalog.json` or the site resource list by hand. -* Tools are defined as applications or "something" more than a script. Usually they are compiled and have releases -* Tools generally go into their own repo, which we need to create. Please open an issue to discuss adding a new tool +## Authorship -## Bug Fixes +- Set `author` to the original author, a list of authors, or `Microsoft FastTrack` for a team-owned resource. +- When an update adds substantial work by another contributor, add that contributor to the `author` list. +- Do not replace existing authors when adding a co-author. +- Git commit and pull-request history remain the authoritative authorship and version audit trail. -* Please complete the issue template and describe the bug you are fixing with enough detail we can test your change -* If you find a bug, please open an issue first and mention you are working on a fix so we avoid duplicating work +## Versioning +Resources use [Semantic Versioning](https://semver.org/) in `MAJOR.MINOR.PATCH` form: +- **PATCH** (`1.0.0` → `1.0.1`): bug fixes, corrections, and documentation-only changes. +- **MINOR** (`1.0.0` → `1.1.0`): new backward-compatible capabilities or meaningful enhancements. +- **MAJOR** (`1.0.0` → `2.0.0`): breaking changes, incompatible behavior, or a substantial rewrite. +For every resource change: + +1. Bump `version`. +2. Set `updated` to the date of the change. +3. Keep `published` as the original publication date. +4. For non-trivial resources, add or update a `CHANGELOG.md` in the resource folder. + +## How the catalog updates + +The catalog is generated from README front matter: + +1. A pull-request workflow runs `npm run check` in `tools/catalog-build` and reports all invalid metadata. +2. After merge to `master`, the workflow regenerates `catalog.json` and its static-site copy. +3. The catalog site fetches that generated JSON at runtime. + +Contributors update only their resource files. The workflow handles the catalog output. + +## Pull request checklist + +- [ ] The change contains no private, customer-specific, or unlicensed content. +- [ ] The resource is in the correct slug-cased folder and has a complete README. +- [ ] README front matter passes the [metadata schema](docs/CATALOG-METADATA.md). +- [ ] `author` includes the original author and any substantial co-authors. +- [ ] `version` and `updated` were bumped; `published` was preserved for updates. +- [ ] Installation and usage steps were tested. +- [ ] `CHANGELOG.md` was updated when appropriate. +- [ ] The pull request contains one focused contribution. + +## Tools + +Tools are compiled applications or projects larger than a script. They generally belong in their own repository. Open an issue before adding a new tool. + +## Bug fixes + +Open or reference an issue describing the bug and include enough detail for reviewers to reproduce and test the fix. diff --git a/TEMPLATE-README.md b/TEMPLATE-README.md index 88667243..f6807c1e 100644 --- a/TEMPLATE-README.md +++ b/TEMPLATE-README.md @@ -1,37 +1,66 @@ -_PLEASE COMPLETE THIS README TEMPLATE FOR YOUR CONTRIBUTION. IT SHOULD BE PLACED IN THE ROOT OF YOUR FOLDER AND BE RENAMED "README.md". ONCE COMPLETE PLEASE DELETE ALL OF THESE INSTRUCTIONS_ - -# Microsoft FastTrack Open Source - _YOUR TITLE HERE_ - -_INTRODUCTION TO THIS TOOL/REPO_ +--- +# Required catalog metadata. See docs/CATALOG-METADATA.md. +title: "Your resource title" +type: script # script | agent | strategy | analytics | prompt | skill +category: "PowerShell" # Short catalog sub-label, such as Copilot Studio or Power BI +summary: "Describe the resource and its outcome in 140 characters or fewer." +author: + - "Your Name" +version: 1.0.0 +published: 2026-01-01 +updated: 2026-01-01 + +# Recommended discovery metadata. +tags: + - example +format: ps1 # ps1 | bundle | declarative | interactive | pptx | pbix | md +featured: false +status: active # active | preview | archived + +# Detail-page content. Use YAML block scalars for paragraphs and Markdown. +whatItIs: >- + Explain what this resource is, what it produces, and the problem it addresses. +whyUseIt: + - "State a concrete outcome or when-to-use scenario." + - "State another verified benefit." +howToUse: |- + 1. Install or download the resource. + 2. Configure the prerequisites described below. + 3. Run the resource: + + ```powershell + .\Your-Script.ps1 + ``` +prerequisites: + - "List required products, permissions, modules, or licenses." +# url: "https://github.com/microsoft/FastTrack/tree/master/path/to/resource" +--- + +# Microsoft FastTrack Open Source - Your resource title + +Introduce the resource, the problem it solves, and its intended audience. ## Usage -_PROVIDE DETAILED GUIDE TO INSTALL AND USE THIS TOOL/SCRIPT/SAMPLE. INCLUDE ANY OPTIONS, CONFIGURATION, ERROR HANDLING, ETC. YOU CAN LINK TO SUPPORTING BLOG POSTS OR OTHER RESOURCES, BUT THIS SECTION MUST CONTAIN ALL THE DETAILS REQUIRED TO RUN THE TOOL._ +Provide a complete installation and usage guide. Include configuration, options, expected output, and important error handling. You may link to supporting material, but this section must contain enough detail to use the resource. ## Applies To -_IN THIS SECTION LIST THE ENVIRONMENT(S) WHERE THIS TOOL IS USEFUL_ - -- SharePoint 2010 -- SharePoint 2013 -- SharePoint Online +- List the applicable Microsoft products and environments. ## Author -_UPDATE TABLE BELOW_ +Keep this human-readable table aligned with the front-matter authors. -|Author|Original Publish Date -|----|-------------------------- -|_YOUR NAME_|_DATE ORIGINALLY PUBLISHED_| +| Author | Original Publish Date | +| --- | --- | +| Your Name | YYYY-MM-DD | ## Issues -Please report any issues you find to the [issues list](/issues). - -_ENSURE THE ISSUES LINK ABOVE IS CORRECT. ADD EXTRA ISSUE DETAILS, IF APPLICABLE. EXAMPLE: "IF YOU GET ERROR X, ENSURE YOU DID CONFIGURATION Y" - +Please report any issues you find to the [issues list](https://github.com/microsoft/FastTrack/issues). -_DO NOT DELETE/ALTER THE SECTIONS BELOW_ + ## Support Statement diff --git a/catalog.json b/catalog.json new file mode 100644 index 00000000..1a3d5bb5 --- /dev/null +++ b/catalog.json @@ -0,0 +1,1089 @@ +{ + "generatedAt": "2026-07-20T21:51:00.845Z", + "count": 30, + "resources": [ + { + "name": "Agent Brainstorming Template", + "title": "Agent Brainstorming Template", + "slug": "agent-brainstorming-template", + "type": "strategy", + "subcategory": "PowerPoint", + "category": "PowerPoint", + "description": "Map an agent’s type, user flow, knowledge sources, tools, and target problem before implementation.", + "summary": "Map an agent’s type, user flow, knowledge sources, tools, and target problem before implementation.", + "tags": [ + "template", + "planning", + "powerpoint" + ], + "artifact": "pptx", + "format": "pptx", + "featured": false, + "status": "active", + "author": "Microsoft FastTrack", + "version": "1.0.0", + "published": "2025-06-18", + "updated": "2025-10-28", + "whatItIs": "A one-slide PowerPoint planning template for visualizing the user-to-agent flow, selected agent type, knowledge sources, tools, and target problem.", + "whyUseIt": [ + "Align stakeholders on a simple agent design before building.", + "Identify the minimum knowledge and tools required for the primary scenario.", + "Keep implementation focused on a clearly mapped user flow." + ], + "howToUse": "1. Download `Copilot Agent Brainstorming.pptx` from this folder.\n2. Select the intended agent type.\n3. Fill in the user input, agent process, knowledge source, tool, and problem statement.\n4. Review the slide with stakeholders and keep it as a build reference.", + "prerequisites": [ + "Microsoft PowerPoint or a compatible presentation editor" + ], + "url": "https://github.com/microsoft/FastTrack/tree/master/copilot-agent-strategy/copilot-agent-brainstorm", + "source": "copilot-agent-strategy/copilot-agent-brainstorm/README.md" + }, + { + "name": "Agents Cost Calculator", + "title": "Agents Cost Calculator", + "slug": "agents-cost-calculator", + "type": "strategy", + "subcategory": "Interactive", + "category": "Interactive", + "description": "Estimate test and production costs for Copilot Studio, Agent Builder, SharePoint, and Foundry agents.", + "summary": "Estimate test and production costs for Copilot Studio, Agent Builder, SharePoint, and Foundry agents.", + "tags": [ + "cost", + "roi", + "calculator" + ], + "artifact": "interactive", + "format": "interactive", + "featured": true, + "status": "active", + "author": "Microsoft FastTrack", + "version": "1.0.0", + "published": "2026-04-01", + "updated": "2026-07-16", + "whatItIs": "A self-contained browser calculator for modeling Copilot Credits or token-based costs across custom, Agent Builder, SharePoint, and Microsoft Foundry agents.", + "whyUseIt": [ + "Trace per-turn costs before testing or production rollout.", + "Compare pay-as-you-go, capacity, model, knowledge, tool, and conversation assumptions.", + "Export a scenario to CSV or print a shareable planning snapshot." + ], + "howToUse": "Open `index.html` in a browser, select an agent type, and optionally load a quick-start template. Enter knowledge, component, conversation, test-scale, or token assumptions, then review the cost trace and production estimate. Export CSV or print the results.", + "prerequisites": [ + "Modern web browser", + "Current licensing and pricing inputs for planning validation" + ], + "url": "https://github.com/microsoft/FastTrack/tree/master/copilot-agent-strategy/copilot-agents-cost-tool", + "source": "copilot-agent-strategy/copilot-agents-cost-tool/README.md" + }, + { + "name": "AI Council", + "title": "AI Council", + "slug": "ai-council", + "type": "agent", + "subcategory": "GitHub Copilot", + "category": "GitHub Copilot", + "description": "Run Claude, GPT, and Gemini in parallel to surface consensus, disagreements, and a synthesized decision recommendation.", + "summary": "Run Claude, GPT, and Gemini in parallel to surface consensus, disagreements, and a synthesized decision recommendation.", + "tags": [ + "multi-model", + "decision", + "deliberation" + ], + "artifact": "bundle", + "format": "bundle", + "featured": true, + "status": "active", + "author": "Alejandro Lopez", + "version": "1.0.0", + "published": "2026-03-04", + "updated": "2026-03-18", + "whatItIs": "A GitHub Copilot CLI agent that delegates a question to Claude, GPT, and Gemini, synthesizes their positions, and can save a Markdown and HTML decision package.", + "whyUseIt": [ + "Expose model disagreements and assumptions before making consequential decisions.", + "Choose quick, debate, or multi-round deep deliberation based on the stakes.", + "Create a shareable decision record with consensus, tensions, votes, and an interactive dashboard." + ], + "howToUse": "1. In a terminal, install the marketplace plugin:\n\n ```text\n copilot plugin marketplace add microsoft/FastTrack\n copilot plugin install council@fasttrack-copilot-plugins\n ```\n2. Run `copilot`, choose **AI Council** from `/agent`, and ask a question.\n3. Add `--depth deep`, `--domain `, or `--save` when needed.", + "prerequisites": [ + "GitHub Copilot CLI", + "Active Copilot subscription with access to multiple models", + "Copilot CLI plugin support" + ], + "url": "https://github.com/microsoft/FastTrack/tree/master/copilot-agent-samples/github-copilot-agents/Council", + "source": "copilot-agent-samples/github-copilot-agents/Council/README.md" + }, + { + "name": "Analyze-SharePointRisk", + "title": "Analyze-SharePointRisk", + "slug": "analyze-sharepointrisk", + "type": "script", + "subcategory": "PowerShell", + "category": "PowerShell", + "description": "Score SharePoint permissions-report data for oversharing risk and generate interactive analysis and remediation guidance.", + "summary": "Score SharePoint permissions-report data for oversharing risk and generate interactive analysis and remediation guidance.", + "tags": [ + "sharepoint", + "security" + ], + "artifact": "ps1", + "format": "ps1", + "featured": false, + "status": "active", + "author": "John Cummings", + "version": "1.0.0", + "published": "2025-10-16", + "updated": "2025-10-23", + "whatItIs": "A PowerShell analyzer for SharePoint Advanced Management Site Permissions Report CSVs that creates prioritized risk and remediation HTML reports.", + "whyUseIt": [ + "Apply configurable risk scoring to broad access, anonymous links, sensitivity labels, and permission complexity.", + "Search, filter, sort, and export findings from an interactive report.", + "Use a separate seven-step guidance page to plan remediation." + ], + "howToUse": "Generate and download a **Site permissions report** from SharePoint Advanced Management, then run:\n\n```powershell\n.\\Analyze-SharePointRisk.ps1 -CsvPath \".\\your-permissions-report.csv\"\n```\n\nAdjust the interactive scoring if needed and review the generated analysis and guidance pages.", + "prerequisites": [ + "PowerShell 5.1 or later", + "SharePoint Advanced Management Site Permissions Report CSV" + ], + "url": "https://github.com/microsoft/FastTrack/tree/master/scripts/Analyze-SharePointRisk", + "source": "scripts/Analyze-SharePointRisk/README.md" + }, + { + "name": "AutoReply Agent", + "title": "AutoReply Agent", + "slug": "autoreply-agent", + "type": "agent", + "subcategory": "Copilot Studio", + "category": "Copilot Studio", + "description": "Research incoming email questions against trusted sources and draft thoughtful replies for review.", + "summary": "Research incoming email questions against trusted sources and draft thoughtful replies for review.", + "tags": [ + "email", + "research", + "automation" + ], + "artifact": "bundle", + "format": "bundle", + "featured": false, + "status": "active", + "author": [ + "Alejandro Lopez", + "Shervin Shaffie" + ], + "version": "1.0.0", + "published": "2025-06-17", + "updated": "2025-08-06", + "whatItIs": "An autonomous Copilot Studio pattern that triggers on new mail, researches the questions against configured knowledge, and emails a draft response to the owner.", + "whyUseIt": [ + "Reduce time spent researching repetitive questions in individual or shared mailboxes.", + "Keep answers grounded in explicitly configured knowledge sources.", + "Review a prepared response before replying to the original sender." + ], + "howToUse": "1. Create the Copilot Studio agent with the instructions in this README.\n2. Add the `Send an email (V2)` tool and `When a new email arrives (V3)` trigger.\n3. Configure trusted knowledge sources and an inbox rule that prevents test-message loops.\n4. Test with a non-production mailbox before broader use.", + "prerequisites": [ + "Microsoft Copilot Studio", + "Power Automate", + "Exchange Online mailbox" + ], + "url": "https://github.com/microsoft/FastTrack/tree/master/copilot-agent-samples/copilot-studio-agents/ca-AutoReplyAgent", + "source": "copilot-agent-samples/copilot-studio-agents/ca-AutoReplyAgent/README.md" + }, + { + "name": "CompareDocs", + "title": "CompareDocs", + "slug": "comparedocs", + "type": "agent", + "subcategory": "Agent Builder", + "category": "Agent Builder", + "description": "Compare two documents and surface meaningful differences.", + "summary": "Compare two documents and surface meaningful differences.", + "tags": [ + "documents", + "comparison" + ], + "artifact": "declarative", + "format": "declarative", + "featured": false, + "status": "archived", + "author": "Microsoft FastTrack", + "version": "1.0.0", + "published": "2025-04-11", + "updated": "2026-05-19", + "whatItIs": "An archived Agent Builder sample retained for historical reference. The active README links to the preserved files under the adjacent archive folder.", + "whyUseIt": [ + "Review an earlier declarative-agent pattern for reference.", + "Understand the scope of a retired FastTrack sample before choosing a current alternative." + ], + "howToUse": "Follow the archive link in this README to inspect the preserved `CompareDocs` sample. It is no longer actively promoted for new deployments.", + "prerequisites": [ + "Treat as historical guidance; validate current platform support before reuse" + ], + "url": "https://github.com/microsoft/FastTrack/tree/master/copilot-agent-samples/agent-builder-agents/da-CompareDocs", + "source": "copilot-agent-samples/agent-builder-agents/da-CompareDocs/README.md" + }, + { + "name": "Copilot Agents Guide", + "title": "Copilot Agents Guide", + "slug": "copilot-agents-guide", + "type": "strategy", + "subcategory": "Interactive", + "category": "Interactive", + "description": "Compare Microsoft Copilot agent platforms with capability views, decision guidance, support indicators, and scenarios.", + "summary": "Compare Microsoft Copilot agent platforms with capability views, decision guidance, support indicators, and scenarios.", + "tags": [ + "guide", + "decision", + "planning" + ], + "artifact": "interactive", + "format": "interactive", + "featured": true, + "status": "active", + "author": "Microsoft FastTrack", + "version": "3.0.0", + "published": "2025-10-28", + "updated": "2026-04-17", + "whatItIs": "A self-contained interactive web guide that compares Microsoft Copilot agent types across capabilities, constraints, technical effort, cost, and FastTrack support.", + "whyUseIt": [ + "Shortlist an agent platform based on use case, team skills, budget, timeline, and growth.", + "Compare capabilities and limitations side by side before committing to a build path.", + "Give business, architecture, and development stakeholders a shared decision framework." + ], + "howToUse": "Open `index.html` directly in a modern browser. To host locally, run `python -m http.server 8000` from the resource folder and browse to `http://localhost:8000/index.html`. Use the Overview, Capabilities, Comparison, and Guidance tabs.", + "prerequisites": [ + "Modern web browser" + ], + "url": "https://github.com/microsoft/FastTrack/tree/master/copilot-agent-strategy/copilot-agents-guide", + "source": "copilot-agent-strategy/copilot-agents-guide/README.md" + }, + { + "name": "Copilot Interaction Report", + "title": "Copilot Interaction Report", + "slug": "copilot-interaction-report", + "type": "analytics", + "subcategory": "PowerShell + Graph", + "category": "PowerShell + Graph", + "description": "Export Copilot interaction history from Microsoft Graph and build a self-contained HTML usage dashboard without Power BI.", + "summary": "Export Copilot interaction history from Microsoft Graph and build a self-contained HTML usage dashboard without Power BI.", + "tags": [ + "graph", + "powershell", + "dashboard" + ], + "artifact": "ps1", + "format": "ps1", + "featured": true, + "status": "active", + "author": "Dean Cron", + "version": "1.0.0", + "published": "2026-06-10", + "updated": "2026-06-10", + "whatItIs": "A PowerShell module and entry script that export per-user Microsoft 365 Copilot interaction history from Graph and render a self-contained HTML dashboard.", + "whyUseIt": [ + "Create an adoption and friction report without Power BI or a database.", + "Review users, sessions, surfaces, features, error rates, trends, and recent audited events.", + "Authenticate app-only with a client secret or certificate and rebuild reports from cached JSON." + ], + "howToUse": "1. Register an Entra application and grant the documented application permissions with admin consent.\n2. From PowerShell 7, run `New-CopilotInteractionReport.ps1` with tenant, client, and secret or certificate parameters.\n3. Open the generated `copilot-report.html`; use `-SkipExport` to rebuild from existing JSON.", + "prerequisites": [ + "PowerShell 7 or later", + "Entra app registration", + "AiEnterpriseInteraction.Read.All, User.Read.All, and Organization.Read.All application permissions", + "Microsoft 365 Copilot licensed users" + ], + "url": "https://github.com/microsoft/FastTrack/tree/master/copilot-analytics-samples/copilot-interaction-report", + "source": "copilot-analytics-samples/copilot-interaction-report/README.md" + }, + { + "name": "Copilot Studio Workflow", + "title": "Copilot Studio Workflow", + "slug": "copilot-studio-workflow", + "type": "skill", + "subcategory": "GitHub Copilot", + "category": "GitHub Copilot", + "description": "Use source control, local YAML, preflight checks, and repeatable packaging to build Copilot Studio agents like software.", + "summary": "Use source control, local YAML, preflight checks, and repeatable packaging to build Copilot Studio agents like software.", + "tags": [ + "devops", + "copilot-studio", + "packaging" + ], + "artifact": "bundle", + "format": "bundle", + "featured": true, + "status": "active", + "author": "Microsoft FastTrack", + "version": "1.0.0", + "published": "2026-04-10", + "updated": "2026-04-13", + "whatItIs": "An Agent Skills-compatible workflow with scripts and guidance for pulling, editing, validating, pushing, publishing, and packaging Copilot Studio YAML projects.", + "whyUseIt": [ + "Keep Copilot Studio definitions in Git and review intentional source changes.", + "Catch dirty workflow files, missing variables, and solution-membership gaps before deployment.", + "Reuse known workarounds for common pull, push, packaging, and environment-portability problems." + ], + "howToUse": "Install with:\n\n```text\ncopilot plugin install microsoft/FastTrack:copilot-agent-samples/github-copilot-skills/copilot-studio-workflow\n```\n\nThen ask Copilot to pull, validate, push, or package a Copilot Studio project. Run the included preflight and status scripts when prompted.", + "prerequisites": [ + "Git", + "VS Code with the Copilot Studio extension", + "PowerShell", + "Copilot Studio-enabled Power Platform environment", + "Power Platform CLI recommended" + ], + "url": "https://github.com/microsoft/FastTrack/tree/master/copilot-agent-samples/github-copilot-skills/copilot-studio-workflow", + "source": "copilot-agent-samples/github-copilot-skills/copilot-studio-workflow/README.md" + }, + { + "name": "Create-EngageCommunities", + "title": "Create-EngageCommunities", + "slug": "create-engagecommunities", + "type": "script", + "subcategory": "PowerShell", + "category": "PowerShell", + "description": "Bulk-create up to 50 sample Viva Engage communities from JSON and assign a chosen or random owner.", + "summary": "Bulk-create up to 50 sample Viva Engage communities from JSON and assign a chosen or random owner.", + "tags": [ + "viva-engage", + "provisioning" + ], + "artifact": "ps1", + "format": "ps1", + "featured": false, + "status": "preview", + "author": "Dean Cron", + "version": "1.0.0", + "published": "2023-12-22", + "updated": "2025-10-02", + "whatItIs": "A non-production PowerShell sample that calls the Microsoft Graph community-creation API to create Viva Engage communities from a JSON input file.", + "whyUseIt": [ + "Demonstrate the community-creation API with repeatable sample data.", + "Assign one specified owner or select random owners for generated communities." + ], + "howToUse": "Configure the app-registration values in the script, prepare a JSON file of community names and descriptions, then run `./Create-EngageCommunities.ps1 -InputFile C:\\Temp\\communities.json -NumberofCommunities 25 -AssignedOwner \"user@domain.com\"`.", + "prerequisites": [ + "Entra app registration", + "Community.ReadWrite.All and User.Read.All application permissions", + "JSON file containing community names and descriptions" + ], + "url": "https://github.com/microsoft/FastTrack/tree/master/scripts/Create-EngageCommunities", + "source": "scripts/Create-EngageCommunities/README.md" + }, + { + "name": "DeepResearch", + "title": "DeepResearch", + "slug": "deepresearch", + "type": "agent", + "subcategory": "Agent Builder", + "category": "Agent Builder", + "description": "Preserved archived sample for structured, multi-step research across source material.", + "summary": "Preserved archived sample for structured, multi-step research across source material.", + "tags": [ + "research", + "analysis" + ], + "artifact": "declarative", + "format": "declarative", + "featured": false, + "status": "archived", + "author": "Microsoft FastTrack", + "version": "1.0.0", + "published": "2025-01-28", + "updated": "2026-05-19", + "whatItIs": "An archived Agent Builder sample retained for historical reference. The active README links to the preserved files under the adjacent archive folder.", + "whyUseIt": [ + "Review an earlier declarative-agent pattern for reference.", + "Understand the scope of a retired FastTrack sample before choosing a current alternative." + ], + "howToUse": "Follow the archive link in this README to inspect the preserved `DeepResearch` sample. It is no longer actively promoted for new deployments.", + "prerequisites": [ + "Treat as historical guidance; validate current platform support before reuse" + ], + "url": "https://github.com/microsoft/FastTrack/tree/master/copilot-agent-samples/agent-builder-agents/da-DeepResearch", + "source": "copilot-agent-samples/agent-builder-agents/da-DeepResearch/README.md" + }, + { + "name": "Export-CopilotInteractions", + "title": "Export-CopilotInteractions", + "slug": "export-copilotinteractions", + "type": "script", + "subcategory": "PowerShell", + "category": "PowerShell", + "description": "Export user-level Copilot prompts and responses from Microsoft Graph into analysis-ready CSV datasets.", + "summary": "Export user-level Copilot prompts and responses from Microsoft Graph into analysis-ready CSV datasets.", + "tags": [ + "copilot", + "graph" + ], + "artifact": "ps1", + "format": "ps1", + "featured": false, + "status": "active", + "author": "Alejandro Lopez", + "version": "1.0.0", + "published": "2026-05-21", + "updated": "2026-05-21", + "whatItIs": "A PowerShell exporter for Microsoft 365 Copilot enterprise interaction history that writes normalized interactions, users, errors, and pre-aggregated usage CSVs.", + "whyUseIt": [ + "Feed Power BI, Excel, or another analytics tool with user-level interaction data.", + "Use interactive, client-secret, or certificate authentication.", + "Handle throttling, per-user failures, SKU tiers, and app/feature normalization during export." + ], + "howToUse": "Install `Microsoft.Graph.Authentication`, grant the documented Graph permissions, and test interactively:\n\n```powershell\n.\\Export-CopilotInteractions.ps1 -TenantId \"contoso.onmicrosoft.com\" -Interactive -MaxUsers 10\n```\n\nReview `Errors.csv`, then remove the user cap for the full export.", + "prerequisites": [ + "PowerShell 5.1 or later", + "Microsoft.Graph.Authentication module", + "User.Read.All, Reports.Read.All, and AiEnterpriseInteraction.Read.All", + "Entra app registration for app-only authentication" + ], + "url": "https://github.com/microsoft/FastTrack/tree/master/scripts/Export-CopilotInteractions", + "source": "scripts/Export-CopilotInteractions/README.md" + }, + { + "name": "Export-M365CopilotReports", + "title": "Export-M365CopilotReports", + "slug": "export-m365copilotreports", + "type": "script", + "subcategory": "PowerShell", + "category": "PowerShell", + "description": "Export Entra users, Purview Copilot audit events, all audit interactions, or Microsoft 365 Copilot usage reports.", + "summary": "Export Entra users, Purview Copilot audit events, all audit interactions, or Microsoft 365 Copilot usage reports.", + "tags": [ + "copilot", + "reporting" + ], + "artifact": "ps1", + "format": "ps1", + "featured": false, + "status": "active", + "author": "Alejandro Lopez", + "version": "1.0.0", + "published": "2025-03-11", + "updated": "2025-03-25", + "whatItIs": "An interactive PowerShell exporter for Entra user details, Purview audit data, and Microsoft 365 Copilot usage datasets used by analytics reports.", + "whyUseIt": [ + "Prepare organizational data for Viva Insights or Power BI.", + "Export Copilot-specific or broader Purview audit events from one menu.", + "Collect Microsoft 365 Copilot usage reporting data without separate scripts." + ], + "howToUse": "Install the Microsoft Graph prerequisites documented by the script, open PowerShell in this folder, and run `./Export-M365CopilotReports.ps1`. Choose the desired export from the interactive menu and complete authentication.", + "prerequisites": [ + "Microsoft Graph access", + "Permissions required by the selected report" + ], + "url": "https://github.com/microsoft/FastTrack/tree/master/scripts/Export-M365CopilotReports", + "source": "scripts/Export-M365CopilotReports/README.md" + }, + { + "name": "Get-AADAdminRoleMembers", + "title": "Get-AADAdminRoleMembers", + "slug": "get-aadadminrolemembers", + "type": "script", + "subcategory": "PowerShell", + "category": "PowerShell", + "description": "List members of all Entra administrator roles, inspect one role, or report the roles assigned to a user.", + "summary": "List members of all Entra administrator roles, inspect one role, or report the roles assigned to a user.", + "tags": [ + "entra", + "security", + "governance" + ], + "artifact": "ps1", + "format": "ps1", + "featured": false, + "status": "active", + "author": "Brian Baldock", + "version": "1.0.0", + "published": "2020-01-14", + "updated": "2021-01-15", + "whatItIs": "A PowerShell script for reporting Azure AD administrator-role membership across all roles, one named role, or one user.", + "whyUseIt": [ + "Audit privileged role membership across the directory.", + "Answer which administrator roles a particular user belongs to.", + "Inspect the members of a specific administrator role." + ], + "howToUse": "Install the Azure AD PowerShell module, then run one mode, for example:\n\n```powershell\n.\\Get-AADAdminRoleMembers.ps1 -Admin admin@contoso.onmicrosoft.com -All\n```", + "prerequisites": [ + "Azure AD PowerShell module", + "Directory account permitted to read administrator roles" + ], + "url": "https://github.com/microsoft/FastTrack/tree/master/scripts/Get-AADAdminRoleMembers", + "source": "scripts/Get-AADAdminRoleMembers/README.md" + }, + { + "name": "Get-LicenseUsage", + "title": "Get-LicenseUsage", + "slug": "get-licenseusage", + "type": "script", + "subcategory": "PowerShell", + "category": "PowerShell", + "description": "Choose a preferred or backup Microsoft 365 subscription for assignment based on current license availability.", + "summary": "Choose a preferred or backup Microsoft 365 subscription for assignment based on current license availability.", + "tags": [ + "licensing", + "reporting" + ], + "artifact": "ps1", + "format": "ps1", + "featured": false, + "status": "active", + "author": "Brian Baldock", + "version": "1.0.0", + "published": "2022-01-19", + "updated": "2022-01-19", + "whatItIs": "A PowerShell sample for selecting between preferred and backup Microsoft 365 subscriptions based on their current assigned and available license counts.", + "whyUseIt": [ + "Automate a license-assignment decision when equivalent entitlements span multiple subscriptions.", + "Use the result with group-based or direct license-assignment logic." + ], + "howToUse": "Install the Azure AD PowerShell module, then run:\n\n```powershell\n.\\Get-LicenseUsage.ps1 -Admin admin@contoso.com -PreferredLicense SPE_E5 -BackupLicense EMSPREMIUM\n```\n\nReview and adapt the documented `Get-LicensingUsage` decision logic for the tenant.", + "prerequisites": [ + "Azure AD PowerShell module", + "Account permitted to read tenant licensing" + ], + "url": "https://github.com/microsoft/FastTrack/tree/master/scripts/Get-LicenseUsage", + "source": "scripts/Get-LicenseUsage/README.md" + }, + { + "name": "Get-M365CopilotReadiness", + "title": "Get-M365CopilotReadiness", + "slug": "get-m365copilotreadiness", + "type": "script", + "subcategory": "PowerShell", + "category": "PowerShell", + "description": "Assess Microsoft 365 Copilot readiness across identity, licensing, collaboration, sharing, and optional compliance checks.", + "summary": "Assess Microsoft 365 Copilot readiness across identity, licensing, collaboration, sharing, and optional compliance checks.", + "tags": [ + "copilot", + "readiness", + "m365" + ], + "artifact": "ps1", + "format": "ps1", + "featured": true, + "status": "active", + "author": "John Cummings", + "version": "1.0.0", + "published": "2025-08-20", + "updated": "2025-09-09", + "whatItIs": "A PowerShell assessment that collects Microsoft 365 configuration signals and creates JSON and HTML reports for Copilot deployment-readiness review.", + "whyUseIt": [ + "Review Entra, licensing, Exchange, SharePoint, OneDrive, Teams, and Graph signals in one run.", + "Read plain-language descriptions and Copilot context for collected settings.", + "Optionally add a Microsoft Compliance Configuration Analyzer assessment." + ], + "howToUse": "Open PowerShell in the resource folder and run:\n\n```powershell\n.\\Get-M365CopilotReadiness.ps1 -OutputPath \"C:\\Temp\\M365Readiness\"\n```\n\nUse `-IncludeMCCA` for the optional compliance assessment. Complete the interactive sign-ins; failed services are logged while the remaining checks continue.", + "prerequisites": [ + "Windows PowerShell 5.1 or PowerShell 7", + "Network access to Microsoft 365 endpoints", + "Documented read permissions and service admin roles", + "MCCA licensing and roles only when using -IncludeMCCA" + ], + "url": "https://github.com/microsoft/FastTrack/tree/master/scripts/Get-M365CopilotReadiness", + "source": "scripts/Get-M365CopilotReadiness/README.md" + }, + { + "name": "Get-SiteInventory", + "title": "Get-SiteInventory", + "slug": "get-siteinventory", + "type": "script", + "subcategory": "PowerShell", + "category": "PowerShell", + "description": "Inventory a SharePoint Online site collection and its document libraries, with optional subweb and workbook processing.", + "summary": "Inventory a SharePoint Online site collection and its document libraries, with optional subweb and workbook processing.", + "tags": [ + "sharepoint", + "inventory" + ], + "artifact": "ps1", + "format": "ps1", + "featured": false, + "status": "active", + "author": "Patrick Rodgers", + "version": "1.0.0", + "published": "2018-06-22", + "updated": "2018-10-30", + "whatItIs": "A multi-script PowerShell inventory for a SharePoint Online site collection that can process subwebs concurrently and combine outputs into a workbook.", + "whyUseIt": [ + "Collect site and document-library inventory across a site collection.", + "Tune concurrency, retain individual CSVs, or rebuild a workbook without re-querying SharePoint." + ], + "howToUse": "Copy the `Lib` folder and inventory scripts together, install the dependencies, and run:\n\n```powershell\npowershell -mta .\\Get-Inventory.ps1 -url -processSubWebs\n```", + "prerequisites": [ + "PowerShell 5 or later", + "SharePointPnPPowerShellOnline module", + "Microsoft Excel unless using -NoWorkbook" + ], + "url": "https://github.com/microsoft/FastTrack/tree/master/scripts/get-siteinventory", + "source": "scripts/get-siteinventory/README.md" + }, + { + "name": "Get-TeamsUserActivityReport", + "title": "Get-TeamsUserActivityReport", + "slug": "get-teamsuseractivityreport", + "type": "script", + "subcategory": "PowerShell", + "category": "PowerShell", + "description": "Export detailed Microsoft Teams user activity for all users or a targeted CSV list through Microsoft Graph.", + "summary": "Export detailed Microsoft Teams user activity for all users or a targeted CSV list through Microsoft Graph.", + "tags": [ + "teams", + "reporting" + ], + "artifact": "ps1", + "format": "ps1", + "featured": false, + "status": "active", + "author": "Alejandro Lopez", + "version": "1.0.0", + "published": "2025-09-30", + "updated": "2025-09-30", + "whatItIs": "A PowerShell report that calls Microsoft Graph directly with application permissions and exports detailed Teams activity for all or selected users.", + "whyUseIt": [ + "Report meetings, calls, chats, durations, and other Teams activity metrics.", + "Target a pilot group with a UPN CSV or report across the tenant.", + "Run as an authorized background process without the Microsoft.Graph PowerShell module." + ], + "howToUse": "Create an Entra app registration with `Reports.Read.All` application permission and a client secret. Run `./Get-TeamsUserActivityReport.ps1 -Period \"D7\"` for all users, or add `-UserCsvPath` with a CSV containing `UserPrincipalName`.", + "prerequisites": [ + "PowerShell 5.1 or later", + "Entra app registration", + "Reports.Read.All application permission with admin consent" + ], + "url": "https://github.com/microsoft/FastTrack/tree/master/scripts/Get-TeamsUserActivityReport", + "source": "scripts/Get-TeamsUserActivityReport/README.md" + }, + { + "name": "ManagerSimulator", + "title": "ManagerSimulator", + "slug": "managersimulator", + "type": "agent", + "subcategory": "Agent Builder", + "category": "Agent Builder", + "description": "Preserved archived sample for practicing difficult conversations with a simulated manager.", + "summary": "Preserved archived sample for practicing difficult conversations with a simulated manager.", + "tags": [ + "coaching", + "roleplay", + "training" + ], + "artifact": "declarative", + "format": "declarative", + "featured": false, + "status": "archived", + "author": "Microsoft FastTrack", + "version": "1.0.0", + "published": "2025-01-15", + "updated": "2026-05-19", + "whatItIs": "An archived Agent Builder sample retained for historical reference. The active README links to the preserved files under the adjacent archive folder.", + "whyUseIt": [ + "Review an earlier declarative-agent pattern for reference.", + "Understand the scope of a retired FastTrack sample before choosing a current alternative." + ], + "howToUse": "Follow the archive link in this README to inspect the preserved `ManagerSimulator` sample. It is no longer actively promoted for new deployments.", + "prerequisites": [ + "Treat as historical guidance; validate current platform support before reuse" + ], + "url": "https://github.com/microsoft/FastTrack/tree/master/copilot-agent-samples/agent-builder-agents/da-ManagerSimulator", + "source": "copilot-agent-samples/agent-builder-agents/da-ManagerSimulator/README.md" + }, + { + "name": "Migrate-CopilotStudioAgents", + "title": "Migrate-CopilotStudioAgents", + "slug": "migrate-copilotstudioagents", + "type": "script", + "subcategory": "PowerShell", + "category": "PowerShell", + "description": "Inventory and copy classic Copilot Studio agents into department-mapped Power Platform environments with ownership recovery.", + "summary": "Inventory and copy classic Copilot Studio agents into department-mapped Power Platform environments with ownership recovery.", + "tags": [ + "copilot-studio", + "migration" + ], + "artifact": "ps1", + "format": "ps1", + "featured": false, + "status": "active", + "author": "Dean Cron", + "version": "1.0.0", + "published": "2026-07-15", + "updated": "2026-07-15", + "whatItIs": "A PowerShell toolkit that inventories agents, maps owner departments to existing environments, and copies classic Copilot Studio agents through Dataverse solutions.", + "whyUseIt": [ + "Plan environment redistribution from a tenant-wide inventory before making changes.", + "Preserve agent ownership and record-level sharing on a best-effort basis.", + "Run a full dry-run migration plan with `-WhatIf` before importing solutions." + ], + "howToUse": "1. Optionally generate and review `department-environment-mapping.json`.\n2. Run `Inventory-PowerPlatformAgents.ps1` to produce the raw inventory JSON.\n3. Run `Migrate-CopilotStudioAgents.ps1` with the inventory and mapping paths plus `-WhatIf`.\n4. Review `migration-plan.csv`, rerun without `-WhatIf`, then reconfigure connections and validate each migrated agent.", + "prerequisites": [ + "Power Platform CLI and MSAL.PS", + "Power Platform or reader admin role", + "Microsoft Graph User.Read.All delegated access", + "Dataverse access in source and target environments", + "Pre-created target environments and target-user access" + ], + "url": "https://github.com/microsoft/FastTrack/tree/master/scripts/Migrate-CopilotStudioAgents", + "source": "scripts/Migrate-CopilotStudioAgents/README.md" + }, + { + "name": "OmniAgent", + "title": "OmniAgent", + "slug": "omniagent", + "type": "agent", + "subcategory": "Agent Builder", + "category": "Agent Builder", + "description": "Preserved archived sample of a versatile, multi-purpose declarative agent starting point.", + "summary": "Preserved archived sample of a versatile, multi-purpose declarative agent starting point.", + "tags": [ + "template", + "starter" + ], + "artifact": "declarative", + "format": "declarative", + "featured": false, + "status": "archived", + "author": "Microsoft FastTrack", + "version": "1.0.0", + "published": "2025-02-24", + "updated": "2026-05-19", + "whatItIs": "An archived Agent Builder sample retained for historical reference. The active README links to the preserved files under the adjacent archive folder.", + "whyUseIt": [ + "Review an earlier declarative-agent pattern for reference.", + "Understand the scope of a retired FastTrack sample before choosing a current alternative." + ], + "howToUse": "Follow the archive link in this README to inspect the preserved `OmniAgent` sample. It is no longer actively promoted for new deployments.", + "prerequisites": [ + "Treat as historical guidance; validate current platform support before reuse" + ], + "url": "https://github.com/microsoft/FastTrack/tree/master/copilot-agent-samples/agent-builder-agents/da-OmniAgent", + "source": "copilot-agent-samples/agent-builder-agents/da-OmniAgent/README.md" + }, + { + "name": "PowerClaw Agent", + "title": "PowerClaw Agent", + "slug": "powerclaw-agent", + "type": "agent", + "subcategory": "Copilot Studio", + "category": "Copilot Studio", + "description": "A 24/7 AI chief of staff with autonomous briefings, task execution, and proactive coordination.", + "summary": "A 24/7 AI chief of staff with autonomous briefings, task execution, and proactive coordination.", + "tags": [ + "chief-of-staff", + "automation", + "calendar", + "memory" + ], + "artifact": "bundle", + "format": "bundle", + "featured": true, + "status": "active", + "author": "Alejandro Lopez", + "version": "1.2.11", + "published": "2026-03-17", + "updated": "2026-05-27", + "whatItIs": "A personal Copilot Studio agent that uses SharePoint as its memory and task workspace, chats in Teams, and runs a scheduled Power Automate heartbeat.", + "whyUseIt": [ + "Receive proactive work briefings and meeting preparation from Microsoft 365 context.", + "Delegate scheduled or task-board research and receive saved deliverables.", + "Keep the agent, its memory, and its operating data inside the Microsoft 365 tenant." + ], + "howToUse": "1. Import `PowerClaw_Solution.zip` into the target Power Platform environment.\n2. Provision the SharePoint workspace with the Bootstrap flow, PowerShell setup, or manual setup.\n3. Edit `user.md`, configure the documented connections, publish the agent, and use it in Teams.\n\nSee [`SETUP.md`](SETUP.md) for the complete setup and upgrade procedure.", + "prerequisites": [ + "Microsoft 365 E3 or E5", + "Copilot Studio capacity or pay-as-you-go", + "Power Automate Premium", + "Permission to create a SharePoint site" + ], + "url": "https://github.com/microsoft/FastTrack/tree/master/copilot-agent-samples/copilot-studio-agents/ca-PowerClawAgent", + "source": "copilot-agent-samples/copilot-studio-agents/ca-PowerClawAgent/README.md" + }, + { + "name": "Preflight-OneDrive", + "title": "Preflight-OneDrive", + "slug": "preflight-onedrive", + "type": "script", + "subcategory": "PowerShell", + "category": "PowerShell", + "description": "Scan a local or network folder for potential OneDrive for Business sync issues and optionally generate an HTML report.", + "summary": "Scan a local or network folder for potential OneDrive for Business sync issues and optionally generate an HTML report.", + "tags": [ + "onedrive", + "migration" + ], + "artifact": "ps1", + "format": "ps1", + "featured": false, + "status": "active", + "author": "Alejandro Lopez", + "version": "1.0.0", + "published": "2019-08-02", + "updated": "2019-08-02", + "whatItIs": "A PowerShell preflight scanner that checks a local folder or UNC path for potential OneDrive for Business synchronization issues.", + "whyUseIt": [ + "Find problematic paths before deploying the OneDrive sync client.", + "Review results in the console or an optional HTML report." + ], + "howToUse": "Install the external dependencies, then run:\n\n```powershell\n.\\Preflight-OneDrive.ps1 -Path \"\\\\dc.contoso.com\\smb\" -GenerateHTMLReport\n```", + "prerequisites": [ + "EnhancedHTML2 module", + "Test-OneDrivePath function", + "Read access to the folder being scanned" + ], + "url": "https://github.com/microsoft/FastTrack/tree/master/scripts/Preflight-OneDrive", + "source": "scripts/Preflight-OneDrive/README.md" + }, + { + "name": "ProductQuote Agent", + "title": "ProductQuote Agent", + "slug": "productquote-agent", + "type": "agent", + "subcategory": "Copilot Studio", + "category": "Copilot Studio", + "description": "Generate product quotes from Excel inventory, populate a Word template, and email the finished document.", + "summary": "Generate product quotes from Excel inventory, populate a Word template, and email the finished document.", + "tags": [ + "sales", + "quotes", + "excel", + "word" + ], + "artifact": "bundle", + "format": "bundle", + "featured": false, + "status": "active", + "author": [ + "Alejandro Lopez", + "Damien Bird" + ], + "version": "1.0.0", + "published": "2025-08-06", + "updated": "2026-07-16", + "whatItIs": "A Copilot Studio and Power Automate solution that looks up products in Excel, fills a Word quote template, and emails the generated quote.", + "whyUseIt": [ + "Turn natural-language product requests into consistent quote documents.", + "Reuse an existing product catalog and branded Word template.", + "Automate document generation and delivery while retaining configurable connections." + ], + "howToUse": "1. Download `Solution/ProductQuoteAgent.zip` and upload the included Word template to SharePoint.\n2. Import the solution in Power Apps and configure its connections and email environment variable.\n3. Point the included flow at the Word template, turn the flow on, and test the agent in Copilot Studio.", + "prerequisites": [ + "Microsoft Copilot Studio", + "Power Automate", + "Exchange Online", + "Excel product catalog", + "Word template with plain-text content controls" + ], + "url": "https://github.com/microsoft/FastTrack/tree/master/copilot-agent-samples/copilot-studio-agents/ca-ProductQuoteAgent", + "source": "copilot-agent-samples/copilot-studio-agents/ca-ProductQuoteAgent/README.md" + }, + { + "name": "Purview Audit Copilot Report", + "title": "Purview Audit Copilot Report", + "slug": "purview-audit-copilot-report", + "type": "analytics", + "subcategory": "Power BI", + "category": "Power BI", + "description": "Analyze Copilot adoption by user, app, agent, department, and trend using Purview audit and Entra export data.", + "summary": "Analyze Copilot adoption by user, app, agent, department, and trend using Purview audit and Entra export data.", + "tags": [ + "power-bi", + "purview", + "audit" + ], + "artifact": "pbix", + "format": "pbix", + "featured": false, + "status": "active", + "author": "Alejandro Lopez", + "version": "1.0.0", + "published": "2025-03-26", + "updated": "2026-07-14", + "whatItIs": "A Power BI dashboard that combines Microsoft Purview CopilotInteraction audit exports with Entra user details to show adoption trends by user, app, and agent.", + "whyUseIt": [ + "Separate direct app usage, Microsoft agents, third-party agents, and Copilot Studio activity.", + "Explore adoption trends by department, role, license, app, and time.", + "Use a portal or PowerShell audit export with one shared Power BI classification model." + ], + "howToUse": "1. Export `CopilotInteraction` events from Microsoft Purview Audit.\n2. Run `Export-M365CopilotReports.ps1` and export Entra user details.\n3. Open the PBIX, edit `PathToCopilotAuditActivitiesCSV` and `PathToEntraUsersCSV`, then select **Close & Apply**.", + "prerequisites": [ + "Permission to search Microsoft Purview Audit", + "PowerShell 5.1 or later", + "Power BI Desktop" + ], + "url": "https://github.com/microsoft/FastTrack/tree/master/copilot-analytics-samples/Copilot_Audit_PBI", + "source": "copilot-analytics-samples/Copilot_Audit_PBI/README.md" + }, + { + "name": "ReasoningAgent", + "title": "ReasoningAgent", + "slug": "reasoningagent", + "type": "agent", + "subcategory": "Agent Builder", + "category": "Agent Builder", + "description": "Preserved archived sample of a declarative agent configured for step-by-step reasoning.", + "summary": "Preserved archived sample of a declarative agent configured for step-by-step reasoning.", + "tags": [ + "reasoning", + "analysis" + ], + "artifact": "declarative", + "format": "declarative", + "featured": false, + "status": "archived", + "author": "Microsoft FastTrack", + "version": "1.0.0", + "published": "2025-01-28", + "updated": "2026-05-19", + "whatItIs": "An archived Agent Builder sample retained for historical reference. The active README links to the preserved files under the adjacent archive folder.", + "whyUseIt": [ + "Review an earlier declarative-agent pattern for reference.", + "Understand the scope of a retired FastTrack sample before choosing a current alternative." + ], + "howToUse": "Follow the archive link in this README to inspect the preserved `ReasoningAgent` sample. It is no longer actively promoted for new deployments.", + "prerequisites": [ + "Treat as historical guidance; validate current platform support before reuse" + ], + "url": "https://github.com/microsoft/FastTrack/tree/master/copilot-agent-samples/agent-builder-agents/da-ReasoningAgent", + "source": "copilot-agent-samples/agent-builder-agents/da-ReasoningAgent/README.md" + }, + { + "name": "Researcher — Automation Opportunities", + "title": "Researcher — Automation Opportunities", + "slug": "researcher-automation-opportunities", + "type": "prompt", + "subcategory": "Researcher", + "category": "Researcher", + "description": "Analyze Microsoft 365 signals to identify repetitive work and prioritize high-value Copilot agent automation opportunities.", + "summary": "Analyze Microsoft 365 signals to identify repetitive work and prioritize high-value Copilot agent automation opportunities.", + "tags": [ + "researcher", + "frontier", + "automation" + ], + "artifact": "md", + "format": "md", + "featured": false, + "status": "active", + "author": "Alexander Hurtado", + "version": "1.0.0", + "published": "2025-05-14", + "updated": "2025-05-15", + "whatItIs": "A Microsoft 365 Researcher prompt that looks across available organizational signals for repetitive, fragmented, or manual workflows suited to intelligent automation.", + "whyUseIt": [ + "Discover automation opportunities grounded in observed work patterns.", + "Prioritize scenarios by frequency, departments involved, and estimated time savings.", + "Focus agent ideas on gaps that need intelligence, summarization, or cross-source coordination." + ], + "howToUse": "Copy the prompt from this file into Microsoft 365 Researcher. Replace the bracketed department example with the desired scope, confirm Researcher has access to the intended organizational sources, run it, and review the structured opportunity table.", + "prerequisites": [ + "Access to Microsoft 365 Researcher", + "Permission to use the relevant Microsoft 365 organizational data" + ], + "url": "https://github.com/microsoft/FastTrack/blob/master/copilot-prompt-samples/Researcher-OrganizationInsights.md", + "source": "copilot-prompt-samples/Researcher-OrganizationInsights.md" + }, + { + "name": "Teams Phone User Migration", + "title": "Teams Phone User Migration", + "slug": "teams-phone-user-migration", + "type": "script", + "subcategory": "PowerShell", + "category": "PowerShell", + "description": "Run a two-phase CSV-driven Teams Phone migration for voice policies, phone numbers, and emergency locations.", + "summary": "Run a two-phase CSV-driven Teams Phone migration for voice policies, phone numbers, and emergency locations.", + "tags": [ + "teams", + "telephony", + "migration" + ], + "artifact": "ps1", + "format": "ps1", + "featured": false, + "status": "active", + "author": "Laure Van der Hauwaert", + "version": "1.0.0", + "published": "2024-10-21", + "updated": "2024-10-21", + "whatItIs": "A pair of PowerShell samples for a staged Teams Phone migration: assign voice policies before cutover, then assign phone numbers and emergency locations.", + "whyUseIt": [ + "Separate advance policy assignment from migration-day number activation.", + "Drive bulk assignments from a documented CSV format.", + "Log disabled, unlicensed, or otherwise failed user assignments." + ], + "howToUse": "Install the latest MicrosoftTeams module and fill the included CSV with user policies, numbers, and emergency locations. Run the Phase 1 script before cutover, then run the Phase 2 Cutover script on migration day.", + "prerequisites": [ + "MicrosoftTeams PowerShell module", + "Teams administration permissions", + "Completed migration CSV" + ], + "url": "https://github.com/microsoft/FastTrack/tree/master/scripts/Teams%20Phone%20User%20Migration", + "source": "scripts/Teams Phone User Migration/README.md" + }, + { + "name": "VibeWriting Agent", + "title": "VibeWriting Agent", + "slug": "vibewriting-agent", + "type": "agent", + "subcategory": "Agent Builder", + "category": "Agent Builder", + "description": "Proofread stream-of-consciousness writing while preserving the author’s meaning, tone, and distinctive voice.", + "summary": "Proofread stream-of-consciousness writing while preserving the author’s meaning, tone, and distinctive voice.", + "tags": [ + "writing", + "editing", + "tone" + ], + "artifact": "declarative", + "format": "declarative", + "featured": true, + "status": "active", + "author": "Alejandro Lopez", + "version": "1.0.0", + "published": "2025-02-25", + "updated": "2025-08-06", + "whatItIs": "A declarative Agent Builder configuration for proofreading unstructured drafts, correcting mechanics, and improving readability without replacing the author’s voice.", + "whyUseIt": [ + "Clean up notes, reflections, creative drafts, and informal communications.", + "Preserve distinctive vocabulary, emotional tone, metaphors, and core meaning.", + "Choose a light, medium, or heavy refinement level without generating unrelated content." + ], + "howToUse": "1. Create a new agent in Microsoft 365 Copilot Agent Builder.\n2. Copy the name, description, and full system instructions from this README.\n3. Configure the optional knowledge and recommended capabilities shown in the setup table.\n4. Add the starter prompt, publish, and provide text to proofread.", + "prerequisites": [ + "Access to Microsoft 365 Copilot Agent Builder" + ], + "url": "https://github.com/microsoft/FastTrack/tree/master/copilot-agent-samples/agent-builder-agents/da-VibeWritingAgent", + "source": "copilot-agent-samples/agent-builder-agents/da-VibeWritingAgent/README.md" + }, + { + "name": "Viva Insights Copilot Dashboard", + "title": "Viva Insights Copilot Dashboard", + "slug": "viva-insights-copilot-dashboard", + "type": "analytics", + "subcategory": "Power BI", + "category": "Power BI", + "description": "Visualize a Viva Insights Advanced Insights person-query export in Power BI, including dynamic personas and usage profiles.", + "summary": "Visualize a Viva Insights Advanced Insights person-query export in Power BI, including dynamic personas and usage profiles.", + "tags": [ + "power-bi", + "viva-insights", + "adoption" + ], + "artifact": "pbix", + "format": "pbix", + "featured": false, + "status": "active", + "author": "Alejandro Lopez", + "version": "2.0.0", + "published": "2024-05-03", + "updated": "2025-03-17", + "whatItIs": "A pair of Power BI templates that visualize Viva Insights Advanced Insights person-query exports, including a dynamic-personas view with user-profile usage.", + "whyUseIt": [ + "Explore Copilot adoption alongside collaboration and organizational attributes.", + "Start from a reusable Power BI model instead of designing a dashboard from scratch." + ], + "howToUse": "Download the PBIX file that matches the desired dashboard, review the included Word instructions, export the required Viva Insights Advanced Insights person query, and update the report data source before refreshing.", + "prerequisites": [ + "Microsoft Viva Advanced Insights", + "Power BI Desktop", + "Viva Insights person-query export" + ], + "url": "https://github.com/microsoft/FastTrack/tree/master/copilot-analytics-samples/VivaInsights-Copilot-Dashboard-Sample", + "source": "copilot-analytics-samples/VivaInsights-Copilot-Dashboard-Sample/README.md" + } + ] +} diff --git a/copilot-agent-samples/agent-builder-agents/da-CompareDocs/README.md b/copilot-agent-samples/agent-builder-agents/da-CompareDocs/README.md index 6431670c..ef47bc3f 100644 --- a/copilot-agent-samples/agent-builder-agents/da-CompareDocs/README.md +++ b/copilot-agent-samples/agent-builder-agents/da-CompareDocs/README.md @@ -1,3 +1,30 @@ +--- +title: CompareDocs +type: agent +category: Agent Builder +summary: Compare two documents and surface meaningful differences. +author: Microsoft FastTrack +version: 1.0.0 +published: "2025-04-11" +updated: "2026-05-19" +tags: + - documents + - comparison +format: declarative +status: archived +whatItIs: >- + An archived Agent Builder sample retained for historical reference. The active README links to the + preserved files under the adjacent archive folder. +whyUseIt: + - Review an earlier declarative-agent pattern for reference. + - Understand the scope of a retired FastTrack sample before choosing a current alternative. +howToUse: >- + Follow the archive link in this README to inspect the preserved `CompareDocs` sample. It is no + longer actively promoted for new deployments. +prerequisites: + - Treat as historical guidance; validate current platform support before reuse +--- + # CompareDocs Agent This sample has been archived and is no longer actively promoted for new deployments. diff --git a/copilot-agent-samples/agent-builder-agents/da-DeepResearch/README.md b/copilot-agent-samples/agent-builder-agents/da-DeepResearch/README.md index 36225c90..cc75b64a 100644 --- a/copilot-agent-samples/agent-builder-agents/da-DeepResearch/README.md +++ b/copilot-agent-samples/agent-builder-agents/da-DeepResearch/README.md @@ -1,3 +1,30 @@ +--- +title: DeepResearch +type: agent +category: Agent Builder +summary: Preserved archived sample for structured, multi-step research across source material. +author: Microsoft FastTrack +version: 1.0.0 +published: "2025-01-28" +updated: "2026-05-19" +tags: + - research + - analysis +format: declarative +status: archived +whatItIs: >- + An archived Agent Builder sample retained for historical reference. The active README links to the + preserved files under the adjacent archive folder. +whyUseIt: + - Review an earlier declarative-agent pattern for reference. + - Understand the scope of a retired FastTrack sample before choosing a current alternative. +howToUse: >- + Follow the archive link in this README to inspect the preserved `DeepResearch` sample. It is no + longer actively promoted for new deployments. +prerequisites: + - Treat as historical guidance; validate current platform support before reuse +--- + # Deep Research Agent This sample has been archived and is no longer actively promoted for new deployments. diff --git a/copilot-agent-samples/agent-builder-agents/da-ManagerSimulator/README.md b/copilot-agent-samples/agent-builder-agents/da-ManagerSimulator/README.md index ed82c604..bf376a30 100644 --- a/copilot-agent-samples/agent-builder-agents/da-ManagerSimulator/README.md +++ b/copilot-agent-samples/agent-builder-agents/da-ManagerSimulator/README.md @@ -1,3 +1,31 @@ +--- +title: ManagerSimulator +type: agent +category: Agent Builder +summary: Preserved archived sample for practicing difficult conversations with a simulated manager. +author: Microsoft FastTrack +version: 1.0.0 +published: "2025-01-15" +updated: "2026-05-19" +tags: + - coaching + - roleplay + - training +format: declarative +status: archived +whatItIs: >- + An archived Agent Builder sample retained for historical reference. The active README links to the + preserved files under the adjacent archive folder. +whyUseIt: + - Review an earlier declarative-agent pattern for reference. + - Understand the scope of a retired FastTrack sample before choosing a current alternative. +howToUse: >- + Follow the archive link in this README to inspect the preserved `ManagerSimulator` sample. It is + no longer actively promoted for new deployments. +prerequisites: + - Treat as historical guidance; validate current platform support before reuse +--- + # Manager Simulator This sample has been archived and is no longer actively promoted for new deployments. diff --git a/copilot-agent-samples/agent-builder-agents/da-OmniAgent/README.md b/copilot-agent-samples/agent-builder-agents/da-OmniAgent/README.md index b428e90b..373163d8 100644 --- a/copilot-agent-samples/agent-builder-agents/da-OmniAgent/README.md +++ b/copilot-agent-samples/agent-builder-agents/da-OmniAgent/README.md @@ -1,3 +1,30 @@ +--- +title: OmniAgent +type: agent +category: Agent Builder +summary: Preserved archived sample of a versatile, multi-purpose declarative agent starting point. +author: Microsoft FastTrack +version: 1.0.0 +published: "2025-02-24" +updated: "2026-05-19" +tags: + - template + - starter +format: declarative +status: archived +whatItIs: >- + An archived Agent Builder sample retained for historical reference. The active README links to the + preserved files under the adjacent archive folder. +whyUseIt: + - Review an earlier declarative-agent pattern for reference. + - Understand the scope of a retired FastTrack sample before choosing a current alternative. +howToUse: >- + Follow the archive link in this README to inspect the preserved `OmniAgent` sample. It is no + longer actively promoted for new deployments. +prerequisites: + - Treat as historical guidance; validate current platform support before reuse +--- + # Omni Agent This sample has been archived and is no longer actively promoted for new deployments. diff --git a/copilot-agent-samples/agent-builder-agents/da-ReasoningAgent/README.md b/copilot-agent-samples/agent-builder-agents/da-ReasoningAgent/README.md index e3f1891d..6289e1dc 100644 --- a/copilot-agent-samples/agent-builder-agents/da-ReasoningAgent/README.md +++ b/copilot-agent-samples/agent-builder-agents/da-ReasoningAgent/README.md @@ -1,3 +1,30 @@ +--- +title: ReasoningAgent +type: agent +category: Agent Builder +summary: Preserved archived sample of a declarative agent configured for step-by-step reasoning. +author: Microsoft FastTrack +version: 1.0.0 +published: "2025-01-28" +updated: "2026-05-19" +tags: + - reasoning + - analysis +format: declarative +status: archived +whatItIs: >- + An archived Agent Builder sample retained for historical reference. The active README links to the + preserved files under the adjacent archive folder. +whyUseIt: + - Review an earlier declarative-agent pattern for reference. + - Understand the scope of a retired FastTrack sample before choosing a current alternative. +howToUse: >- + Follow the archive link in this README to inspect the preserved `ReasoningAgent` sample. It is no + longer actively promoted for new deployments. +prerequisites: + - Treat as historical guidance; validate current platform support before reuse +--- + # Reasoning Agent This sample has been archived and is no longer actively promoted for new deployments. diff --git a/copilot-agent-samples/agent-builder-agents/da-VibeWritingAgent/README.md b/copilot-agent-samples/agent-builder-agents/da-VibeWritingAgent/README.md index 5b203cae..2d763c8f 100644 --- a/copilot-agent-samples/agent-builder-agents/da-VibeWritingAgent/README.md +++ b/copilot-agent-samples/agent-builder-agents/da-VibeWritingAgent/README.md @@ -1,3 +1,36 @@ +--- +title: VibeWriting Agent +type: agent +category: Agent Builder +summary: >- + Proofread stream-of-consciousness writing while preserving the author’s meaning, tone, and + distinctive voice. +author: Alejandro Lopez +version: 1.0.0 +published: "2025-02-25" +updated: "2025-08-06" +tags: + - writing + - editing + - tone +format: declarative +featured: true +whatItIs: >- + A declarative Agent Builder configuration for proofreading unstructured drafts, correcting + mechanics, and improving readability without replacing the author’s voice. +whyUseIt: + - Clean up notes, reflections, creative drafts, and informal communications. + - Preserve distinctive vocabulary, emotional tone, metaphors, and core meaning. + - Choose a light, medium, or heavy refinement level without generating unrelated content. +howToUse: |- + 1. Create a new agent in Microsoft 365 Copilot Agent Builder. + 2. Copy the name, description, and full system instructions from this README. + 3. Configure the optional knowledge and recommended capabilities shown in the setup table. + 4. Add the starter prompt, publish, and provide text to proofread. +prerequisites: + - Access to Microsoft 365 Copilot Agent Builder +--- + # Vibe Writing Agent ## Overview diff --git a/copilot-agent-samples/copilot-studio-agents/ca-AutoReplyAgent/README.md b/copilot-agent-samples/copilot-studio-agents/ca-AutoReplyAgent/README.md index d5a8e9c7..95d56fc0 100644 --- a/copilot-agent-samples/copilot-studio-agents/ca-AutoReplyAgent/README.md +++ b/copilot-agent-samples/copilot-studio-agents/ca-AutoReplyAgent/README.md @@ -1,3 +1,37 @@ +--- +title: AutoReply Agent +type: agent +category: Copilot Studio +summary: Research incoming email questions against trusted sources and draft thoughtful replies for review. +author: + - Alejandro Lopez + - Shervin Shaffie +version: 1.0.0 +published: "2025-06-17" +updated: "2025-08-06" +tags: + - email + - research + - automation +format: bundle +whatItIs: >- + An autonomous Copilot Studio pattern that triggers on new mail, researches the questions against + configured knowledge, and emails a draft response to the owner. +whyUseIt: + - Reduce time spent researching repetitive questions in individual or shared mailboxes. + - Keep answers grounded in explicitly configured knowledge sources. + - Review a prepared response before replying to the original sender. +howToUse: |- + 1. Create the Copilot Studio agent with the instructions in this README. + 2. Add the `Send an email (V2)` tool and `When a new email arrives (V3)` trigger. + 3. Configure trusted knowledge sources and an inbox rule that prevents test-message loops. + 4. Test with a non-production mailbox before broader use. +prerequisites: + - Microsoft Copilot Studio + - Power Automate + - Exchange Online mailbox +--- + # AutoReply Agent ## 📌 Overview diff --git a/copilot-agent-samples/copilot-studio-agents/ca-PowerClawAgent/README.md b/copilot-agent-samples/copilot-studio-agents/ca-PowerClawAgent/README.md index 2e25b096..5c4f728f 100644 --- a/copilot-agent-samples/copilot-studio-agents/ca-PowerClawAgent/README.md +++ b/copilot-agent-samples/copilot-studio-agents/ca-PowerClawAgent/README.md @@ -1,3 +1,39 @@ +--- +title: PowerClaw Agent +type: agent +category: Copilot Studio +summary: A 24/7 AI chief of staff with autonomous briefings, task execution, and proactive coordination. +author: Alejandro Lopez +version: 1.2.11 +published: "2026-03-17" +updated: "2026-05-27" +tags: + - chief-of-staff + - automation + - calendar + - memory +format: bundle +featured: true +whatItIs: >- + A personal Copilot Studio agent that uses SharePoint as its memory and task workspace, chats in + Teams, and runs a scheduled Power Automate heartbeat. +whyUseIt: + - Receive proactive work briefings and meeting preparation from Microsoft 365 context. + - Delegate scheduled or task-board research and receive saved deliverables. + - Keep the agent, its memory, and its operating data inside the Microsoft 365 tenant. +howToUse: |- + 1. Import `PowerClaw_Solution.zip` into the target Power Platform environment. + 2. Provision the SharePoint workspace with the Bootstrap flow, PowerShell setup, or manual setup. + 3. Edit `user.md`, configure the documented connections, publish the agent, and use it in Teams. + + See [`SETUP.md`](SETUP.md) for the complete setup and upgrade procedure. +prerequisites: + - Microsoft 365 E3 or E5 + - Copilot Studio capacity or pay-as-you-go + - Power Automate Premium + - Permission to create a SharePoint site +--- +

diff --git a/copilot-agent-samples/copilot-studio-agents/ca-ProductQuoteAgent/README.md b/copilot-agent-samples/copilot-studio-agents/ca-ProductQuoteAgent/README.md index e472b1b4..99a2b8ea 100644 --- a/copilot-agent-samples/copilot-studio-agents/ca-ProductQuoteAgent/README.md +++ b/copilot-agent-samples/copilot-studio-agents/ca-ProductQuoteAgent/README.md @@ -1,3 +1,44 @@ +--- +title: ProductQuote Agent +type: agent +category: Copilot Studio +summary: >- + Generate product quotes from Excel inventory, populate a Word template, and email the finished + document. +author: + - Alejandro Lopez + - Damien Bird +version: 1.0.0 +published: "2025-08-06" +updated: "2026-07-16" +tags: + - sales + - quotes + - excel + - word +format: bundle +whatItIs: >- + A Copilot Studio and Power Automate solution that looks up products in Excel, fills a Word quote + template, and emails the generated quote. +whyUseIt: + - Turn natural-language product requests into consistent quote documents. + - Reuse an existing product catalog and branded Word template. + - Automate document generation and delivery while retaining configurable connections. +howToUse: >- + 1. Download `Solution/ProductQuoteAgent.zip` and upload the included Word template to SharePoint. + + 2. Import the solution in Power Apps and configure its connections and email environment variable. + + 3. Point the included flow at the Word template, turn the flow on, and test the agent in Copilot + Studio. +prerequisites: + - Microsoft Copilot Studio + - Power Automate + - Exchange Online + - Excel product catalog + - Word template with plain-text content controls +--- + # 🧾 Product Quote Agent This autonomous agent helps with generating quotes by using Excel as a knowledgebase for product inventory. It leverages Power Automate to populate a Word template with quote details and emails the final document based on the user's request. diff --git a/copilot-agent-samples/github-copilot-agents/Council/README.md b/copilot-agent-samples/github-copilot-agents/Council/README.md index e89e1837..64aa26ba 100644 --- a/copilot-agent-samples/github-copilot-agents/Council/README.md +++ b/copilot-agent-samples/github-copilot-agents/Council/README.md @@ -1,3 +1,44 @@ +--- +title: AI Council +type: agent +category: GitHub Copilot +summary: >- + Run Claude, GPT, and Gemini in parallel to surface consensus, disagreements, and a synthesized + decision recommendation. +author: Alejandro Lopez +version: 1.0.0 +published: "2026-03-04" +updated: "2026-03-18" +tags: + - multi-model + - decision + - deliberation +format: bundle +featured: true +whatItIs: >- + A GitHub Copilot CLI agent that delegates a question to Claude, GPT, and Gemini, synthesizes their + positions, and can save a Markdown and HTML decision package. +whyUseIt: + - Expose model disagreements and assumptions before making consequential decisions. + - Choose quick, debate, or multi-round deep deliberation based on the stakes. + - >- + Create a shareable decision record with consensus, tensions, votes, and an interactive + dashboard. +howToUse: |- + 1. In a terminal, install the marketplace plugin: + + ```text + copilot plugin marketplace add microsoft/FastTrack + copilot plugin install council@fasttrack-copilot-plugins + ``` + 2. Run `copilot`, choose **AI Council** from `/agent`, and ask a question. + 3. Add `--depth deep`, `--domain `, or `--save` when needed. +prerequisites: + - GitHub Copilot CLI + - Active Copilot subscription with access to multiple models + - Copilot CLI plugin support +--- + # 🏛️ The AI Council **A multi-model deliberation agent for GitHub Copilot CLI.** diff --git a/copilot-agent-samples/github-copilot-skills/copilot-studio-workflow/README.md b/copilot-agent-samples/github-copilot-skills/copilot-studio-workflow/README.md index dc233ffb..a772e1c7 100644 --- a/copilot-agent-samples/github-copilot-skills/copilot-studio-workflow/README.md +++ b/copilot-agent-samples/github-copilot-skills/copilot-studio-workflow/README.md @@ -1,3 +1,49 @@ +--- +title: Copilot Studio Workflow +type: skill +category: GitHub Copilot +summary: >- + Use source control, local YAML, preflight checks, and repeatable packaging to build Copilot Studio + agents like software. +author: Microsoft FastTrack +version: 1.0.0 +published: "2026-04-10" +updated: "2026-04-13" +tags: + - devops + - copilot-studio + - packaging +format: bundle +featured: true +whatItIs: >- + An Agent Skills-compatible workflow with scripts and guidance for pulling, editing, validating, + pushing, publishing, and packaging Copilot Studio YAML projects. +whyUseIt: + - Keep Copilot Studio definitions in Git and review intentional source changes. + - Catch dirty workflow files, missing variables, and solution-membership gaps before deployment. + - Reuse known workarounds for common pull, push, packaging, and environment-portability problems. +howToUse: >- + Install with: + + + ```text + + copilot plugin install + microsoft/FastTrack:copilot-agent-samples/github-copilot-skills/copilot-studio-workflow + + ``` + + + Then ask Copilot to pull, validate, push, or package a Copilot Studio project. Run the included + preflight and status scripts when prompted. +prerequisites: + - Git + - VS Code with the Copilot Studio extension + - PowerShell + - Copilot Studio-enabled Power Platform environment + - Power Platform CLI recommended +--- + # copilot-studio-workflow **Build Copilot Studio agents like software: local YAML, source control, repeatable packaging, and an AI assistant that already knows the platform's sharp edges.** diff --git a/copilot-agent-strategy/copilot-agent-brainstorm/README.md b/copilot-agent-strategy/copilot-agent-brainstorm/README.md index ff54a3a5..3c72eff1 100644 --- a/copilot-agent-strategy/copilot-agent-brainstorm/README.md +++ b/copilot-agent-strategy/copilot-agent-brainstorm/README.md @@ -1,3 +1,35 @@ +--- +title: Agent Brainstorming Template +type: strategy +category: PowerPoint +summary: >- + Map an agent’s type, user flow, knowledge sources, tools, and target problem before + implementation. +author: Microsoft FastTrack +version: 1.0.0 +published: "2025-06-18" +updated: "2025-10-28" +tags: + - template + - planning + - powerpoint +format: pptx +whatItIs: >- + A one-slide PowerPoint planning template for visualizing the user-to-agent flow, selected agent + type, knowledge sources, tools, and target problem. +whyUseIt: + - Align stakeholders on a simple agent design before building. + - Identify the minimum knowledge and tools required for the primary scenario. + - Keep implementation focused on a clearly mapped user flow. +howToUse: |- + 1. Download `Copilot Agent Brainstorming.pptx` from this folder. + 2. Select the intended agent type. + 3. Fill in the user input, agent process, knowledge source, tool, and problem statement. + 4. Review the slide with stakeholders and keep it as a build reference. +prerequisites: + - Microsoft PowerPoint or a compatible presentation editor +--- + # Copilot Agent Brainstorming A simple visual template to help you map out your Copilot agent specifications before building. diff --git a/copilot-agent-strategy/copilot-agents-cost-tool/README.md b/copilot-agent-strategy/copilot-agents-cost-tool/README.md index def6c30f..3aa12bc0 100644 --- a/copilot-agent-strategy/copilot-agents-cost-tool/README.md +++ b/copilot-agent-strategy/copilot-agents-cost-tool/README.md @@ -1,3 +1,36 @@ +--- +title: Agents Cost Calculator +type: strategy +category: Interactive +summary: >- + Estimate test and production costs for Copilot Studio, Agent Builder, SharePoint, and Foundry + agents. +author: Microsoft FastTrack +version: 1.0.0 +published: "2026-04-01" +updated: "2026-07-16" +tags: + - cost + - roi + - calculator +format: interactive +featured: true +whatItIs: >- + A self-contained browser calculator for modeling Copilot Credits or token-based costs across + custom, Agent Builder, SharePoint, and Microsoft Foundry agents. +whyUseIt: + - Trace per-turn costs before testing or production rollout. + - Compare pay-as-you-go, capacity, model, knowledge, tool, and conversation assumptions. + - Export a scenario to CSV or print a shareable planning snapshot. +howToUse: >- + Open `index.html` in a browser, select an agent type, and optionally load a quick-start template. + Enter knowledge, component, conversation, test-scale, or token assumptions, then review the cost + trace and production estimate. Export CSV or print the results. +prerequisites: + - Modern web browser + - Current licensing and pricing inputs for planning validation +--- + # M365 Copilot Agents Cost Calculator A self-contained, browser-based cost estimator for Microsoft 365 Copilot agents. diff --git a/copilot-agent-strategy/copilot-agents-guide/README.md b/copilot-agent-strategy/copilot-agents-guide/README.md index 781ddec9..e8b752cc 100644 --- a/copilot-agent-strategy/copilot-agents-guide/README.md +++ b/copilot-agent-strategy/copilot-agents-guide/README.md @@ -1,3 +1,35 @@ +--- +title: Copilot Agents Guide +type: strategy +category: Interactive +summary: >- + Compare Microsoft Copilot agent platforms with capability views, decision guidance, support + indicators, and scenarios. +author: Microsoft FastTrack +version: 3.0.0 +published: "2025-10-28" +updated: "2026-04-17" +tags: + - guide + - decision + - planning +format: interactive +featured: true +whatItIs: >- + A self-contained interactive web guide that compares Microsoft Copilot agent types across + capabilities, constraints, technical effort, cost, and FastTrack support. +whyUseIt: + - Shortlist an agent platform based on use case, team skills, budget, timeline, and growth. + - Compare capabilities and limitations side by side before committing to a build path. + - Give business, architecture, and development stakeholders a shared decision framework. +howToUse: >- + Open `index.html` directly in a modern browser. To host locally, run `python -m http.server 8000` + from the resource folder and browse to `http://localhost:8000/index.html`. Use the Overview, + Capabilities, Comparison, and Guidance tabs. +prerequisites: + - Modern web browser +--- + # Microsoft Copilot Agents Guide An interactive decision-making dashboard to help you choose the right Microsoft Copilot agent platform for your business needs. diff --git a/copilot-analytics-samples/Copilot_Audit_PBI/README.md b/copilot-analytics-samples/Copilot_Audit_PBI/README.md index 2f8e91af..6ec79bd0 100644 --- a/copilot-analytics-samples/Copilot_Audit_PBI/README.md +++ b/copilot-analytics-samples/Copilot_Audit_PBI/README.md @@ -1,3 +1,39 @@ +--- +title: Purview Audit Copilot Report +type: analytics +category: Power BI +summary: >- + Analyze Copilot adoption by user, app, agent, department, and trend using Purview audit and Entra + export data. +author: Alejandro Lopez +version: 1.0.0 +published: "2025-03-26" +updated: "2026-07-14" +tags: + - power-bi + - purview + - audit +format: pbix +whatItIs: >- + A Power BI dashboard that combines Microsoft Purview CopilotInteraction audit exports with Entra + user details to show adoption trends by user, app, and agent. +whyUseIt: + - Separate direct app usage, Microsoft agents, third-party agents, and Copilot Studio activity. + - Explore adoption trends by department, role, license, app, and time. + - Use a portal or PowerShell audit export with one shared Power BI classification model. +howToUse: >- + 1. Export `CopilotInteraction` events from Microsoft Purview Audit. + + 2. Run `Export-M365CopilotReports.ps1` and export Entra user details. + + 3. Open the PBIX, edit `PathToCopilotAuditActivitiesCSV` and `PathToEntraUsersCSV`, then select + **Close & Apply**. +prerequisites: + - Permission to search Microsoft Purview Audit + - PowerShell 5.1 or later + - Power BI Desktop +--- + # 🔍 Copilot Audit Dashboard > [!IMPORTANT] diff --git a/copilot-analytics-samples/VivaInsights-Copilot-Dashboard-Sample/README.md b/copilot-analytics-samples/VivaInsights-Copilot-Dashboard-Sample/README.md index 4f89ac78..89c4d008 100644 --- a/copilot-analytics-samples/VivaInsights-Copilot-Dashboard-Sample/README.md +++ b/copilot-analytics-samples/VivaInsights-Copilot-Dashboard-Sample/README.md @@ -1,3 +1,35 @@ +--- +title: Viva Insights Copilot Dashboard +type: analytics +category: Power BI +summary: >- + Visualize a Viva Insights Advanced Insights person-query export in Power BI, including dynamic + personas and usage profiles. +author: Alejandro Lopez +version: 2.0.0 +published: "2024-05-03" +updated: "2025-03-17" +tags: + - power-bi + - viva-insights + - adoption +format: pbix +whatItIs: >- + A pair of Power BI templates that visualize Viva Insights Advanced Insights person-query exports, + including a dynamic-personas view with user-profile usage. +whyUseIt: + - Explore Copilot adoption alongside collaboration and organizational attributes. + - Start from a reusable Power BI model instead of designing a dashboard from scratch. +howToUse: >- + Download the PBIX file that matches the desired dashboard, review the included Word instructions, + export the required Viva Insights Advanced Insights person query, and update the report data + source before refreshing. +prerequisites: + - Microsoft Viva Advanced Insights + - Power BI Desktop + - Viva Insights person-query export +--- + # Build your Own Copilot Dashboard - Sample ## Summary diff --git a/copilot-analytics-samples/copilot-interaction-report/README.md b/copilot-analytics-samples/copilot-interaction-report/README.md index 2c5835fe..100200d6 100644 --- a/copilot-analytics-samples/copilot-interaction-report/README.md +++ b/copilot-analytics-samples/copilot-interaction-report/README.md @@ -1,3 +1,44 @@ +--- +title: Copilot Interaction Report +type: analytics +category: PowerShell + Graph +summary: >- + Export Copilot interaction history from Microsoft Graph and build a self-contained HTML usage + dashboard without Power BI. +author: Dean Cron +version: 1.0.0 +published: "2026-06-10" +updated: "2026-06-10" +tags: + - graph + - powershell + - dashboard +format: ps1 +featured: true +whatItIs: >- + A PowerShell module and entry script that export per-user Microsoft 365 Copilot interaction + history from Graph and render a self-contained HTML dashboard. +whyUseIt: + - Create an adoption and friction report without Power BI or a database. + - Review users, sessions, surfaces, features, error rates, trends, and recent audited events. + - Authenticate app-only with a client secret or certificate and rebuild reports from cached JSON. +howToUse: >- + 1. Register an Entra application and grant the documented application permissions with admin + consent. + + 2. From PowerShell 7, run `New-CopilotInteractionReport.ps1` with tenant, client, and secret or + certificate parameters. + + 3. Open the generated `copilot-report.html`; use `-SkipExport` to rebuild from existing JSON. +prerequisites: + - PowerShell 7 or later + - Entra app registration + - >- + AiEnterpriseInteraction.Read.All, User.Read.All, and Organization.Read.All application + permissions + - Microsoft 365 Copilot licensed users +--- + # Copilot Interaction Report (PowerShell) 📊 ![Dashboard Sample](./images/dashboard.gif) diff --git a/copilot-prompt-samples/Researcher-OrganizationInsights.md b/copilot-prompt-samples/Researcher-OrganizationInsights.md index 91c9eef5..6bdd9df0 100644 --- a/copilot-prompt-samples/Researcher-OrganizationInsights.md +++ b/copilot-prompt-samples/Researcher-OrganizationInsights.md @@ -1,3 +1,35 @@ +--- +title: Researcher — Automation Opportunities +type: prompt +category: Researcher +summary: >- + Analyze Microsoft 365 signals to identify repetitive work and prioritize high-value Copilot agent + automation opportunities. +author: Alexander Hurtado +version: 1.0.0 +published: "2025-05-14" +updated: "2025-05-15" +tags: + - researcher + - frontier + - automation +format: md +whatItIs: >- + A Microsoft 365 Researcher prompt that looks across available organizational signals for + repetitive, fragmented, or manual workflows suited to intelligent automation. +whyUseIt: + - Discover automation opportunities grounded in observed work patterns. + - Prioritize scenarios by frequency, departments involved, and estimated time savings. + - Focus agent ideas on gaps that need intelligence, summarization, or cross-source coordination. +howToUse: >- + Copy the prompt from this file into Microsoft 365 Researcher. Replace the bracketed department + example with the desired scope, confirm Researcher has access to the intended organizational + sources, run it, and review the structured opportunity table. +prerequisites: + - Access to Microsoft 365 Researcher + - Permission to use the relevant Microsoft 365 organizational data +--- + # Researcher-AutomationOpportunities ## 🎯 Use Case diff --git a/docs/CATALOG-METADATA.md b/docs/CATALOG-METADATA.md new file mode 100644 index 00000000..7d6fc2d0 --- /dev/null +++ b/docs/CATALOG-METADATA.md @@ -0,0 +1,100 @@ +# Catalog metadata schema + +The FastTrack catalog is generated from YAML front matter at the very top of each resource's `README.md`. Prompt resources use the same front matter at the top of their single Markdown file. The catalog build ignores legacy Markdown files without front matter. + +Use `---` on its own line before and after the YAML. YAML block scalars (`>-` and `|-`) are recommended for readable detail content. + +## Copy-paste example + +```yaml +--- +title: "Get-M365CopilotReadiness" +type: script +category: "PowerShell" +summary: "Assess Microsoft 365 Copilot readiness across identity, licensing, collaboration, and compliance settings." +author: + - "John Cummings" +version: 1.0.0 +published: 2025-08-20 +updated: 2025-09-09 +tags: + - copilot + - readiness + - governance +format: ps1 +featured: true +status: active +whatItIs: >- + A PowerShell assessment that collects tenant configuration signals and produces + JSON and HTML reports for Microsoft 365 Copilot deployment planning. +whyUseIt: + - "Review identity, licensing, Exchange, SharePoint, OneDrive, Teams, and Graph readiness in one run." + - "Give administrators readable descriptions and actionable context for collected settings." +howToUse: |- + 1. Download the resource and open PowerShell. + 2. Sign in with the read permissions documented in the README. + 3. Run: + + ```powershell + .\Get-M365CopilotReadiness.ps1 -OutputPath "C:\Temp\M365Readiness" + ``` +prerequisites: + - "Windows PowerShell 5.1 or PowerShell 7" + - "Read access to Microsoft Graph, Exchange Online, SharePoint Online, and Teams" +# url: "https://github.com/microsoft/FastTrack/tree/master/scripts/Get-M365CopilotReadiness" +--- +``` + +## Required fields + +| Field | Type | Guidance | +| --- | --- | --- | +| `title` | string | Human-readable resource name. It becomes `name` in `catalog.json`. | +| `type` | enum | One of `script`, `agent`, `strategy`, `analytics`, `prompt`, or `skill`. | +| `category` | string | Short sub-label such as `PowerShell`, `Copilot Studio`, `Agent Builder`, `Power BI`, or `Interactive`. | +| `summary` | string | Card description. Must be 140 characters or fewer. | +| `author` | string or string list | Original author(s), substantial co-authors, or `Microsoft FastTrack`. | +| `version` | semver string | `MAJOR.MINOR.PATCH`, for example `1.2.0`. Quote it only if your YAML editor changes its type. | +| `published` | date string | Original publication date in `YYYY-MM-DD` format. Do not change it on updates. | +| `updated` | date string | Most recent resource change in `YYYY-MM-DD` format. The generator can derive it from Git when omitted, but committed metadata should normally be explicit. | + +## Recommended fields + +| Field | Type | Guidance | +| --- | --- | --- | +| `tags` | string list | Lowercase discovery terms. Prefer a few specific tags over many broad ones. | +| `format` | enum | One of `ps1`, `bundle`, `declarative`, `interactive`, `pptx`, `pbix`, or `md`. This replaces the former `artifact` label. | +| `featured` | boolean | Use sparingly for resources selected for catalog promotion. Default is `false`. | +| `status` | enum | `active`, `preview`, or `archived`. Default is `active`. | +| `url` | HTTPS URL | Optional GitHub or destination URL. When omitted, the generator derives a GitHub URL from the resource path. | + +## Detail-page content + +These fields answer what the resource is, why someone should consider it, and how to use it. + +| Field | Type | Guidance | +| --- | --- | --- | +| `whatItIs` | string | A short factual paragraph describing the resource, its output, and scope. | +| `whyUseIt` | string list | Concrete benefits and when-to-use scenarios. Do not make claims that the README or resource cannot support. | +| `howToUse` | multiline Markdown string | Concise install, configuration, and usage steps. Use a `|-` block scalar so lists and fenced code remain readable. | +| `prerequisites` | string list | Optional licenses, permissions, products, runtimes, modules, or inputs needed before use. | + +## Versioning and authorship + +- Patch releases fix behavior or documentation; minor releases add backward-compatible capability; major releases make breaking changes or substantial rewrites. +- Bump `version` and `updated` for every resource change. +- Preserve the original `published` date. +- Add substantial co-authors to `author`; do not remove the original author. +- Keep a resource-level `CHANGELOG.md` for non-trivial resources. +- Git history is the authoritative audit trail. + +## Validation + +From the repository root: + +```powershell +npm ci --prefix tools\catalog-build +npm run check --prefix tools\catalog-build +``` + +Validation reports every file and field that must be fixed. The default `npm run build` command writes `catalog.json` at the repository root and mirrors it to `design-concepts/catalog.json` for the static site. Do not edit either generated file by hand. diff --git a/index.html b/index.html index 4b3ea4b4..b33cf967 100644 --- a/index.html +++ b/index.html @@ -1,1446 +1,2361 @@ - + - - - FastTrack for Microsoft 365 Copilot - - - - - - + + + Microsoft FastTrack + + + - + + + + + - -