Skip to content

Commit 4ece36d

Browse files
author
Wenhao Zhang
committed
Merge conflict
2 parents 73e4f9a + 92aaf24 commit 4ece36d

39 files changed

+999
-519
lines changed

‎.openpublishing.redirection.ai.json‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,9 @@
11
{
22
"redirections": [
3+
{
4+
"source_path_from_root": "/docs/ai/azure-ai-for-dotnet-developers.md",
5+
"redirect_url": "/dotnet/ai/resources/azure-ai"
6+
},
37
{
48
"source_path_from_root": "/docs/ai/ai-extensions.md",
59
"redirect_url": "/dotnet/ai/microsoft-extensions-ai",

‎docs/ai/azure-ai-for-dotnet-developers.md‎

Lines changed: 0 additions & 12 deletions
This file was deleted.

‎docs/ai/index.yml‎

Lines changed: 23 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ metadata:
1212
author: alexwolfmsft
1313
ms.author: alexwolf
1414

15-
# linkListType: architecture | concept | deploy | download | get-started | how-to-guide | tutorial | overview | quickstart | reference | sample | tutorial | video | whats-new
15+
# linkListType: architecture | concept | deploy | download | get-started | how-to-guide | tutorial | overview | quickstart | reference | sample | training | tutorial | video | whats-new
1616

1717
landingContent:
1818
# Cards and links should be based on top customer tasks or top subjects
@@ -70,20 +70,6 @@ landingContent:
7070
- text: Work with content filtering
7171
url: how-to/work-with-local-models.md
7272

73-
# Card
74-
- title: Tutorials
75-
linkLists:
76-
- linkListType: tutorial
77-
links:
78-
- text: Scale Azure OpenAI with Azure Container Apps
79-
url: get-started-app-chat-scaling-with-azure-container-apps.md
80-
- text: .NET enterprise chat sample using RAG
81-
url: get-started-app-chat-template.md
82-
- text: Implement RAG using vector search
83-
url: tutorials/tutorial-ai-vector-search.md
84-
- text: Evaluate a model's response
85-
url: tutorials/evaluate-with-reporting.md
86-
8773
# Card
8874
- title: Training
8975
linkLists:
@@ -99,13 +85,27 @@ landingContent:
9985
url: /training/paths/develop-ai-agents-azure-open-ai-semantic-kernel-sdk
10086

10187
# Card
102-
- title: API reference
88+
- title: Tutorials
89+
linkLists:
90+
- linkListType: tutorial
91+
links:
92+
- text: Scale Azure OpenAI with Azure Container Apps
93+
url: get-started-app-chat-scaling-with-azure-container-apps.md
94+
- text: .NET enterprise chat sample using RAG
95+
url: get-started-app-chat-template.md
96+
- text: Implement RAG using vector search
97+
url: tutorials/tutorial-ai-vector-search.md
98+
- text: Evaluate a model's response
99+
url: tutorials/evaluate-with-reporting.md
100+
101+
# Card
102+
- title: External resources
103103
linkLists:
104-
- linkListType: reference
104+
- linkListType: sample
105105
links:
106-
- text: ChatClientBuilder
107-
url: /dotnet/api/microsoft.extensions.ai.chatclientbuilder
108-
- text: IChatClient
109-
url: /dotnet/api/microsoft.extensions.ai.ichatclient
110-
- text: IEmbeddingGenerator
111-
url: /dotnet/api/microsoft.extensions.ai.iembeddinggenerator
106+
- text: Get started resources
107+
url: resources/get-started.md
108+
- text: Azure AI resources
109+
url: resources/azure-ai.md
110+
- text: MCP server resources
111+
url: resources/mcp-servers.md

‎docs/ai/resources/azure-ai.md‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
---
2+
title: Azure AI learning resources
3+
description: This article provides a list of resources about Azure AI scenarios for .NET developers, including documentation and code samples.
4+
ms.date: 09/04/2025
5+
ms.topic: reference
6+
---
7+
8+
# Azure AI learning resources
9+
10+
This article contains an organized list of the best learning resources for .NET developers who are building AI apps using Azure services. Resources include popular quickstart articles, reference samples, documentation, and training courses.
11+
12+
[!INCLUDE [include-file-from-azure-dev-docs-pr](~/azure-dev-docs-pr/articles/ai/includes/azure-ai-for-developers-dotnet.md)]

‎docs/ai/resources/get-started.md‎

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
---
2+
title: Learning resources to get started with AI in .NET
3+
description: This article provides a list of resources for .NET developers who are starting to build AI apps with .NET.
4+
ms.date: 09/04/2025
5+
ms.topic: reference
6+
---
7+
8+
# Learning resources to get started with AI in .NET
9+
10+
This article contains an organized list of the best learning resources for .NET developers who are starting to build AI apps with .NET. Resources include samples, documentation, videos, and workshops.
11+
12+
## Tutorials
13+
14+
- [Generative AI for beginners](https://github.com/microsoft/Generative-AI-for-beginners-dotnet)
15+
16+
## Workshops
17+
18+
- [AI workshop](https://github.com/dotnet-presentations/ai-workshop)
19+
- [Steve Sanderson's AI workshop](https://github.com/SteveSandersonMS/dotnet-ai-workshop)
20+
21+
## Sample apps
22+
23+
- [AI samples for .NET](https://github.com/dotnet/ai-samples)

‎docs/ai/resources/mcp-servers.md‎

Lines changed: 60 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,60 @@
1+
---
2+
title: MCP server learning resources
3+
description: This article provides a list of resources for .NET developers who are building MCP servers.
4+
ms.date: 09/04/2025
5+
ms.topic: reference
6+
---
7+
8+
# MCP server learning resources
9+
10+
This article contains an organized list of the best learning resources for .NET developers who are building Model Context Protocol (MCP) servers. Resources include samples, documentation, videos, and workshops.
11+
12+
## Getting started
13+
14+
| Link | Description |
15+
|------|-------------|
16+
|[Anthropic - Getting Started with MCP](https://modelcontextprotocol.io/docs/getting-started/intro)|Anthropic's official guide to the Model Context Protocol (MCP) and overview on how to get started writing or using an MCP server.|
17+
|[Create a minimal MCP server using C# and publish to NuGet](../quickstarts/build-mcp-server.md)|A quick guide to writing an MCP server in VS Code and publishing it to NuGet.|
18+
|[MCP for Beginners GitHub repo](https://github.com/microsoft/mcp-for-beginners)|A Microsoft-official GitHub repository with a full, hands-on curriculum for developing MCP servers in .NET, Java, TypeScript, JavaScript, Rust, and Python.|
19+
|[Build agents using MCP on Azure](/azure/developer/ai/build-openai-mcp-server-dotnet)| A walkthrough on how to connect an MCP client using Azure OpenAI and MCP server to Azure Container Apps. |
20+
21+
## Libraries
22+
23+
| Link | Description |
24+
|------------------------------------------------------------------|-------------|
25+
| [MCP C# SDK](https://github.com/modelcontextprotocol/csharp-sdk) | Microsoft and Anthropic's official C# SDK for MCP servers and clients. |
26+
27+
## Samples
28+
29+
| Link | Description |
30+
|------|-------------|
31+
|[MCP Workshop GitHub repo](https://github.com/Azure-Samples/mcp-workshop-dotnet)|A sample MCP server and client with corresponding, step-by-step walkthroughs on how to implement them and how MCP works.|
32+
33+
## Documentation
34+
35+
| Link | Description |
36+
|------|-------------|
37+
|[MCP C# SDK Documentation](https://modelcontextprotocol.github.io/csharp-sdk/index.html)|Anthropic's official guide to the Model Context Protocol (MCP) and overview on how to get started writing or using an MCP server.|
38+
|[VS Code MCP Developer Guide](https://code.visualstudio.com/api/extension-guides/ai/mcp)| Official documentation for building, debugging, and registering an MCP server in VS Code.|
39+
40+
## Additional resources
41+
42+
| Link | Description |
43+
|------|-------------|
44+
|[MCP Inspector Tool](https://github.com/modelcontextprotocol/inspector)|The Anthropic-official GitHub repo for the MCP Inspector tool, a visual testing and debugging tool for MCP servers.|
45+
|[MCP servers for VS Code](https://code.visualstudio.com/mcp)|A hub for quickly installing first-party and third-party MCP servers in VS Code.|
46+
|[Third party MCP servers](https://github.com/modelcontextprotocol/servers?tab=readme-ov-file#-third-party-servers)|A GitHub repo containing a comprehensive list of publicly available MCP servers.|
47+
48+
## Videos
49+
50+
| Link | Description |
51+
|------|-------------|
52+
|[MCP Dev Days (Microsoft Reactor)](https://developer.microsoft.com/reactor/series/S-1563/)|A 2-day virtual event and video series showing how to use and write MCP servers.|
53+
|[ASP.NET Community Standup - Build MCP servers with ASP.NET Core](https://www.youtube.com/live/x_6iUhdHnhc?si=J8QQuirYWk0JXC_V)|A roundtable discussion and demo on building an MCP server with ASP.NET Core and the MCP C# SDK.|
54+
55+
## Communities
56+
57+
| Link | Description |
58+
|------|-------------|
59+
|[Anthropic MCP Discussions](https://github.com/orgs/modelcontextprotocol/discussions)|An open forum for discussing MCP in Anthropic's official MCP GitHub repo.|
60+
|[Azure AI Foundry Discord](https://discord.com/invite/ByRwuEEgH4)|A Discord discussion space for developers looking to build with Microsoft AI tooling.|

‎docs/ai/toc.yml‎

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -101,6 +101,12 @@ items:
101101
href: advanced/sample-implementations.md
102102
- name: Resources
103103
items:
104+
- name: Get started resources
105+
href: resources/get-started.md
106+
- name: Azure AI resources
107+
href: resources/azure-ai.md
108+
- name: MCP server resources
109+
href: resources/mcp-servers.md
104110
- name: API reference
105111
items:
106112
- name: ChatClientBuilder
@@ -109,5 +115,3 @@ items:
109115
href: /dotnet/api/microsoft.extensions.ai.ichatclient
110116
- name: IEmbeddingGenerator
111117
href: /dotnet/api/microsoft.extensions.ai.iembeddinggenerator
112-
- name: Azure AI samples and docs
113-
href: azure-ai-for-dotnet-developers.md

‎docs/azure/includes/dotnet-all.md‎

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -32,9 +32,9 @@
3232
| Core - Client - Core | NuGet [1.48.0](https://www.nuget.org/packages/Azure.Core/1.48.0) | [docs](/dotnet/api/overview/azure/Core-readme) | GitHub [1.48.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Core_1.48.0/sdk/core/Azure.Core/) |
3333
| Core Newtonsoft Json | NuGet [2.0.0](https://www.nuget.org/packages/Microsoft.Azure.Core.NewtonsoftJson/2.0.0) | [docs](/dotnet/api/overview/azure/Microsoft.Azure.Core.NewtonsoftJson-readme) | GitHub [2.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Microsoft.Azure.Core.NewtonsoftJson_2.0.0/sdk/core/Microsoft.Azure.Core.NewtonsoftJson/) |
3434
| Core WCF Storage Queues | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Microsoft.CoreWCF.Azure.StorageQueues/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/Microsoft.CoreWCF.Azure.StorageQueues-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Microsoft.CoreWCF.Azure.StorageQueues_1.0.0-beta.1/sdk/extension-wcf/Microsoft.CoreWCF.Azure.StorageQueues/) |
35-
| Data Movement | NuGet [12.2.2](https://www.nuget.org/packages/Azure.Storage.DataMovement/12.2.2) | [docs](/dotnet/api/overview/azure/Storage.DataMovement-readme) | GitHub [12.2.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.DataMovement_12.2.2/sdk/storage/Azure.Storage.DataMovement/) |
36-
| Data Movement - Blobs | NuGet [12.2.2](https://www.nuget.org/packages/Azure.Storage.DataMovement.Blobs/12.2.2) | [docs](/dotnet/api/overview/azure/Storage.DataMovement.Blobs-readme) | GitHub [12.2.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.DataMovement.Blobs_12.2.2/sdk/storage/Azure.Storage.DataMovement.Blobs/) |
37-
| Data Movement - Files Shares | NuGet [12.2.2](https://www.nuget.org/packages/Azure.Storage.DataMovement.Files.Shares/12.2.2) | [docs](/dotnet/api/overview/azure/Storage.DataMovement.Files.Shares-readme) | GitHub [12.2.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.DataMovement.Files.Shares_12.2.2/sdk/storage/Azure.Storage.DataMovement.Files.Shares/) |
35+
| Data Movement | NuGet [12.2.2](https://www.nuget.org/packages/Azure.Storage.DataMovement/12.2.2)<br>NuGet [12.3.0-beta.1](https://www.nuget.org/packages/Azure.Storage.DataMovement/12.3.0-beta.1) | [docs](/dotnet/api/overview/azure/Storage.DataMovement-readme) | GitHub [12.2.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.DataMovement_12.2.2/sdk/storage/Azure.Storage.DataMovement/)<br>GitHub [12.3.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.DataMovement_12.3.0-beta.1/sdk/storage/Azure.Storage.DataMovement/) |
36+
| Data Movement - Blobs | NuGet [12.2.2](https://www.nuget.org/packages/Azure.Storage.DataMovement.Blobs/12.2.2)<br>NuGet [12.3.0-beta.1](https://www.nuget.org/packages/Azure.Storage.DataMovement.Blobs/12.3.0-beta.1) | [docs](/dotnet/api/overview/azure/Storage.DataMovement.Blobs-readme) | GitHub [12.2.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.DataMovement.Blobs_12.2.2/sdk/storage/Azure.Storage.DataMovement.Blobs/)<br>GitHub [12.3.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.DataMovement.Blobs_12.3.0-beta.1/sdk/storage/Azure.Storage.DataMovement.Blobs/) |
37+
| Data Movement - Files Shares | NuGet [12.2.2](https://www.nuget.org/packages/Azure.Storage.DataMovement.Files.Shares/12.2.2)<br>NuGet [12.3.0-beta.1](https://www.nuget.org/packages/Azure.Storage.DataMovement.Files.Shares/12.3.0-beta.1) | [docs](/dotnet/api/overview/azure/Storage.DataMovement.Files.Shares-readme) | GitHub [12.2.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.DataMovement.Files.Shares_12.2.2/sdk/storage/Azure.Storage.DataMovement.Files.Shares/)<br>GitHub [12.3.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.DataMovement.Files.Shares_12.3.0-beta.1/sdk/storage/Azure.Storage.DataMovement.Files.Shares/) |
3838
| Defender EASM | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.Analytics.Defender.Easm/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/Analytics.Defender.Easm-readme?view=azure-dotnet-preview&amp;preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Analytics.Defender.Easm_1.0.0-beta.1/sdk/easm/Azure.Analytics.Defender.Easm/) |
3939
| Dev Center | NuGet [1.0.0](https://www.nuget.org/packages/Azure.Developer.DevCenter/1.0.0) | [docs](/dotnet/api/overview/azure/Developer.DevCenter-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Developer.DevCenter_1.0.0/sdk/devcenter/Azure.Developer.DevCenter/) |
4040
| Device Update | NuGet [1.0.0](https://www.nuget.org/packages/Azure.IoT.DeviceUpdate/1.0.0) | [docs](/dotnet/api/overview/azure/IoT.DeviceUpdate-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.IoT.DeviceUpdate_1.0.0/sdk/deviceupdate/Azure.IoT.DeviceUpdate/) |
@@ -564,8 +564,8 @@
564564
| Microsoft.Azure.Functions.Worker.Core | NuGet [2.0.0](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Core/2.0.0)<br>NuGet [2.50.0-preview1](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Core/2.50.0-preview1) | | |
565565
| Microsoft.Azure.Functions.Worker.Extensions.Abstractions | NuGet [1.3.0](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.Abstractions/1.3.0) | | |
566566
| Microsoft.Azure.Functions.Worker.Extensions.ApplicationInsights | NuGet [1.0.0-preview4](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.ApplicationInsights/1.0.0-preview4) | | |
567-
| Microsoft.Azure.Functions.Worker.Extensions.CosmosDB | NuGet [4.12.0](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.CosmosDB/4.12.0) | | |
568-
| Microsoft.Azure.Functions.Worker.Extensions.EventGrid | NuGet [3.5.0](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.EventGrid/3.5.0) | | |
567+
| Microsoft.Azure.Functions.Worker.Extensions.CosmosDB | NuGet [4.13.0](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.CosmosDB/4.13.0) | | |
568+
| Microsoft.Azure.Functions.Worker.Extensions.EventGrid | NuGet [3.6.0](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.EventGrid/3.6.0) | | |
569569
| Microsoft.Azure.Functions.Worker.Extensions.EventHubs | NuGet [6.5.0](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.EventHubs/6.5.0) | | |
570570
| Microsoft.Azure.Functions.Worker.Extensions.Http | NuGet [3.3.0](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.Http/3.3.0) | | |
571571
| Microsoft.Azure.Functions.Worker.Extensions.Kafka | NuGet [4.1.2](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.Kafka/4.1.2) | | |
@@ -577,9 +577,9 @@
577577
| Microsoft.Azure.Functions.Worker.Extensions.ServiceBus | NuGet [5.23.0](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.ServiceBus/5.23.0) | | |
578578
| Microsoft.Azure.Functions.Worker.Extensions.SignalRService | NuGet [2.0.1](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.SignalRService/2.0.1) | | |
579579
| Microsoft.Azure.Functions.Worker.Extensions.Sql | NuGet [3.1.527](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.Sql/3.1.527) | | |
580-
| Microsoft.Azure.Functions.Worker.Extensions.Storage | NuGet [6.7.0](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.Storage/6.7.0) | | |
581-
| Microsoft.Azure.Functions.Worker.Extensions.Storage.Blobs | NuGet [6.7.0](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.Storage.Blobs/6.7.0) | | |
582-
| Microsoft.Azure.Functions.Worker.Extensions.Storage.Queues | NuGet [5.5.2](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.Storage.Queues/5.5.2) | | |
580+
| Microsoft.Azure.Functions.Worker.Extensions.Storage | NuGet [6.8.0](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.Storage/6.8.0) | | |
581+
| Microsoft.Azure.Functions.Worker.Extensions.Storage.Blobs | NuGet [6.8.0](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.Storage.Blobs/6.8.0) | | |
582+
| Microsoft.Azure.Functions.Worker.Extensions.Storage.Queues | NuGet [5.5.3](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.Storage.Queues/5.5.3) | | |
583583
| Microsoft.Azure.Functions.Worker.Extensions.Storage.Tables | NuGet [1.0.0-preview1](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.Storage.Tables/1.0.0-preview1) | | |
584584
| Microsoft.Azure.Functions.Worker.Extensions.Tables | NuGet [1.5.0](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.Tables/1.5.0) | | |
585585
| Microsoft.Azure.Functions.Worker.Extensions.Timer | NuGet [4.3.1](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.Timer/4.3.1) | | |

0 commit comments

Comments
 (0)