Skip to content

Merge main into live #46001

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 6 commits into from
May 2, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions .openpublishing.redirection.ai.json
Original file line number Diff line number Diff line change
@@ -1,9 +1,17 @@
{
"redirections": [
{
"source_path_from_root": "/docs/ai/ai-extensions.md",
"redirect_url": "/dotnet/ai/microsoft-extensions-ai"
},
{
"source_path_from_root": "/docs/ai/conceptual/agents.md",
"redirect_url": "/dotnet/ai"
},
{
"source_path_from_root": "/docs/ai/get-started/dotnet-ai-overview.md",
"redirect_url": "/dotnet/ai/overview"
},
{
"source_path_from_root": "/docs/ai/how-to/app-service-db-auth.md",
"redirect_url": "/dotnet/ai"
Expand Down
4 changes: 4 additions & 0 deletions .openpublishing.redirection.core.json
Original file line number Diff line number Diff line change
Expand Up @@ -692,6 +692,10 @@
"source_path_from_root": "/docs/core/dotnet-five.md",
"redirect_url": "/dotnet/core/whats-new/dotnet-5"
},
{
"source_path_from_root": "/docs/core/extensions/artificial-intelligence.md",
"redirect_url": "/dotnet/ai/microsoft-extensions-ai"
},
{
"source_path_from_root": "/docs/core/extensions/culture-insensitive-string-operations.md",
"redirect_url": "/dotnet/core/extensions/performing-culture-insensitive-string-operations"
Expand Down
103 changes: 0 additions & 103 deletions docs/ai/ai-extensions.md

This file was deleted.

2 changes: 1 addition & 1 deletion docs/ai/conceptual/evaluation-libraries.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ ms.date: 03/18/2025

The Microsoft.Extensions.AI.Evaluation libraries (currently in preview) simplify the process of evaluating the quality and accuracy of responses generated by AI models in .NET intelligent apps. Various metrics measure aspects like relevance, truthfulness, coherence, and completeness of the responses. Evaluations are crucial in testing, because they help ensure that the AI model performs as expected and provides reliable and accurate results.

The evaluation libraries, which are built on top of the [Microsoft.Extensions.AI abstractions](../ai-extensions.md), are composed of the following NuGet packages:
The evaluation libraries, which are built on top of the [Microsoft.Extensions.AI abstractions](../microsoft-extensions-ai.md), are composed of the following NuGet packages:

- [📦 Microsoft.Extensions.AI.Evaluation](https://www.nuget.org/packages/Microsoft.Extensions.AI.Evaluation) – Defines the core abstractions and types for supporting evaluation.
- [📦 Microsoft.Extensions.AI.Evaluation.Quality](https://www.nuget.org/packages/Microsoft.Extensions.AI.Evaluation.Quality) – Contains evaluators that assess the quality of LLM responses in an app according to metrics such as relevance, fluency, coherence, and truthfulness.
Expand Down
8 changes: 4 additions & 4 deletions docs/ai/dotnet-ai-ecosystem.md
Original file line number Diff line number Diff line change
@@ -1,21 +1,21 @@
---
title: Overview of the .NET + AI ecosystem
title: .NET + AI ecosystem tools and SDKs
description: This article provides an overview of the ecosystem of SDKs and tools available to .NET developers integrating AI into their applications.
ms.date: 11/24/2024
ms.topic: overview
ms.custom: devx-track-dotnet, devx-track-dotnet-ai
---

# Overview of the .NET + AI ecosystem
# .NET + AI ecosystem tools and SDKs

The .NET ecosystem provides many powerful tools, libraries, and services to develop AI applications. .NET supports both cloud and local AI model connections, many different SDKs for various AI and vector database services, and other tools to help you build intelligent apps of varying scope and complexity.

> [!IMPORTANT]
> Not all of the SDKs and services presented in this doc are maintained by Microsoft. When considering an SDK, make sure to evaluate its quality, licensing, support, and compatibility to ensure they meet your requirements.
> Not all of the SDKs and services presented in this article are maintained by Microsoft. When considering an SDK, make sure to evaluate its quality, licensing, support, and compatibility to ensure they meet your requirements.

## Microsoft.Extensions.AI libraries

[`Microsoft.Extensions.AI`](ai-extensions.md) is a set of core .NET libraries that provide a unified layer of C# abstractions for interacting with AI services, such as small and large language models (SLMs and LLMs), embeddings, and middleware. These APIs were created in collaboration with developers across the .NET ecosystem, including Semantic Kernel. The low-level APIs, such as <xref:Microsoft.Extensions.AI.IChatClient> and <xref:Microsoft.Extensions.AI.IEmbeddingGenerator`2>, were extracted from Semantic Kernel and moved into the <xref:Microsoft.Extensions.AI> namespace.
[`Microsoft.Extensions.AI`](microsoft-extensions-ai.md) is a set of core .NET libraries that provide a unified layer of C# abstractions for interacting with AI services, such as small and large language models (SLMs and LLMs), embeddings, and middleware. These APIs were created in collaboration with developers across the .NET ecosystem, including Semantic Kernel. The low-level APIs, such as <xref:Microsoft.Extensions.AI.IChatClient> and <xref:Microsoft.Extensions.AI.IEmbeddingGenerator`2>, were extracted from Semantic Kernel and moved into the <xref:Microsoft.Extensions.AI> namespace.

`Microsoft.Extensions.AI` provides abstractions that can be implemented by various services, all adhering to the same core concepts. This library is not intended to provide APIs tailored to any specific provider's services. The goal of `Microsoft.Extensions.AI` is to act as a unifying layer within the .NET ecosystem, enabling developers to choose their preferred frameworks and libraries while ensuring seamless integration and collaboration across the ecosystem.

Expand Down
2 changes: 1 addition & 1 deletion docs/ai/how-to/app-service-aoai-auth.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ zone_pivot_groups: azure-interface

# Authenticate to Azure OpenAI from an Azure hosted app using Microsoft Entra ID

This article demonstrates how to use [Microsoft Entra ID managed identities](/azure/app-service/overview-managed-identity) and the [Microsoft.Extensions.AI library](../ai-extensions.md) to authenticate an Azure hosted app to an Azure OpenAI resource.
This article demonstrates how to use [Microsoft Entra ID managed identities](/azure/app-service/overview-managed-identity) and the [Microsoft.Extensions.AI library](../microsoft-extensions-ai.md) to authenticate an Azure hosted app to an Azure OpenAI resource.

A managed identity from Microsoft Entra ID allows your app to easily access other Microsoft Entra protected resources such as Azure OpenAI. The identity is managed by the Azure platform and doesn't require you to provision, manage, or rotate any secrets.

Expand Down
14 changes: 8 additions & 6 deletions docs/ai/index.yml
Original file line number Diff line number Diff line change
Expand Up @@ -23,15 +23,17 @@ landingContent:
linkLists:
- linkListType: get-started
links:
- text: Develop .NET applications
url: get-started/dotnet-ai-overview.md
- text: Learning resources and samples
url: azure-ai-for-dotnet-developers.md
- text: Build an Azure AI chat app with .NET
- text: Develop .NET apps with AI features
url: overview.md
- text: Connect to and prompt an AI model
url: quickstarts/prompt-model.md
- text: Microsoft.Extensions.AI libraries
url: microsoft-extensions-ai.md
- text: Build an Azure AI chat app
url: quickstarts/get-started-openai.md
- text: Summarize text using an Azure OpenAI chat app
url: quickstarts/quickstart-openai-summarize-text.md
- text: Generate images using Azure AI with .NET
- text: Generate images using Azure AI
url: quickstarts/quickstart-openai-generate-images.md

# Card
Expand Down
Loading
Loading