Add additionalMetadata sampleTag to all M365 Agents Toolkit samples (#119)

Copilot · garrytrinder · web-flow · commit b11dbee3188d · 2026-03-23T16:30:17.000Z
* Initial plan

* Add additionalMetadata sampleTag to all M365 Agents Toolkit samples and update AGENTS.md

Co-authored-by: garrytrinder &lt;11563347+garrytrinder@users.noreply.github.com&gt;

* Revert changes to non-m365agents.yml files per review feedback

Co-authored-by: garrytrinder &lt;11563347+garrytrinder@users.noreply.github.com&gt;

* Add additionalMetadata sampleTag to all teamsapp.yml files

Co-authored-by: garrytrinder &lt;11563347+garrytrinder@users.noreply.github.com&gt;

---------

Co-authored-by: copilot-swe-agent[bot] &lt;198982749+Copilot@users.noreply.github.com&gt;
Co-authored-by: garrytrinder &lt;11563347+garrytrinder@users.noreply.github.com&gt;
diff --git a/AGENTS.md b/AGENTS.md
@@ -95,8 +95,17 @@ Always use the latest published schema version. Use the links below to identify
 | Declarative agent manifest | [declarative-agent-manifest-1.6](https://learn.microsoft.com/microsoft-365-copilot/extensibility/declarative-agent-manifest-1.6) — replace `1.6` with latest |
 | API plugin manifest | [api-plugin-manifest-2.4](https://learn.microsoft.com/microsoft-365-copilot/extensibility/api-plugin-manifest-2.4) — replace `2.4` with latest |
 
+## `m365agents.yml` metadata
+If the sample includes an `m365agents.yml`, add the following property after `version`:
+```yaml
+additionalMetadata:
+  sampleTag: pnp-copilot-pro-dev:<sample-folder-name>
+```
+Replace `<sample-folder-name>` with the name of your sample folder under `samples/`.
+
 ## Rules
 - Add the sample to the samples table in the root `README.md`
+- Include `additionalMetadata` with the correct `sampleTag` in `m365agents.yml`
 - DO NOT include `projectId` in `m365agents.yml`
 - DO NOT commit secrets, API keys, tenant IDs, or app IDs
 - DO NOT reference assets from external URLs — all assets in `assets/`
@@ -111,6 +120,7 @@ Always use the latest published schema version. Use the links below to identify
 - [ ] Uses correct templates for `README.md` and `sample.json`
 - [ ] All schema versions target latest (see links above)
 - [ ] No `projectId` in `m365agents.yml`
+- [ ] `additionalMetadata.sampleTag` set in `m365agents.yml` (format: `pnp-copilot-pro-dev:<sample-folder-name>`)
 - [ ] No `teamsapp.yml` or `teamsapp.local.yml` (update if present)
 - [ ] No secrets or external asset links
 - [ ] One PR per sample
diff --git a/samples/cea-techpulse/m365agents.yml b/samples/cea-techpulse/m365agents.yml
@@ -3,6 +3,9 @@
 # Visit https://aka.ms/teamsfx-actions for details on actions
 version: v1.8
 
+additionalMetadata:
+  sampleTag: pnp-copilot-pro-dev:cea-techpulse
+
 environmentFolderPath: ./env
 
 # Triggered when 'teamsapp provision' is executed
diff --git a/samples/da-BlogPostHelper/teamsapp.yml b/samples/da-BlogPostHelper/teamsapp.yml
@@ -3,6 +3,9 @@
 # Visit https://aka.ms/teamsfx-actions for details on actions
 version: v1.7
 
+additionalMetadata:
+  sampleTag: pnp-copilot-pro-dev:da-BlogPostHelper
+
 environmentFolderPath: ./env
 
 # Triggered when 'teamsapp provision' is executed
diff --git a/samples/da-CLIForM365-helper/m365agents.yml b/samples/da-CLIForM365-helper/m365agents.yml
@@ -3,6 +3,9 @@
 # Visit https://aka.ms/teamsfx-actions for details on actions
 version: v1.8
 
+additionalMetadata:
+  sampleTag: pnp-copilot-pro-dev:da-CLIForM365-helper
+
 environmentFolderPath: ./env
 
 # Triggered when 'teamsapp provision' is executed
diff --git a/samples/da-CareerCoach/teamsapp.yml b/samples/da-CareerCoach/teamsapp.yml
@@ -3,6 +3,9 @@
 # Visit https://aka.ms/teamsfx-actions for details on actions
 version: v1.7
 
+additionalMetadata:
+  sampleTag: pnp-copilot-pro-dev:da-CareerCoach
+
 environmentFolderPath: ./env
 
 # Triggered when 'teamsapp provision' is executed
diff --git a/samples/da-DocFinder/teamsapp.yml b/samples/da-DocFinder/teamsapp.yml
@@ -3,6 +3,9 @@
 # Visit https://aka.ms/teamsfx-actions for details on actions
 version: v1.7
 
+additionalMetadata:
+  sampleTag: pnp-copilot-pro-dev:da-DocFinder
+
 environmentFolderPath: ./env
 
 # Triggered when 'teamsapp provision' is executed
diff --git a/samples/da-IdeaCoach/teamsapp.yml b/samples/da-IdeaCoach/teamsapp.yml
@@ -3,6 +3,9 @@
 # Visit https://aka.ms/teamsfx-actions for details on actions
 version: v1.7
 
+additionalMetadata:
+  sampleTag: pnp-copilot-pro-dev:da-IdeaCoach
+
 environmentFolderPath: ./env
 
 # Triggered when 'teamsapp provision' is executed
diff --git a/samples/da-LearningCoach/teamsapp.yml b/samples/da-LearningCoach/teamsapp.yml
@@ -3,6 +3,9 @@
 # Visit https://aka.ms/teamsfx-actions for details on actions
 version: v1.7
 
+additionalMetadata:
+  sampleTag: pnp-copilot-pro-dev:da-LearningCoach
+
 environmentFolderPath: ./env
 
 # Triggered when 'teamsapp provision' is executed
diff --git a/samples/da-MyAdvancedCommsBuddy/teamsapp.yml b/samples/da-MyAdvancedCommsBuddy/teamsapp.yml
@@ -3,6 +3,9 @@
 # Visit https://aka.ms/teamsfx-actions for details on actions
 version: v1.7
 
+additionalMetadata:
+  sampleTag: pnp-copilot-pro-dev:da-MyAdvancedCommsBuddy
+
 environmentFolderPath: ./env
 
 # Triggered when 'teamsapp provision' is executed
diff --git a/samples/da-MyCommsBuddy/teamsapp.yml b/samples/da-MyCommsBuddy/teamsapp.yml
@@ -3,6 +3,9 @@
 # Visit https://aka.ms/teamsfx-actions for details on actions
 version: v1.7
 
+additionalMetadata:
+  sampleTag: pnp-copilot-pro-dev:da-MyCommsBuddy
+
 environmentFolderPath: ./env
 
 # Triggered when 'teamsapp provision' is executed
diff --git a/samples/da-PMSpecReviewer/teamsapp.yml b/samples/da-PMSpecReviewer/teamsapp.yml
@@ -3,6 +3,9 @@
 # Visit https://aka.ms/teamsfx-actions for details on actions
 version: v1.7
 
+additionalMetadata:
+  sampleTag: pnp-copilot-pro-dev:da-PMSpecReviewer
+
 environmentFolderPath: ./env
 
 # Triggered when 'teamsapp provision' is executed
diff --git a/samples/da-PMSpecWriter/teamsapp.yml b/samples/da-PMSpecWriter/teamsapp.yml
@@ -3,6 +3,9 @@
 # Visit https://aka.ms/teamsfx-actions for details on actions
 version: v1.7
 
+additionalMetadata:
+  sampleTag: pnp-copilot-pro-dev:da-PMSpecWriter
+
 environmentFolderPath: ./env
 
 # Triggered when 'teamsapp provision' is executed
diff --git a/samples/da-PnPPowerShell-assistant/m365agents.yml b/samples/da-PnPPowerShell-assistant/m365agents.yml
@@ -3,6 +3,9 @@
 # Visit https://aka.ms/teamsfx-actions for details on actions
 version: v1.8
 
+additionalMetadata:
+  sampleTag: pnp-copilot-pro-dev:da-PnPPowerShell-assistant
+
 environmentFolderPath: ./env
 
 # Triggered when 'teamsapp provision' is executed
diff --git a/samples/da-PnPScriptSamplesAgent/m365agents.yml b/samples/da-PnPScriptSamplesAgent/m365agents.yml
@@ -3,6 +3,9 @@
 # Visit https://aka.ms/teamsfx-actions for details on actions
 version: v1.8
 
+additionalMetadata:
+  sampleTag: pnp-copilot-pro-dev:da-PnPScriptSamplesAgent
+
 environmentFolderPath: ./env
 
 # Triggered when 'teamsapp provision' is executed
diff --git a/samples/da-PositivityAgent/teamsapp.yml b/samples/da-PositivityAgent/teamsapp.yml
@@ -3,6 +3,9 @@
 # Visit https://aka.ms/teamsfx-actions for details on actions
 version: v1.8
 
+additionalMetadata:
+  sampleTag: pnp-copilot-pro-dev:da-PositivityAgent
+
 environmentFolderPath: ./env
 
 # Triggered when 'teamsapp provision' is executed
diff --git a/samples/da-PostPilotAgent/teamsapp.yml b/samples/da-PostPilotAgent/teamsapp.yml
@@ -3,6 +3,9 @@
 # Visit https://aka.ms/teamsfx-actions for details on actions
 version: v1.7
 
+additionalMetadata:
+  sampleTag: pnp-copilot-pro-dev:da-PostPilotAgent
+
 environmentFolderPath: ./env
 
 # Triggered when 'teamsapp provision' is executed
diff --git a/samples/da-PresentationAgent/teamsapp.yml b/samples/da-PresentationAgent/teamsapp.yml
@@ -3,6 +3,9 @@
 # Visit https://aka.ms/teamsfx-actions for details on actions
 version: v1.7
 
+additionalMetadata:
+  sampleTag: pnp-copilot-pro-dev:da-PresentationAgent
+
 environmentFolderPath: ./env
 
 # Triggered when 'teamsapp provision' is executed
diff --git a/samples/da-PromptCoach/teamsapp.yml b/samples/da-PromptCoach/teamsapp.yml
@@ -3,6 +3,9 @@
 # Visit https://aka.ms/teamsfx-actions for details on actions
 version: v1.7
 
+additionalMetadata:
+  sampleTag: pnp-copilot-pro-dev:da-PromptCoach
+
 environmentFolderPath: ./env
 
 # Triggered when 'teamsapp provision' is executed
diff --git a/samples/da-SalesGenie/m365agents.yml b/samples/da-SalesGenie/m365agents.yml
@@ -3,6 +3,9 @@
 # Visit https://aka.ms/teamsfx-actions for details on actions
 version: v1.8
 
+additionalMetadata:
+  sampleTag: pnp-copilot-pro-dev:da-SalesGenie
+
 environmentFolderPath: ./env
 
 # Triggered when 'teamsapp provision' is executed
diff --git a/samples/da-SnowWizard/SnowWizard/teamsapp.yml b/samples/da-SnowWizard/SnowWizard/teamsapp.yml
@@ -3,6 +3,9 @@
 # Visit https://aka.ms/teamsfx-actions for details on actions
 version: v1.7
 
+additionalMetadata:
+  sampleTag: pnp-copilot-pro-dev:da-SnowWizard
+
 environmentFolderPath: ./env
 
 # Triggered when 'teamsapp provision' is executed
diff --git a/samples/da-WritingCoach/teamsapp.yml b/samples/da-WritingCoach/teamsapp.yml
@@ -3,6 +3,9 @@
 # Visit https://aka.ms/teamsfx-actions for details on actions
 version: v1.7
 
+additionalMetadata:
+  sampleTag: pnp-copilot-pro-dev:da-WritingCoach
+
 environmentFolderPath: ./env
 
 # Triggered when 'teamsapp provision' is executed
diff --git a/samples/da-adaptive-card-dialog/m365agents.yml b/samples/da-adaptive-card-dialog/m365agents.yml
@@ -3,6 +3,9 @@
 # Visit https://aka.ms/teamsfx-actions for details on actions
 version: v1.10
 
+additionalMetadata:
+  sampleTag: pnp-copilot-pro-dev:da-adaptive-card-dialog
+
 environmentFolderPath: ./env
 
 # Triggered when 'teamsapp provision' is executed
diff --git a/samples/da-adaptive-card-inline-edit/m365agents.yml b/samples/da-adaptive-card-inline-edit/m365agents.yml
@@ -3,6 +3,9 @@
 # Visit https://aka.ms/teamsfx-actions for details on actions
 version: v1.10
 
+additionalMetadata:
+  sampleTag: pnp-copilot-pro-dev:da-adaptive-card-inline-edit
+
 environmentFolderPath: ./env
 
 # Triggered when 'teamsapp provision' is executed
diff --git a/samples/da-azureopenai/teamsapp.yml b/samples/da-azureopenai/teamsapp.yml
@@ -3,6 +3,9 @@
 # Visit https://aka.ms/teamsfx-actions for details on actions
 version: v1.8
 
+additionalMetadata:
+  sampleTag: pnp-copilot-pro-dev:da-azureopenai
+
 environmentFolderPath: ./env
 
 # Triggered when 'teamsapp provision' is executed
diff --git a/samples/da-community-samples-agent/m365agents.yml b/samples/da-community-samples-agent/m365agents.yml
@@ -3,6 +3,9 @@
 # Visit https://aka.ms/teamsfx-actions for details on actions
 version: v1.9
 
+additionalMetadata:
+  sampleTag: pnp-copilot-pro-dev:da-community-samples-agent
+
 environmentFolderPath: ./env
 
 # Triggered when 'teamsapp provision' is executed
diff --git a/samples/da-environmentSustainability/teamsapp.yml b/samples/da-environmentSustainability/teamsapp.yml
@@ -3,6 +3,9 @@
 # Visit https://aka.ms/teamsfx-actions for details on actions
 version: v1.7
 
+additionalMetadata:
+  sampleTag: pnp-copilot-pro-dev:da-environmentSustainability
+
 environmentFolderPath: ./env
 
 # Triggered when 'teamsapp provision' is executed
diff --git a/samples/da-m365-roadmap-tracker/teamsapp.yml b/samples/da-m365-roadmap-tracker/teamsapp.yml
@@ -3,6 +3,9 @@
 # Visit https://aka.ms/teamsfx-actions for details on actions
 version: v1.7
 
+additionalMetadata:
+  sampleTag: pnp-copilot-pro-dev:da-m365-roadmap-tracker
+
 environmentFolderPath: ./env
 
 # Triggered when 'teamsapp provision' is executed
diff --git a/samples/da-microsoftdocssearchagent/m365agents.yml b/samples/da-microsoftdocssearchagent/m365agents.yml
@@ -3,6 +3,9 @@
 # Visit https://aka.ms/teamsfx-actions for details on actions
 version: v1.9
 
+additionalMetadata:
+  sampleTag: pnp-copilot-pro-dev:da-microsoftdocssearchagent
+
 environmentFolderPath: ./env
 
 # Triggered when 'teamsapp provision' is executed
diff --git a/samples/da-pnpassistant/teamsapp.yml b/samples/da-pnpassistant/teamsapp.yml
@@ -3,6 +3,9 @@
 # Visit https://aka.ms/teamsfx-actions for details on actions
 version: v1.8
 
+additionalMetadata:
+  sampleTag: pnp-copilot-pro-dev:da-pnpassistant
+
 environmentFolderPath: ./env
 
 # Triggered when 'teamsapp provision' is executed
diff --git a/samples/da-qna-graphapi-plugin/teamsapp.yml b/samples/da-qna-graphapi-plugin/teamsapp.yml
@@ -3,6 +3,9 @@
 # Visit https://aka.ms/teamsfx-actions for details on actions
 version: v1.7
 
+additionalMetadata:
+  sampleTag: pnp-copilot-pro-dev:da-qna-graphapi-plugin
+
 environmentFolderPath: ./env
 
 # Triggered when 'teamsapp provision' is executed
diff --git a/samples/da-repairs-oauth-validated/teamsapp.yml b/samples/da-repairs-oauth-validated/teamsapp.yml
@@ -3,6 +3,9 @@
 # Visit https://aka.ms/teamsfx-actions for details on actions
 version: v1.7
 
+additionalMetadata:
+  sampleTag: pnp-copilot-pro-dev:da-repairs-oauth-validated
+
 environmentFolderPath: ./env
 
 # Triggered when 'teamsapp provision' is executed
diff --git a/samples/da-repairs-oauth/teamsapp.yml b/samples/da-repairs-oauth/teamsapp.yml
@@ -3,6 +3,9 @@
 # Visit https://aka.ms/teamsfx-actions for details on actions
 version: v1.7
 
+additionalMetadata:
+  sampleTag: pnp-copilot-pro-dev:da-repairs-oauth
+
 environmentFolderPath: ./env
 
 # Triggered when 'teamsapp provision' is executed
diff --git a/samples/da-resolvemate-api/teamsapp.yml b/samples/da-resolvemate-api/teamsapp.yml
@@ -3,6 +3,9 @@
 # Visit https://aka.ms/teamsfx-actions for details on actions
 version: v1.7
 
+additionalMetadata:
+  sampleTag: pnp-copilot-pro-dev:da-resolvemate-api
+
 environmentFolderPath: ./env
 
 # Triggered when 'teamsapp provision' is executed
diff --git a/samples/da-resource-allocation/teamsapp.yml b/samples/da-resource-allocation/teamsapp.yml
@@ -3,6 +3,9 @@
 # Visit https://aka.ms/teamsfx-actions for details on actions
 version: v1.7
 
+additionalMetadata:
+  sampleTag: pnp-copilot-pro-dev:da-resource-allocation
+
 environmentFolderPath: ./env
 
 # Triggered when 'teamsapp provision' is executed
diff --git a/samples/da-ristorante-api/m365agents.yml b/samples/da-ristorante-api/m365agents.yml
@@ -4,7 +4,7 @@
 version: v1.7
 
 additionalMetadata:
-  sampleTag: copilot-pro-dev-samples:da-ristorante-api
+  sampleTag: pnp-copilot-pro-dev:da-ristorante-api
 
 environmentFolderPath: ./env
 
diff --git a/samples/da-sp-agents-finder/m365agents.yml b/samples/da-sp-agents-finder/m365agents.yml
@@ -3,6 +3,9 @@
 # Visit https://aka.ms/teamsfx-actions for details on actions
 version: v1.8
 
+additionalMetadata:
+  sampleTag: pnp-copilot-pro-dev:da-sp-agents-finder
+
 environmentFolderPath: ./env
 
 # Triggered when 'teamsapp provision' is executed
diff --git a/samples/da-teacher/teamsapp.yml b/samples/da-teacher/teamsapp.yml
@@ -3,6 +3,9 @@
 # Visit https://aka.ms/teamsfx-actions for details on actions
 version: v1.8
 
+additionalMetadata:
+  sampleTag: pnp-copilot-pro-dev:da-teacher
+
 environmentFolderPath: ./env
 
 # Triggered when 'teamsapp provision' is executed
diff --git a/samples/da-todo-tasks-graphapi-plugin/teamsapp.yml b/samples/da-todo-tasks-graphapi-plugin/teamsapp.yml
@@ -3,6 +3,9 @@
 # Visit https://aka.ms/teamsfx-actions for details on actions
 version: v1.8
 
+additionalMetadata:
+  sampleTag: pnp-copilot-pro-dev:da-todo-tasks-graphapi-plugin
+
 environmentFolderPath: ./env
 
 # Triggered when 'teamsapp provision' is executed
diff --git a/samples/da-typespec-AzureAISearch_MsGraph-volunteeringapp/m365agents.yml b/samples/da-typespec-AzureAISearch_MsGraph-volunteeringapp/m365agents.yml
diff --git a/samples/da-typespec-appinsights/m365agents.yml b/samples/da-typespec-appinsights/m365agents.yml
diff --git a/samples/da-typespec-azureopenai/m365agents.yml b/samples/da-typespec-azureopenai/m365agents.yml
diff --git a/samples/da-typespec-github/m365agents.yml b/samples/da-typespec-github/m365agents.yml
diff --git a/samples/da-typespec-repairs-apikey/m365agents.yml b/samples/da-typespec-repairs-apikey/m365agents.yml
diff --git a/samples/da-typespec-repairs-oauth/m365agents.yml b/samples/da-typespec-repairs-oauth/m365agents.yml
diff --git a/samples/da-typespec-repairs/m365agents.yml b/samples/da-typespec-repairs/m365agents.yml
diff --git a/samples/da-typespec-tech-support/m365agents.yml b/samples/da-typespec-tech-support/m365agents.yml
diff --git a/samples/da-typespec-todo/m365agents.yml b/samples/da-typespec-todo/m365agents.yml
diff --git a/samples/da-typespec-trey-research/m365agents.yml b/samples/da-typespec-trey-research/m365agents.yml
diff --git a/samples/da-visual-mind-agent/teamsapp.yml b/samples/da-visual-mind-agent/teamsapp.yml
diff --git a/samples/da-volunteeringapp/teamsapp.yml b/samples/da-volunteeringapp/teamsapp.yml
