docs: migrate DevTools content to Microsoft 365 Agents Playground#2853
Open
corinagum wants to merge 4 commits into
Open
docs: migrate DevTools content to Microsoft 365 Agents Playground#2853corinagum wants to merge 4 commits into
corinagum wants to merge 4 commits into
Conversation
Contributor
There was a problem hiding this comment.
Pull request overview
Migrates Teams SDK documentation away from deprecated DevTools toward Microsoft 365 Agents Playground for local testing, and updates MCP testing guidance to use the external MCP Inspector.
Changes:
- Adds new Agents Playground docs and updates Developer Tools landing page to feature it.
- Replaces DevTools-focused quickstart/running/test guidance with Agents Playground via
LanguageIncludesections. - Updates MCP server/client docs to remove DevTools plugin references and refresh screenshots/inspection instructions.
Reviewed changes
Copilot reviewed 26 out of 33 changed files in this pull request and generated 1 comment.
Show a summary per file
| File | Description |
|---|---|
| teams.md/src/pages/templates/in-depth-guides/ai/mcp/mcp-server.mdx | Renames included sections to inspector-focused markers. |
| teams.md/src/pages/templates/getting-started/running-in-teams/README.mdx | Replaces inline DevTools monitoring tip with local-test-tip include. |
| teams.md/src/pages/templates/getting-started/quickstart.mdx | Replaces DevTools startup/testing text with includes for local testing + resource link. |
| teams.md/src/pages/templates/getting-started/code-basics.mdx | Removes DevTools-as-plugin narrative; switches to local testing include note. |
| teams.md/src/components/include/in-depth-guides/ai/setup-and-prereqs/typescript.incl.md | Swaps DevTools plugin install for Agents Playground CLI install. |
| teams.md/src/components/include/in-depth-guides/ai/mcp/mcp-server/typescript.incl.md | Removes DevTools plugin usage; adds MCP Inspector guidance (but leaves an empty image section). |
| teams.md/src/components/include/in-depth-guides/ai/mcp/mcp-server/python.incl.md | Removes DevTools plugin usage; updates inspector markers and image alt text. |
| teams.md/src/components/include/in-depth-guides/ai/mcp/mcp-server/csharp.incl.md | Renames section markers to inspector equivalents. |
| teams.md/src/components/include/in-depth-guides/ai/mcp/mcp-client/typescript.incl.md | Replaces DevTools animated GIF reference with Agents Playground screenshot. |
| teams.md/src/components/include/in-depth-guides/ai/mcp/mcp-client/python.incl.md | Replaces DevTools animated GIF reference with Agents Playground screenshot. |
| teams.md/src/components/include/in-depth-guides/ai/mcp/mcp-client/csharp.incl.md | Replaces DevTools animated GIF reference with Agents Playground screenshot. |
| teams.md/src/components/include/getting-started/running-in-teams/typescript.incl.md | Adds Agents Playground local-test tip and removes DevTools log lines. |
| teams.md/src/components/include/getting-started/running-in-teams/python.incl.md | Fixes shown Uvicorn port; adds Agents Playground local-test tip. |
| teams.md/src/components/include/getting-started/running-in-teams/csharp.incl.md | Adds Agents Playground local-test tip and removes DevTools log lines. |
| teams.md/src/components/include/getting-started/quickstart/typescript.incl.md | Adds Agents Playground post-startup explanation + screenshot + resource link. |
| teams.md/src/components/include/getting-started/quickstart/python.incl.md | Adds Agents Playground post-startup explanation + screenshot + resource link. |
| teams.md/src/components/include/getting-started/quickstart/csharp.incl.md | Adds Agents Playground post-startup explanation + screenshot + resource link. |
| teams.md/src/components/include/getting-started/code-basics/typescript.incl.md | Removes DevTools plugin from sample; adds local-test note. |
| teams.md/src/components/include/getting-started/code-basics/python.incl.md | Removes DevTools plugin from sample; adds local-test note. |
| teams.md/src/components/include/getting-started/code-basics/csharp.incl.md | Removes DevTools extension call; adds local-test note. |
| teams.md/docs/main/developer-tools/README.md | Updates overview + nav to prefer Agents Playground; marks DevTools deprecated. |
| teams.md/docs/main/developer-tools/devtools/README.md | Replaces content with deprecation banner + brief description. |
| teams.md/docs/main/developer-tools/devtools/inspect.md | Replaces content with deprecation banner + brief description. |
| teams.md/docs/main/developer-tools/devtools/chat.md | Replaces content with deprecation banner + brief description. |
| teams.md/docs/main/developer-tools/devtools/cards.md | Replaces content with deprecation banner + brief description. |
| teams.md/docs/main/developer-tools/agents-playground/README.md | New docs page: install/launch, DevTools migration guidance, flags, screenshots. |
Comment on lines
+89
to
92
| <!-- inspector-image --> | ||
|
|
||
|  | ||
|
|
||
| <!-- proactive-messaging --> |
Tell customers they can remove the package from their package.json after deleting DevtoolsPlugin, since Playground is a CLI tool and not a project dependency. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
corinagum
force-pushed
the
cg/devtools-deprecation
branch
from
7cd0d72 to
57da905
Compare
Fill the empty inspector-image section in the typescript mcp-server include with the same mcp-inspector.gif reference used in the python include. Resolves the EMPTY_SECTION content-gap that resulted from renaming devtools-gif to inspector-image without populating the TS side. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
corinagum
force-pushed
the
cg/devtools-deprecation
branch
from
57da905 to
42767d8
Compare
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.
Summary
developer-tools/agents-playground/with install, launch, common flags, migration-from-DevTools section, and a link out to the Microsoft Learn guide. Anonymous mode is positioned as the recommended migration path;skipAuth: trueis documented as an alternative.developer-tools/devtools/README.md,chat.md,cards.md,inspect.md). Each banner links to the new Agents Playground page and to the Microsoft Learn guide.N/Anow have real content.devtools-tip→inspector-tip,devtools-gif→inspector-image,devtools-resource-link→local-test-link,devtools-monitoring-tip→local-test-tip,devtools-plugin-example→local-test-note. Touched 16 source files (templates + includes); regenerated alldocs/main/**outputs.agents-playground-blank.png,agents-playground-echo-chat.png,agents-playground-mcp-client-pokemon.png). Deleted 4 stale files (devtools-echo-chat.png,devtools-blank.png,mcp-devtools.gif,mcp-client-pokemon.gif).mcp-inspector.gif(the canonical external MCP testing tool, unrelated to DevTools deprecation).Why
DevTools is being replaced by Microsoft 365 Agents Playground. The docs needed to:
The migration section explicitly tells customers they can remove
@microsoft/teams.dev(and the .NET equivalent) from their dependencies after deletingDevtoolsPlugin, since Playground is a standalone CLI tool and not a project dependency.Test plan
npm run generate:docs(regenerates 64 templates across 3 languages)npm run generate:llms(regenerates llms.txt files)npm run build(succeeded; the 3 broken-anchor warnings are pre-existing sso-troubleshooting refs unrelated to this change)Related work
PRs in the SDK repos:
DevtoolsPlugin, anonymous warning, samples cleanup[Obsolete]on DevTools (Libraries 2.0), samples cleanup, anonymous warning, package metadata🤖 Generated with Claude Code