Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
32 commits
Select commit Hold shift + click to select a range
c8dad17
initial commit (#46266)
evgenyfedorov2 May 20, 2025
8506ceb
update two xrefs (#46261)
gewarren May 20, 2025
61a10eb
Update MEAI package versions (#46240)
gewarren May 20, 2025
8d8ebce
Remove invalid author names (#46262)
gewarren May 20, 2025
91cd8aa
Update upgrade.md (#46271)
anangaur May 20, 2025
af1a04e
Complete examples in custom marshalling generation walkthrough (#46272)
AaronRobinsonMSFT May 20, 2025
ec29fb9
Update package index with latest published versions (#46270)
azure-sdk May 20, 2025
7ab263e
Document ProviderAliasAttribute breaking change (#46274)
gewarren May 20, 2025
bdd0e08
Update dotnet-trace.md for --dsrouter switch (#46087)
StephaneDelcroix May 21, 2025
c741638
Update Microsoft.NET.Test.Sdk to 17.14.0 (#46286)
dependabot[bot] May 21, 2025
961c726
Update: (#46289)
dependabot[bot] May 21, 2025
2bf2e10
Bump github/codeql-action from 3.28.17 to 3.28.18 (#46291)
dependabot[bot] May 21, 2025
0eaa640
Update Microsoft.CodeAnalysis.CSharp.Workspaces to 4.14.0 (#46295)
dependabot[bot] May 21, 2025
677aef5
Update: (#46296)
dependabot[bot] May 21, 2025
6c091de
Update MSTest to 3.9.0 (#46297)
dependabot[bot] May 21, 2025
8e2b47d
Update: (#46298)
dependabot[bot] May 21, 2025
437dc2b
Update Microsoft.ServiceFabric.Services to 7.1.2841 (#46300)
dependabot[bot] May 21, 2025
f9ebbb9
Update: (#46302)
dependabot[bot] May 21, 2025
a0662d7
Update Microsoft.SemanticKernel to 1.53.0 (#46303)
dependabot[bot] May 21, 2025
b4545ff
Update Microsoft.NET.Test.Sdk to 17.14.0 (#46301)
dependabot[bot] May 21, 2025
1569a1c
Update: (#46304)
dependabot[bot] May 21, 2025
27549d7
Update: (#46305)
dependabot[bot] May 21, 2025
f35b6b2
Update MSTest.TestFramework to 3.9.0 (#46306)
dependabot[bot] May 21, 2025
6909440
Update Microsoft.NET.Test.Sdk to 17.14.0 (#46307)
dependabot[bot] May 21, 2025
5b47137
Update MSTest to 3.9.0 (#46308)
dependabot[bot] May 21, 2025
0e6fb47
Update Azure.Extensions.AspNetCore.DataProtection.Keys to 1.6.0 (#46282)
dependabot[bot] May 21, 2025
4639298
Update package index with latest published versions (#46278)
azure-sdk May 21, 2025
f69717c
Bump DavidAnson/markdownlint-cli2-action from 19.1.0 to 20.0.0 (#46292)
dependabot[bot] May 21, 2025
20fb093
Add 'scoped' to f1_keywords for F1 help support (fixes #46245) (#46253)
yufeih May 21, 2025
cc12a18
resolve merge conflict in codeowners
gewarren May 21, 2025
0ca423a
globally disable MD059 (#46310)
BillWagner May 21, 2025
cbbec16
Merge branch 'main' of github.com:dotnet/docs into publish0521
gewarren May 21, 2025
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
2 changes: 1 addition & 1 deletion .github/ISSUE_TEMPLATE/02-breaking-change.yml
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ labels:
- Pri1
- doc-idea
assignees:
- camsoper
- gewarren
body:
- type: textarea
id: description
Expand Down
2 changes: 1 addition & 1 deletion .github/workflows/markdownlint.yml
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ jobs:
egress-policy: audit

- uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
- uses: DavidAnson/markdownlint-cli2-action@05f32210e84442804257b2a6f20b273450ec8265 # v19.1.0
- uses: DavidAnson/markdownlint-cli2-action@992badcdf24e3b8eb7e87ff9287fe931bcb00c6e # v20.0.0
with:
config: ".markdownlint-cli2.jsonc"
globs: "**/*.md"
2 changes: 1 addition & 1 deletion .github/workflows/scorecards.yml
Original file line number Diff line number Diff line change
Expand Up @@ -71,6 +71,6 @@ jobs:

# Upload the results to GitHub's code scanning dashboard.
- name: "Upload to code-scanning"
uses: github/codeql-action/upload-sarif@60168efe1c415ce0f5521ea06d5c2062adbeed1b # v3.28.17
uses: github/codeql-action/upload-sarif@ff0a06e83cb2de871e5a09832bc6a81e7276941f # v3.28.18
with:
sarif_file: results.sarif
3 changes: 2 additions & 1 deletion .markdownlint-cli2.jsonc
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,8 @@
"MD050": {
"style": "asterisk"
},
"MD051": false
"MD051": false,
"MD059": false
},
"ignores": [
".github/",
Expand Down
24 changes: 10 additions & 14 deletions docfx.json
Original file line number Diff line number Diff line change
Expand Up @@ -335,8 +335,7 @@
"docs/architecture/modernize-desktop/**/**.md": "OliaG",
"docs/azure/**/*.*": "alexwolfmsft",
"docs/core/**/**.md": "gewarren",
"docs/core/compatibility/**/**.md": "camsoper",
"docs/core/containers/**/**.md": "camsoper",
"docs/core/compatibility/**/**.md": "gewarren",
"docs/core/deploying/**/**.md": "adegeo",
"docs/core/diagnostics/**/**.md": "tommcdon",
"docs/core/extensions/**/**.md": "IEvangelist",
Expand All @@ -349,13 +348,13 @@
"docs/core/tools/**/**.md": "tdykstra",
"docs/core/tutorials/**/**.md": "tdykstra",
"docs/core/versions/**/**.md": "billwagner",
"docs/core/whats-new/**/**.md": "camsoper",
"docs/core/whats-new/**/**.md": "gewarren",
"docs/csharp/**/*.*": "billwagner",
"docs/framework/**/**.md": "gewarren",
"docs/framework/additional-apis/pos-for-net/**/**.md": "TerryWarwick",
"docs/framework/app-domains/**/**.md": "gewarren",
"docs/framework/configure-apps/file-schema/network/**/**.md": "karelz",
"docs/framework/configure-apps/file-schema/wcf/**/**.md": "HongGit",
"docs/framework/configure-apps/file-schema/wcf/**/**.md": "mconnew",
"docs/framework/configure-apps/file-schema/winforms/**/**.md": "adegeo",
"docs/framework/data/**/**.md": "cmastr",
"docs/framework/deployment/**/**.md": "adegeo",
Expand All @@ -378,12 +377,11 @@
"docs/framework/unmanaged-api/strong-naming/**/**.md": "jeffschwMSFT",
"docs/framework/unmanaged-api/tlbexp/**/**.md": "jeffschwMSFT",
"docs/framework/whats-new/**/**.md": "gewarren",
"docs/framework/wcf/**/**.md": "HongGit",
"docs/fsharp/**/**.md": "KathleenDollard",
"docs/framework/wcf/**/**.md": "mconnew",
"docs/fsharp/**/**.md": "billwagner",
"docs/fundamentals/code-analysis/**/**.md": "gewarren",
"docs/fundamentals/runtime-libraries/**/**.md": "gewarren",
"docs/fundamentals/syslib-diagnostics/**/**.md": "gewarren",
"docs/iot/**/*.*": "camsoper",
"docs/machine-learning/**/**.md": "gewarren",
"docs/orleans/**/*.*": "IEvangelist",
"docs/standard/**/**.md": "gewarren",
Expand Down Expand Up @@ -413,7 +411,7 @@
"docs/standard/serialization/**/**.md": "gewarren",
"docs/standard/threading/**/**.md": "billwagner",
"docs/standard/whats-new/**/**.md": "gewarren",
"docs/visual-basic/**/**.md": "KathleenDollard",
"docs/visual-basic/**/**.md": "billwagner",
"docs/whats-new/**/**.md": "billwagner",
"includes/**/**.md": "docs"
},
Expand All @@ -429,8 +427,7 @@
"docs/azure/**/*.*": "alexwolf",
"docs/orleans/**/*.*": "dapine",
"docs/core/**/**.md": "dotnetcontent",
"docs/core/compatibility/**/**.md": "casoper",
"docs/core/containers/**/**.md": "casoper",
"docs/core/compatibility/**/**.md": "gewarren",
"docs/core/deploying/**/**.md": "adegeo",
"docs/core/diagnostics/**/**.md": "tommcdon",
"docs/core/extensions/**/**.md": "dapine",
Expand All @@ -444,7 +441,7 @@
"docs/core/tools/**/**.md": "tdykstra",
"docs/core/tutorials/**/**.md": "tdykstra",
"docs/core/versions/**/**.md": "wiwagn",
"docs/core/whats-new/**/**.md": "casoper",
"docs/core/whats-new/**/**.md": "gewarren",
"docs/csharp/**/*.*": "wiwagn",
"docs/framework/**/**.md": "dotnetcontent",
"docs/framework/app-domains/**/**.md": "gewarren",
Expand All @@ -470,11 +467,10 @@
"docs/framework/unmanaged-api/strong-naming/**/**.md": "jeffschw",
"docs/framework/unmanaged-api/tlbexp/**/**.md": "jeffschw",
"docs/framework/whats-new/**/**.md": "gewarren",
"docs/fsharp/**/**.md": "kdollard",
"docs/fsharp/**/**.md": "wiwagn",
"docs/fundamentals/code-analysis/**/*.md": "gewarren",
"docs/fundamentals/runtime-libraries/**/**.md": "gewarren",
"docs/fundamentals/syslib-diagnostics/**/**.md": "gewarren",
"docs/iot/**/*.*": "casoper",
"docs/machine-learning/**/**.md": "gewarren",
"docs/standard/**/**.md": "gewarren",
"docs/standard/analyzers/**/**.md": "dapine",
Expand Down Expand Up @@ -502,7 +498,7 @@
"docs/standard/serialization/**/**.md": "gewarren",
"docs/standard/threading/**/**.md": "wiwagn",
"docs/standard/whats-new/**/**.md": "dotnetcontent",
"docs/visual-basic/**/**.md": "kdollard",
"docs/visual-basic/**/**.md": "wiwagn",
"includes/**/**.md": "dapine"
},
"ms.date": {
Expand Down
4 changes: 0 additions & 4 deletions docs/ai/dotnet-ai-ecosystem.md
Original file line number Diff line number Diff line change
Expand Up @@ -77,10 +77,6 @@ For example, you can use [Ollama](https://ollama.com/) to [connect to local AI m

[!INCLUDE [vector-databases](includes/vector-databases.md)]

## Other options

This article summarized the tools and SDKs in the .NET ecosystem, with a focus on services that provide official support for .NET. Depending on your needs and stage of app development, you might also want to take a look at the open-source options for the ecosystem in [the unofficial list of .NET + AI resources](https://github.com/jmatthiesen/dotnet-ai-resources?tab=readme-ov-file#models). Microsoft is not the maintainer of many of these projects, so be sure to review their quality, licensing, and support.

## Next steps

- [What is Semantic Kernel?](/semantic-kernel/overview/)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@
<ItemGroup>
<PackageReference Include="Azure.AI.OpenAI" />
<PackageReference Include="Azure.Identity" Version="1.14.0" />
<PackageReference Include="Microsoft.Extensions.AI" Version="9.4.0-preview.1.25207.5" />
<PackageReference Include="Microsoft.Extensions.AI" Version="9.5.0" />
<PackageReference Include="Microsoft.Extensions.AI.OpenAI" Version="9.4.0-preview.1.25207.5" />
</ItemGroup>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@
<PackageReference Include="Azure.AI.OpenAI" Version="2.1.0" />
<PackageReference Include="Azure.Identity" Version="1.14.0" />
<PackageReference Include="Microsoft.AspNetCore.OpenApi" Version="9.0.5" />
<PackageReference Include="Microsoft.Extensions.AI" Version="9.4.0-preview.1.25207.5" />
<PackageReference Include="Microsoft.Extensions.AI" Version="9.5.0" />
<PackageReference Include="Microsoft.Extensions.AI.OpenAI" Version="9.4.0-preview.1.25207.5" />
<PackageReference Include="Microsoft.Extensions.Azure" Version="1.11.0" />
</ItemGroup>
Expand Down
2 changes: 1 addition & 1 deletion docs/ai/quickstarts/chat-local-model.md
Original file line number Diff line number Diff line change
Expand Up @@ -62,7 +62,7 @@ Complete the following steps to create a .NET console app that connects to your
dotnet new console -o LocalAI
```

1. Add the [Microsoft.Extensions.AI.Ollama](https://aka.ms/meai-ollama-nuget) packages to your app:
1. Add the [Microsoft.Extensions.AI.Ollama](https://www.nuget.org/packages/Microsoft.Extensions.AI.Ollama/) package to your app:

```dotnetcli
dotnet add package Microsoft.Extensions.AI.Ollama --prerelease
Expand Down
10 changes: 5 additions & 5 deletions docs/ai/quickstarts/snippets/evaluate-ai-responses/TestAI.csproj
Original file line number Diff line number Diff line change
Expand Up @@ -11,14 +11,14 @@
<ItemGroup>
<PackageReference Include="Azure.AI.OpenAI" Version="2.1.0" />
<PackageReference Include="Azure.Identity" Version="1.14.0" />
<PackageReference Include="Microsoft.Extensions.AI.Abstractions" Version="9.4.0-preview.1.25207.5" />
<PackageReference Include="Microsoft.Extensions.AI.Evaluation" Version="9.4.0-preview.1.25207.5" />
<PackageReference Include="Microsoft.Extensions.AI.Evaluation.Quality" Version="9.4.0-preview.1.25207.5" />
<PackageReference Include="Microsoft.Extensions.AI.Abstractions" Version="9.5.0" />
<PackageReference Include="Microsoft.Extensions.AI.Evaluation" Version="9.5.0" />
<PackageReference Include="Microsoft.Extensions.AI.Evaluation.Quality" Version="9.5.0" />
<PackageReference Include="Microsoft.Extensions.AI.OpenAI" Version="9.4.0-preview.1.25207.5" />
<PackageReference Include="Microsoft.Extensions.Configuration" Version="9.0.5" />
<PackageReference Include="Microsoft.Extensions.Configuration.UserSecrets" Version="9.0.5" />
<PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.14.0-preview-25107-01" />
<PackageReference Include="MSTest" Version="3.8.3" />
<PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.14.0" />
<PackageReference Include="MSTest" Version="3.9.0" />
</ItemGroup>

<ItemGroup>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,11 +11,11 @@
<ItemGroup>
<PackageReference Include="Azure.Identity" Version="1.13.2" />
<PackageReference Include="Azure.AI.OpenAI" Version="2.1.0" />
<PackageReference Include="Microsoft.Extensions.AI" Version="9.4.0-preview.1.25207.5" />
<PackageReference Include="Microsoft.Extensions.AI" Version="9.5.0" />
<PackageReference Include="Microsoft.Extensions.AI.OpenAI" Version="9.4.0-preview.1.25207.5" />
<PackageReference Include="Microsoft.Extensions.Configuration" Version="9.0.4" />
<PackageReference Include="Microsoft.Extensions.Configuration.UserSecrets" Version="9.0.4" />

</ItemGroup>

</Project>
Original file line number Diff line number Diff line change
Expand Up @@ -8,10 +8,10 @@
</PropertyGroup>

<ItemGroup>
<PackageReference Include="Microsoft.Extensions.AI" Version="9.4.0-preview.1.25207.5" />
<PackageReference Include="Microsoft.Extensions.AI" Version="9.5.0" />
<PackageReference Include="Microsoft.Extensions.AI.OpenAI" Version="9.4.0-preview.1.25207.5" />
<PackageReference Include="Microsoft.Extensions.Configuration" Version="10.0.0-preview.3.25171.5" />
<PackageReference Include="Microsoft.Extensions.Configuration.UserSecrets" Version="10.0.0-preview.3.25171.5" />
</ItemGroup>

</Project>
2 changes: 1 addition & 1 deletion docs/ai/quickstarts/snippets/local-ai/Program.cs
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@
// Stream the AI response and add to chat history
Console.WriteLine("AI Response:");
var response = "";
await foreach (var item in
await foreach (ChatResponseUpdate item in
chatClient.GetStreamingResponseAsync(chatHistory))
{
Console.Write(item.Text);
Expand Down
2 changes: 1 addition & 1 deletion docs/ai/quickstarts/snippets/local-ai/ollama.csproj
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@
</PropertyGroup>

<ItemGroup>
<PackageReference Include="Microsoft.Extensions.AI.Ollama" Version="9.4.0-preview.1.25207.5" />
<PackageReference Include="Microsoft.Extensions.AI.Ollama" Version="9.5.0-preview.1.25265.7" />
</ItemGroup>

</Project>
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@
<ItemGroup>
<PackageReference Include="Azure.AI.OpenAI" Version="2.1.0" />
<PackageReference Include="Azure.Identity" Version="1.14.0" />
<PackageReference Include="Microsoft.Extensions.AI" Version="9.4.0-preview.1.25207.5" />
<PackageReference Include="Microsoft.Extensions.AI" Version="9.5.0" />
<PackageReference Include="Microsoft.Extensions.AI.OpenAI" Version="9.4.0-preview.1.25207.5" />
<PackageReference Include="Microsoft.Extensions.Configuration" Version="9.0.5" />
<PackageReference Include="Microsoft.Extensions.Configuration.UserSecrets" Version="9.0.5" />
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@
</PropertyGroup>

<ItemGroup>
<PackageReference Include="Microsoft.Extensions.AI" Version="9.4.4-preview.1.25259.16" />
<PackageReference Include="Microsoft.Extensions.AI" Version="9.5.0" />
<PackageReference Include="System.Threading.RateLimiting" Version="10.0.0-preview.4.25258.110" />
</ItemGroup>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@
</PropertyGroup>

<ItemGroup>
<PackageReference Include="Microsoft.Extensions.AI.Ollama" Version="9.4.0-preview.1.25207.5" />
<PackageReference Include="Microsoft.Extensions.AI.Ollama" Version="9.5.0-preview.1.25265.7" />
<PackageReference Include="Microsoft.Extensions.Caching.Memory" Version="10.0.0-preview.3.25171.5" />
</ItemGroup>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@
</PropertyGroup>

<ItemGroup>
<PackageReference Include="Microsoft.Extensions.AI.Ollama" Version="9.4.0-preview.1.25207.5" />
<PackageReference Include="Microsoft.Extensions.AI.Ollama" Version="9.5.0-preview.1.25265.7" />
<PackageReference Include="Microsoft.Extensions.Hosting" Version="10.0.0-preview.3.25171.5" />
<ProjectReference Include="..\AI.Shared\AI.Shared.csproj" />
</ItemGroup>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,8 +8,8 @@
</PropertyGroup>

<ItemGroup>
<PackageReference Include="Microsoft.Extensions.AI.Ollama" Version="9.4.0-preview.1.25207.5" />
<PackageReference Include="System.Threading.RateLimiting" Version="10.0.0-preview.3.25171.5" />
<PackageReference Include="Microsoft.Extensions.AI.Ollama" Version="9.5.0-preview.1.25265.7" />
<PackageReference Include="System.Threading.RateLimiting" Version="10.0.0-preview.4.25258.110" />
</ItemGroup>

<ItemGroup>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@
</PropertyGroup>

<ItemGroup>
<PackageReference Include="Microsoft.Extensions.AI.Ollama" Version="9.4.0-preview.1.25207.5" />
<PackageReference Include="Microsoft.Extensions.AI.Ollama" Version="9.5.0-preview.1.25265.7" />
<PackageReference Include="Microsoft.Extensions.Hosting" Version="10.0.0-preview.4.25258.110" />
<PackageReference Include="Microsoft.Extensions.Caching.Memory" Version="10.0.0-preview.4.25258.110" />
<ProjectReference Include="..\AI.Shared\AI.Shared.csproj" />
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@

<ItemGroup>
<PackageReference Include="Microsoft.Extensions.Caching.Memory" Version="10.0.0-preview.3.25171.5" />
<PackageReference Include="Microsoft.Extensions.AI.Ollama" Version="9.4.0-preview.1.25207.5" />
<PackageReference Include="Microsoft.Extensions.AI.Ollama" Version="9.5.0-preview.1.25265.7" />
<PackageReference Include="OpenTelemetry.Exporter.Console" Version="1.12.0" />
</ItemGroup>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@
</PropertyGroup>

<ItemGroup>
<PackageReference Include="Microsoft.Extensions.AI.Ollama" Version="9.4.0-preview.1.25207.5" />
<PackageReference Include="Microsoft.Extensions.AI.Ollama" Version="9.5.0-preview.1.25265.7" />
</ItemGroup>

<ItemGroup>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@
</PropertyGroup>

<ItemGroup>
<PackageReference Include="Microsoft.Extensions.AI.Ollama" Version="9.4.0-preview.1.25207.5" />
<PackageReference Include="Microsoft.Extensions.AI.Ollama" Version="9.5.0-preview.1.25265.7" />
</ItemGroup>

<ItemGroup>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@
</PropertyGroup>

<ItemGroup>
<PackageReference Include="Microsoft.Extensions.AI.Ollama" Version="9.4.0-preview.1.25207.5" />
<PackageReference Include="Microsoft.Extensions.AI.Ollama" Version="9.5.0-preview.1.25265.7" />
</ItemGroup>

<ItemGroup>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@
</PropertyGroup>

<ItemGroup>
<PackageReference Include="Microsoft.Extensions.AI.Ollama" Version="9.4.0-preview.1.25207.5" />
<PackageReference Include="Microsoft.Extensions.AI.Ollama" Version="9.5.0-preview.1.25265.7" />
</ItemGroup>

<ItemGroup>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@
</PropertyGroup>

<ItemGroup>
<PackageReference Include="Microsoft.Extensions.AI" Version="9.4.4-preview.1.25259.16" />
<PackageReference Include="Microsoft.Extensions.AI" Version="9.5.0" />
</ItemGroup>

<ItemGroup>
Expand Down
2 changes: 1 addition & 1 deletion docs/ai/tutorials/evaluate-safety.md
Original file line number Diff line number Diff line change
Expand Up @@ -109,7 +109,7 @@ Complete the following steps to create an MSTest project.
Response caching functionality is supported and works the same way regardless of whether the evaluators talk to an LLM or to the Azure AI Foundry Evaluation service. The response will be reused until the corresponding cache entry expires (in 14 days by default), or until any request parameter, such as the the LLM endpoint or the question being asked, is changed.

> [!NOTE]
> This code example passes the LLM <xref:Microsoft.Extensions.AI.IChatClient> as `originalChatClient` to `ToChatConfiguration` <!--TODO add xref for this overload-->. The reason to include the LLM chat client here is to enable getting a chat response from the LLM, and notably, to enable response caching for it. (If you don't want to cache the LLM's response, you can create a separate, local <xref:Microsoft.Extensions.AI.IChatClient> to fetch the response from the LLM.) Instead of passing a <xref:Microsoft.Extensions.AI.IChatClient>, if you already have a <xref:Microsoft.Extensions.AI.Evaluation.ChatConfiguration> for an LLM from another reporting configuration, you can pass that instead, using the <xref:Microsoft.Extensions.AI.Evaluation.Safety.ContentSafetyServiceConfigurationExtensions.ToChatConfiguration(Microsoft.Extensions.AI.Evaluation.Safety.ContentSafetyServiceConfiguration,Microsoft.Extensions.AI.Evaluation.ChatConfiguration)> overload.
> This code example passes the LLM <xref:Microsoft.Extensions.AI.IChatClient> as `originalChatClient` to <xref:Microsoft.Extensions.AI.Evaluation.Safety.ContentSafetyServiceConfigurationExtensions.ToChatConfiguration(Microsoft.Extensions.AI.Evaluation.Safety.ContentSafetyServiceConfiguration,Microsoft.Extensions.AI.IChatClient)>. The reason to include the LLM chat client here is to enable getting a chat response from the LLM, and notably, to enable response caching for it. (If you don't want to cache the LLM's response, you can create a separate, local <xref:Microsoft.Extensions.AI.IChatClient> to fetch the response from the LLM.) Instead of passing a <xref:Microsoft.Extensions.AI.IChatClient>, if you already have a <xref:Microsoft.Extensions.AI.Evaluation.ChatConfiguration> for an LLM from another reporting configuration, you can pass that instead, using the <xref:Microsoft.Extensions.AI.Evaluation.Safety.ContentSafetyServiceConfigurationExtensions.ToChatConfiguration(Microsoft.Extensions.AI.Evaluation.Safety.ContentSafetyServiceConfiguration,Microsoft.Extensions.AI.Evaluation.ChatConfiguration)> overload.
>
> Similarly, if you configure both [LLM-based evaluators](../conceptual/evaluation-libraries.md#quality-evaluators) and [Azure AI Foundry Evaluation service&ndash;based evaluators](../conceptual/evaluation-libraries.md#safety-evaluators) in the reporting configuration, you also need to pass the LLM <xref:Microsoft.Extensions.AI.Evaluation.ChatConfiguration> to <xref:Microsoft.Extensions.AI.Evaluation.Safety.ContentSafetyServiceConfigurationExtensions.ToChatConfiguration(Microsoft.Extensions.AI.Evaluation.Safety.ContentSafetyServiceConfiguration,Microsoft.Extensions.AI.Evaluation.ChatConfiguration)>. Then it returns a <xref:Microsoft.Extensions.AI.Evaluation.ChatConfiguration> that can talk to both types of evaluators.

Expand Down
2 changes: 1 addition & 1 deletion docs/ai/tutorials/snippets/llm-eval/llm-eval.csproj
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
<ItemGroup>
<PackageReference Include="Microsoft.Extensions.Configuration" Version="9.0.5" />
<PackageReference Include="Microsoft.Extensions.Configuration.UserSecrets" Version="9.0.5" />
<PackageReference Include="Microsoft.SemanticKernel" Version="1.49.0" />
<PackageReference Include="Microsoft.SemanticKernel" Version="1.53.0" />
</ItemGroup>

</Project>
Loading
Loading