chore: sync microsoft-365-agents-toolkit plugin and skill#1999
Open
qfai wants to merge 1 commit into
Open
Conversation
Sources: - Plugin: microsoft/work-iq @ plugins/microsoft-365-agents-toolkit - Skill: OfficeDev/microsoft-365-agents-toolkit @ packages/vscode-extension/skills/microsoft-365-agents-toolkit Co-authored-by: Copilot <[email protected]>
Contributor
🔍 Skill Validator Results✅ All checks passed
Summary
Full validator output |
Contributor
🔒 PR Risk Scan ResultsScanned 149 changed file(s).
|
Contributor
There was a problem hiding this comment.
Pull request overview
Note
Copilot was unable to run its full agentic suite in this review.
This PR adds a substantial set of Microsoft 365 Agents Toolkit (ATK) “toolchain knowledge” docs plus a broader micro-expert library for Teams/Slack, model providers, deployment, security, and cross-platform guidance.
Changes:
- Added ATK toolchain reference docs (templates, commands, manifests/YAML, playground, publishing) and wired them into a toolkit README.
- Added end-to-end workflow docs for project creation, local testing (Playground), Teams testing, and provision/deploy.
- Added many micro-expert guides across Teams AI, Slack CLI, cross-platform architecture, model providers, deployment routers, and platform-diff docs.
Reviewed changes
Copilot reviewed 80 out of 149 changed files in this pull request and generated 3 comments.
Show a summary per file
| File | Description |
|---|---|
| skills/microsoft-365-agents-toolkit/toolkit/templates.md | Adds atk new -c capability catalog and examples for template selection/creation. |
| skills/microsoft-365-agents-toolkit/toolkit/publish.md | Documents publish workflow (sideload → org catalog → store) and atk commands. |
| skills/microsoft-365-agents-toolkit/toolkit/playground.md | Explains Agents Playground usage, capabilities, and limitations. |
| skills/microsoft-365-agents-toolkit/toolkit/manifest-and-yaml.md | References manifest/declarative agent files and YAML action field pitfalls. |
| skills/microsoft-365-agents-toolkit/toolkit/commands.md | Adds quick reference for common ATK CLI commands. |
| skills/microsoft-365-agents-toolkit/toolkit/README.md | Indexes the toolkit docs and provides a capability matrix/cross-links. |
| skills/microsoft-365-agents-toolkit/test-teams/test-teams.md | Adds Teams testing workflow (devtunnel, provision/deploy, deep dives). |
| skills/microsoft-365-agents-toolkit/test-playground/test-playground.md | Adds an intent router for manual vs automated Playground testing. |
| skills/microsoft-365-agents-toolkit/test-playground/playground.md | Adds manual Playground install/start instructions and config reference. |
| skills/microsoft-365-agents-toolkit/test-playground/playground-cli.md | Adds headless Playground CLI testing patterns (TestClient / server). |
| skills/microsoft-365-agents-toolkit/provision-deploy/provision-deploy.md | Documents local/cloud provision+deploy steps and common gotchas. |
| skills/microsoft-365-agents-toolkit/experts/teams/teams-python.md | Adds Teams SDK for Python patterns and mappings from TS concepts. |
| skills/microsoft-365-agents-toolkit/experts/teams/teams-dotnet.md | Adds Teams SDK for .NET patterns and activity handling guidance. |
| skills/microsoft-365-agents-toolkit/experts/teams/ai.streaming-ts.md | Adds Teams AI streaming patterns (onChunk, ctx.stream) and pitfalls. |
| skills/microsoft-365-agents-toolkit/experts/teams/ai.rag-vectorstores-ts.md | Adds RAG vector store integration patterns and retriever abstraction. |
| skills/microsoft-365-agents-toolkit/experts/teams/ai.rag-retrieval-ts.md | Adds RAG retrieval patterns (function calling + citations) and pitfalls. |
| skills/microsoft-365-agents-toolkit/experts/teams/ai.model-setup-ts.md | Adds model configuration guidance for OpenAI vs Azure OpenAI in Teams AI. |
| skills/microsoft-365-agents-toolkit/experts/teams/ai.memory-localmemory-ts.md | Adds LocalMemory usage, collapse strategies, and per-conversation storage. |
| skills/microsoft-365-agents-toolkit/experts/teams/ai.function-calling-implementation-ts.md | Adds .function() implementation patterns, schemas, and error handling. |
| skills/microsoft-365-agents-toolkit/experts/teams/ai.citations-feedback-ts.md | Adds AI markers, citations, feedback buttons, and feedback event handling. |
| skills/microsoft-365-agents-toolkit/experts/teams/ai.chatprompt-basics-ts.md | Adds ChatPrompt construction/sending patterns and common pitfalls. |
| skills/microsoft-365-agents-toolkit/experts/slack/cli.local-dev-deploy.md | Adds Slack CLI local dev/deploy + hooks model documentation. |
| skills/microsoft-365-agents-toolkit/experts/slack/cli.getting-started.md | Adds Slack CLI install/auth/project scaffolding documentation. |
| skills/microsoft-365-agents-toolkit/experts/slack/cli.app-management.md | Adds Slack CLI app lifecycle + collaborator management documentation. |
| skills/microsoft-365-agents-toolkit/experts/security/index.md | Adds a security router for input validation/secrets management experts. |
| skills/microsoft-365-agents-toolkit/experts/researcher.md | Adds a workflow for turning stub experts into researched content. |
| skills/microsoft-365-agents-toolkit/experts/models/index.md | Adds model-provider router and cluster list including Foundry/OSS options. |
| skills/microsoft-365-agents-toolkit/experts/models/foundry-cloud-ts.md | Adds Azure AI Foundry MaaS + GitHub Models connection patterns. |
| skills/microsoft-365-agents-toolkit/experts/models/anthropic-ts.md | Adds Anthropic SDK usage, tool use, streaming, and pitfalls. |
| skills/microsoft-365-agents-toolkit/experts/fallback.md | Adds fallback procedure for missed experts + web search gap filling. |
| skills/microsoft-365-agents-toolkit/experts/deploy/index.md | Adds deploy router and cluster listing for Azure/AWS and dual-bot deploy. |
| skills/microsoft-365-agents-toolkit/experts/convert/js-to-ts-ts.md | Adds JS→TS conversion rules and patterns. |
| skills/microsoft-365-agents-toolkit/experts/convert/index.md | Adds convert router and cluster lists for multi-language conversion. |
| skills/microsoft-365-agents-toolkit/experts/convert/dependency-mapping-ts.md | Adds dependency mapping tables and audit workflow (gems/JARs → npm). |
| skills/microsoft-365-agents-toolkit/experts/bridge/rest-only-integration-ts.md | Adds raw HTTP integration patterns for Slack/Teams without SDKs. |
| skills/microsoft-365-agents-toolkit/experts/bridge/cross-platform-architecture-ts.md | Adds single-server Slack+Teams architecture patterns and pitfalls. |
| skills/microsoft-365-agents-toolkit/experts/_expert-ts.md | Adds a template for authoring new micro-expert files. |
| skills/microsoft-365-agents-toolkit/experts/README.md | Adds overview of the micro-expert system and inventory narrative. |
| skills/microsoft-365-agents-toolkit/docs/ui-components.md | Adds Slack↔Teams UI mapping (Block Kit vs Adaptive Cards, modals/dialogs). |
| skills/microsoft-365-agents-toolkit/docs/middleware-and-handlers.md | Adds middleware/handler pattern comparison Slack vs Teams and mappings. |
| skills/microsoft-365-agents-toolkit/docs/messaging-and-commands.md | Adds messaging/commands/event/threading comparison and mitigations. |
| skills/microsoft-365-agents-toolkit/docs/interactive-responses.md | Adds ephemeral/update/actions/confirm gaps and mitigation strategies. |
| skills/microsoft-365-agents-toolkit/docs/infrastructure.md | Adds transport/compute/storage/secrets/observability comparison notes. |
| skills/microsoft-365-agents-toolkit/docs/identity-and-auth.md | Adds identity/auth/token model comparison and mapping strategy. |
| skills/microsoft-365-agents-toolkit/docs/files-and-links.md | Adds file upload/download + link unfurl differences and mitigations. |
| skills/microsoft-365-agents-toolkit/docs/advanced-features.md | Adds scheduled messages/reactions/shortcuts/channel ops distribution gaps. |
| skills/microsoft-365-agents-toolkit/docs/README.md | Adds a docs index explaining the platform-difference doc set and evals. |
| skills/microsoft-365-agents-toolkit/create-project/create-project.md | Adds atk new/samples scaffolding workflow and a template selection table. |
| skills/microsoft-365-agents-toolkit/SKILL.md | Updates the skill entrypoint doc and workflow guidance for ATK usage. |
| plugins/microsoft-365-agents-toolkit/README.md | Adds plugin installation/usage instructions and included skills list. |
Comment on lines
+99
to
+106
| ### Step 1: Detect ATK Project | ||
|
|
||
| If `m365agentstoolkit*.yml` exists in the current folder, treat it as an ATK project and parse configuration. | ||
|
|
||
| ### Step 2: Resolve Common Configuration | ||
|
|
||
| Resolve variables referenced in `m365agentstoolkit*.yml`. Common variables: | ||
| AZURE_OPENAI_API_KEY |
| "Deploy my agent with ATK" | ||
|
|
||
| # Create evals | ||
| "Create an eval suite for my agent based on it's capabilities." |
| "Deploy my agent with ATK" | ||
|
|
||
| # Create evals | ||
| "Create an eval suite for my agent based on it's capabilities." |
aaronpowell
requested changes
Jun 16, 2026
aaronpowell
left a comment
Contributor
There was a problem hiding this comment.
I think it'd be a better idea to turn this into an external plugin per the guide here: #1726
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Automated sync of
microsoft-365-agents-toolkitplugin and skill.plugins/microsoft-365-agents-toolkit/- full plugin with all skillsskills/microsoft-365-agents-toolkit/- standalone ATK developer skill