docs: add Azure OpenAI and Anthropic AI quickstarts by umangsehgal · Pull Request #2957 · microsoft/teams-sdk

Umang (umangsehgal) · 2026-08-13T00:48:39Z

Summary

add AI agent quickstarts for TypeScript, C#, and Python with Azure OpenAI and Anthropic Claude paths
make provider boundaries explicit for the TypeScript runner, .NET IChatClient, and Python Agent Framework
update AI integration, enhancements, MCP, A2A, and onboarding guidance to remove provider-biased or stale wording
link AI from the main build quickstart

Validated sample PRs

Validation

npm run generate:docs
npm run build
verified all three generated AI quickstart routes return HTTP 200 and include Anthropic configuration

The build still reports the existing unrelated broken-anchor warnings in the TypeScript and Python BotBuilder migration integration pages.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 1efed4c9-8c92-4b6f-9544-ccb65cf3d66b

Copilot

Pull request overview

Adds new AI agent quickstarts (Azure OpenAI + Anthropic) across TypeScript/C#/Python docs and rewrites the AI integration guidance to be explicitly provider-neutral, then links AI entry-points from the main build quickstart.

Changes:

Add a new “AI agent quickstart” route + language-specific include content (Azure OpenAI vs Anthropic config + provider-boundary guidance).
Update existing AI integration guides (Build Agent / Enhancements / MCP / A2A) to remove provider-biased wording and align samples/paths.
Link AI quickstart routes from the main “Quickstart: Build your first bot”.

Reviewed changes

Copilot reviewed 23 out of 23 changed files in this pull request and generated 8 comments.

Show a summary per file

File	Description
teams.md/src/pages/templates/in-depth-guides/ai-integrations/teams-enhancements.mdx	Reorders sidebar + updates deprecation wording; adds Tabs imports for provider tabs.
teams.md/src/pages/templates/in-depth-guides/ai-integrations/README.mdx	Updates AI Integrations landing summary + deprecation wording; links to new quickstart.
teams.md/src/pages/templates/in-depth-guides/ai-integrations/mcp-server.mdx	Reorders sidebar + updates deprecation wording.
teams.md/src/pages/templates/in-depth-guides/ai-integrations/build-agent.mdx	Reorders sidebar + adds Tabs imports for provider tabs.
teams.md/src/pages/templates/in-depth-guides/ai-integrations/agent-quickstart.mdx	New quickstart page wiring language includes + provider-neutral framing.
teams.md/src/pages/templates/in-depth-guides/ai-integrations/a2a.mdx	Reorders sidebar + minor markdown emphasis cleanup + deprecation wording.
teams.md/src/components/include/in-depth-guides/ai-integrations/typescript.incl.md	Updates TypeScript “samples” list to include AI agent quickstart + provider-neutral phrasing.
teams.md/src/components/include/in-depth-guides/ai-integrations/teams-enhancements/typescript.incl.md	Updates TypeScript enhancements snippets; adds provider-specific follow-up generation tabs.
teams.md/src/components/include/in-depth-guides/ai-integrations/teams-enhancements/python.incl.md	Notes follow-up generation is provider-neutral via Agent Framework client.
teams.md/src/components/include/in-depth-guides/ai-integrations/teams-enhancements/csharp.incl.md	Minor formatting tweak around feedback section.
teams.md/src/components/include/in-depth-guides/ai-integrations/python.incl.md	Updates Python “samples” list to include AI agent quickstart + provider-neutral phrasing.
teams.md/src/components/include/in-depth-guides/ai-integrations/mcp-server/csharp.incl.md	Updates sample link path from core/samples to samples.
teams.md/src/components/include/in-depth-guides/ai-integrations/csharp.incl.md	Updates C# “samples” list; fixes sample paths to samples/.
teams.md/src/components/include/in-depth-guides/ai-integrations/build-agent/typescript.incl.md	Reworks TypeScript guide to multi-provider ai-mcp sample + explicit provider boundary.
teams.md/src/components/include/in-depth-guides/ai-integrations/build-agent/python.incl.md	Updates Python build-agent intro + adds provider selection snippet.
teams.md/src/components/include/in-depth-guides/ai-integrations/build-agent/csharp.incl.md	Updates C# build-agent intro + adds provider switch for IChatClient registration.
teams.md/src/components/include/in-depth-guides/ai-integrations/agent-quickstart/typescript.incl.md	New TS quickstart include: setup, env config tabs, provider boundary contract.
teams.md/src/components/include/in-depth-guides/ai-integrations/agent-quickstart/python.incl.md	New Python quickstart include: setup, env config tabs, provider boundary snippet.
teams.md/src/components/include/in-depth-guides/ai-integrations/agent-quickstart/csharp.incl.md	New C# quickstart include: setup, env config tabs, DI provider selection snippet.
teams.md/src/components/include/in-depth-guides/ai-integrations/a2a/typescript.incl.md	Provider-neutral wording + formatting cleanup in TS A2A include.
teams.md/src/components/include/in-depth-guides/ai-integrations/a2a/python.incl.md	Provider-neutral wording in Python A2A include.
teams.md/src/components/include/in-depth-guides/ai-integrations/a2a/csharp.incl.md	Updates sample link path from core/samples to samples.
teams.md/docs/main/get-started/quickstart-build.md	Adds “Add AI” section linking to new AI agent quickstarts.

Suppressed comments (2)

teams.md/src/components/include/in-depth-guides/ai-integrations/build-agent/typescript.incl.md:45

[HIGH] This snippet also uses required(...) without defining it in-scope, so it’s not copy/paste runnable.

import Anthropic from '@anthropic-ai/sdk';

const agent: IAgentRunner = new AnthropicAgent({

teams.md/src/components/include/in-depth-guides/ai-integrations/agent-quickstart/typescript.incl.md:121

[HIGH] This snippet also calls required(...) without defining it in the code block, so it’s not copy/paste runnable.

const agent: IAgentRunner = new AnthropicAgent({

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

@@ -0,0 +1,60 @@
+---
+sidebar_position: 1


 sidebar_position: 1
 title: AI Integrations
-summary: Plug AI agents into Teams apps — bring your own framework or the OpenAI SDK, add MCP tools and servers, and coordinate bots with A2A.
+summary: Plug AI agents into Teams apps — choose Azure OpenAI or Anthropic Claude, add MCP tools and servers, and coordinate bots with A2A.


@@ -0,0 +1,104 @@
+<!-- prerequisites -->
+
+- .NET 10 SDK


 import { AzureOpenAI } from 'openai';

-const client = new AzureOpenAI({
-  endpoint: process.env.AZURE_OPENAI_ENDPOINT!,
-  apiKey: process.env.AZURE_OPENAI_API_KEY!,
-  deployment: process.env.AZURE_OPENAI_MODEL_DEPLOYMENT_NAME!,
-  apiVersion: process.env.AZURE_OPENAI_API_VERSION || '2024-10-21',
+const deployment = required('AZURE_OPENAI_MODEL_DEPLOYMENT_NAME');


-        return 'Clarification card attached.';
-      },
-      parse: (raw: string) => JSON.parse(raw) as ClarificationArgs,
+export const CLARIFICATION_TOOL_SCHEMA = {


    }
-    for (const item of doc?.results ?? []) {
+
+    for (const item of findResults(doc) ?? []) {


+  <TabItem value="azure-openai" label="Azure OpenAI">
+
+```typescript
+const deployment = required('AZURE_OPENAI_MODEL_DEPLOYMENT_NAME');


+Microsoft Agent Framework owns the provider boundary. Startup selects a client, then constructs the same `Agent` with the same tools and middleware:
+
+```python
+provider = getenv("AI_PROVIDER", "azure-openai").strip().lower()


Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 1efed4c9-8c92-4b6f-9544-ccb65cf3d66b

Umang (umangsehgal) · 2026-08-13T01:02:21Z

Deletion audit

I reviewed every changed AI integration file against main.

No documentation pages or files are deleted.
Most removals replace Azure/OpenAI-only wording with provider-neutral wording or move setup into the new language-specific quickstart includes.
The audit found one actual guidance loss: the TypeScript build-agent example referenced buildClarificationCard() without showing it. Commit e1d8c58 restores the complete card builder and schema limits.
C# samples/... paths were directly verified against teams.net/main; those paths exist, while the previously used core/samples/... paths return 404.
C# and Python Anthropic claims are backed by the linked implementation PRs; this docs PR should merge with/after those sample PRs.
CHECKLIST.md remains untracked and untouched.

npm run generate:docs and npm run build pass. The only warnings are the pre-existing unrelated BotBuilder migration anchors noted in the PR description.

Nick Walker (nickwalkmsft)

(Ignore - fat-fingered this review submit)

Nick Walker (nickwalkmsft)

No major notes, but I have some thoughts about how to further evolve this to bring it to Learn that I'll bring up during standup this week.

docs: add multi-provider AI quickstarts

6001988

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 1efed4c9-8c92-4b6f-9544-ccb65cf3d66b

Copilot AI lite review requested due to automatic review settings August 13, 2026 00:48

This was referenced Aug 13, 2026

feat: add Anthropic support to AI MCP sample microsoft/teams.ts#726

Open

feat: add Anthropic support to AI MCP sample microsoft/teams.py#559

Open

feat: add Anthropic support to ExtAIBot microsoft/teams.net#650

Open

Copilot started reviewing on behalf of Umang (umangsehgal) August 13, 2026 00:49 View session

Copilot AI reviewed Aug 13, 2026

View reviewed changes

docs: restore clarification card implementation

e1d8c58

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 1efed4c9-8c92-4b6f-9544-ccb65cf3d66b

Nick Walker (nickwalkmsft) reviewed Aug 17, 2026

View reviewed changes

Nick Walker (nickwalkmsft) approved these changes Aug 17, 2026

View reviewed changes

Navigation Menu

Uh oh!

docs: add Azure OpenAI and Anthropic AI quickstarts - #2957

docs: add Azure OpenAI and Anthropic AI quickstarts#2957
Umang (umangsehgal) wants to merge 2 commits into
mainfrom
umangsehgal/anthropic-agent-guide

Umang (umangsehgal) commented Aug 13, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Umang (umangsehgal) commented Aug 13, 2026

Uh oh!

Nick Walker (nickwalkmsft) left a comment •

edited

Loading

Uh oh!

Nick Walker (nickwalkmsft) left a comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Conversation

Umang (umangsehgal) commented Aug 13, 2026

Summary

Validated sample PRs

Validation

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Umang (umangsehgal) commented Aug 13, 2026

Deletion audit

Uh oh!

Nick Walker (nickwalkmsft) left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Nick Walker (nickwalkmsft) left a comment

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Nick Walker (nickwalkmsft) left a comment •

edited

Loading