Bump the dotnet group in /docs/core/extensions/snippets/ai/ConsoleAI.DependencyInjection with 4 updates (#45220)

dependabot[bot] · gewarren · web-flow · commit 1c650e1b5e21 · 2025-03-17T13:33:26.000-07:00
* Bump the dotnet group Bumps the dotnet group in /docs/core/extensions/snippets/ai/ConsoleAI.DependencyInjection with 4 updates: [Microsoft.Extensions.AI](https://github.com/dotnet/extensions), [System.Threading.RateLimiting](https://github.com/dotnet/runtime), [Microsoft.Extensions.Caching.Memory](https://github.com/dotnet/runtime) and [Microsoft.Extensions.Hosting](https://github.com/dotnet/runtime). Updates `Microsoft.Extensions.AI` from 9.3.0-preview.1.25114.11 to 9.3.0-preview.1.25161.3 - [Release notes](https://github.com/dotnet/extensions/releases) - [Commits](https://github.com/dotnet/extensions/commits) Updates `System.Threading.RateLimiting` from 9.0.2 to 9.0.3 - [Release notes](https://github.com/dotnet/runtime/releases) - [Commits](dotnet/runtime@v9.0.2...v9.0.3) Updates `Microsoft.Extensions.Caching.Memory` from 9.0.2 to 9.0.3 - [Release notes](https://github.com/dotnet/runtime/releases) - [Commits](dotnet/runtime@v9.0.2...v9.0.3) Updates `Microsoft.Extensions.Hosting` from 9.0.2 to 9.0.3 - [Release notes](https://github.com/dotnet/runtime/releases) - [Commits](dotnet/runtime@v9.0.2...v9.0.3) --- updated-dependencies: - dependency-name: Microsoft.Extensions.AI dependency-type: direct:production update-type: version-update:semver-patch dependency-group: dotnet - dependency-name: System.Threading.RateLimiting dependency-type: direct:production update-type: version-update:semver-patch dependency-group: dotnet - dependency-name: Microsoft.Extensions.Caching.Memory dependency-type: direct:production update-type: version-update:semver-patch dependency-group: dotnet - dependency-name: Microsoft.Extensions.Hosting dependency-type: direct:production update-type: version-update:semver-patch dependency-group: dotnet ... Signed-off-by: dependabot[bot] <support@github.com> * update packages and fix code in core/extensions/snippets/ai * remove overload list since it's hard to maintain --------- Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
diff --git a/docs/core/extensions/artificial-intelligence.md b/docs/core/extensions/artificial-intelligence.md
@@ -187,20 +187,13 @@ The consumer can then easily use this in their pipeline, for example:
 
 This example demonstrates [hosted scenario](generic-host.md), where the consumer relies on [dependency injection](dependency-injection.md) to provide the `RateLimiter` instance. The preceding extension methods demonstrate using a `Use` method on <xref:Microsoft.Extensions.AI.ChatClientBuilder>. The `ChatClientBuilder` also provides <xref:Microsoft.Extensions.AI.ChatClientBuilder.Use*> overloads that make it easier to write such delegating handlers.
 
-- <xref:Microsoft.Extensions.AI.ChatClientBuilder.Use(Microsoft.Extensions.AI.AnonymousDelegatingChatClient.GetResponseSharedFunc)>
-- <xref:Microsoft.Extensions.AI.ChatClientBuilder.Use(System.Func{Microsoft.Extensions.AI.IChatClient,Microsoft.Extensions.AI.IChatClient})>
-- <xref:Microsoft.Extensions.AI.ChatClientBuilder.Use(System.Func{Microsoft.Extensions.AI.IChatClient,System.IServiceProvider,Microsoft.Extensions.AI.IChatClient})>
-- <xref:Microsoft.Extensions.AI.ChatClientBuilder.Use(System.Func{System.Collections.Generic.IList{Microsoft.Extensions.AI.ChatMessage},Microsoft.Extensions.AI.ChatOptions,Microsoft.Extensions.AI.IChatClient,System.Threading.CancellationToken,System.Threading.Tasks.Task{Microsoft.Extensions.AI.ChatResponse}},System.Func{System.Collections.Generic.IList{Microsoft.Extensions.AI.ChatMessage},Microsoft.Extensions.AI.ChatOptions,Microsoft.Extensions.AI.IChatClient,System.Threading.CancellationToken,System.Collections.Generic.IAsyncEnumerable{Microsoft.Extensions.AI.ChatResponseUpdate}})>
-
 For example, in the earlier `RateLimitingChatClient` example, the overrides of `GetResponseAsync` and `GetStreamingResponseAsync` only need to do work before and after delegating to the next client in the pipeline. To achieve the same thing without writing a custom class, you can use an overload of `Use` that accepts a delegate that's used for both `GetResponseAsync` and `GetStreamingResponseAsync`, reducing the boilerplate required:
 
 :::code language="csharp" source="snippets/ai/ConsoleAI.UseExample/Program.cs":::
 
-The preceding overload internally uses an `AnonymousDelegatingChatClient`, which enables more complicated patterns with only a little additional code. For example, to achieve the same result but with the <xref:System.Threading.RateLimiting.RateLimiter> retrieved from DI:
-
-:::code language="csharp" source="snippets/ai/ConsoleAI.UseExampleAlt/Program.cs":::
+The preceding overload internally uses an `AnonymousDelegatingChatClient`, which enables more complicated patterns with only a little additional code.
 
-For scenarios where the developer would like to specify delegating implementations of `GetResponseAsync` and `GetStreamingResponseAsync` inline, and where it's important to be able to write a different implementation for each in order to handle their unique return types specially, another overload of `Use` exists that accepts a delegate for each.
+For scenarios where you'd like to specify delegating implementations of `GetResponseAsync` and `GetStreamingResponseAsync` inline, and where it's important to be able to write a different implementation for each in order to handle their unique return types specially, you can use the <xref:Microsoft.Extensions.AI.ChatClientBuilder.Use(System.Func{System.Collections.Generic.IEnumerable{Microsoft.Extensions.AI.ChatMessage},Microsoft.Extensions.AI.ChatOptions,Microsoft.Extensions.AI.IChatClient,System.Threading.CancellationToken,System.Threading.Tasks.Task{Microsoft.Extensions.AI.ChatResponse}},System.Func{System.Collections.Generic.IEnumerable{Microsoft.Extensions.AI.ChatMessage},Microsoft.Extensions.AI.ChatOptions,Microsoft.Extensions.AI.IChatClient,System.Threading.CancellationToken,System.Collections.Generic.IAsyncEnumerable{Microsoft.Extensions.AI.ChatResponseUpdate}})> overload that accepts a delegate for each.
 
 ### Dependency injection
 
diff --git a/docs/core/extensions/snippets/ai/AI.Shared/AI.Shared.csproj b/docs/core/extensions/snippets/ai/AI.Shared/AI.Shared.csproj
@@ -7,8 +7,8 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="Microsoft.Extensions.AI" Version="9.3.0-preview.1.25114.11" />
-    <PackageReference Include="System.Threading.RateLimiting" Version="9.0.2" />
+    <PackageReference Include="Microsoft.Extensions.AI" Version="9.3.0-preview.1.25161.3" />
+    <PackageReference Include="System.Threading.RateLimiting" Version="10.0.0-preview.1.25080.5" />
   </ItemGroup>
 
 </Project>
diff --git a/docs/core/extensions/snippets/ai/AI.Shared/RateLimitingChatClient.cs b/docs/core/extensions/snippets/ai/AI.Shared/RateLimitingChatClient.cs
@@ -7,7 +7,7 @@ public sealed class RateLimitingChatClient(
         : DelegatingChatClient(innerClient)
 {
     public override async Task<ChatResponse> GetResponseAsync(
-        IList<ChatMessage> chatMessages,
+        IEnumerable<ChatMessage> chatMessages,
         ChatOptions? options = null,
         CancellationToken cancellationToken = default)
     {
@@ -24,7 +24,7 @@ public override async Task<ChatResponse> GetResponseAsync(
     }
 
     public override async IAsyncEnumerable<ChatResponseUpdate> GetStreamingResponseAsync(
-        IList<ChatMessage> chatMessages,
+        IEnumerable<ChatMessage> chatMessages,
         ChatOptions? options = null,
         [EnumeratorCancellation] CancellationToken cancellationToken = default)
     {
diff --git a/docs/core/extensions/snippets/ai/AI.Shared/SampleChatClient.cs b/docs/core/extensions/snippets/ai/AI.Shared/SampleChatClient.cs
@@ -6,7 +6,7 @@ public sealed class SampleChatClient(Uri endpoint, string modelId) : IChatClient
     public ChatClientMetadata Metadata { get; } = new(nameof(SampleChatClient), endpoint, modelId);
 
     public async Task<ChatResponse> GetResponseAsync(
-        IList<ChatMessage> chatMessages,
+        IEnumerable<ChatMessage> chatMessages,
         ChatOptions? options = null,
         CancellationToken cancellationToken = default)
     {
@@ -21,15 +21,14 @@ public async Task<ChatResponse> GetResponseAsync(
             "This is yet another response message."
         ];
 
-        return new([new ChatMessage()
-        {
-            Role = ChatRole.Assistant,
-            Text = responses[Random.Shared.Next(responses.Length)],
-        }]);
+        return new(new ChatMessage(
+            ChatRole.Assistant,
+            responses[Random.Shared.Next(responses.Length)]
+            ));
     }
 
     public async IAsyncEnumerable<ChatResponseUpdate> GetStreamingResponseAsync(
-        IList<ChatMessage> chatMessages,
+        IEnumerable<ChatMessage> chatMessages,
         ChatOptions? options = null,
         [EnumeratorCancellation] CancellationToken cancellationToken = default)
     {
@@ -41,11 +40,7 @@ public async IAsyncEnumerable<ChatResponseUpdate> GetStreamingResponseAsync(
             await Task.Delay(100, cancellationToken);
 
             // Yield the next message in the response.
-            yield return new ChatResponseUpdate
-            {
-                Role = ChatRole.Assistant,
-                Text = word,
-            };
+            yield return new ChatResponseUpdate(ChatRole.Assistant, word);
         }
     }
 
diff --git a/docs/core/extensions/snippets/ai/ConsoleAI.CacheResponses/ConsoleAI.CacheResponses.csproj b/docs/core/extensions/snippets/ai/ConsoleAI.CacheResponses/ConsoleAI.CacheResponses.csproj
@@ -8,7 +8,7 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="Microsoft.Extensions.Caching.Memory" Version="9.0.2" />
+    <PackageReference Include="Microsoft.Extensions.Caching.Memory" Version="10.0.0-preview.1.25080.5" />
   </ItemGroup>
 
   <ItemGroup>
diff --git a/docs/core/extensions/snippets/ai/ConsoleAI.ConsumeClientMiddleware/ConsoleAI.ConsumeClientMiddleware.csproj b/docs/core/extensions/snippets/ai/ConsoleAI.ConsumeClientMiddleware/ConsoleAI.ConsumeClientMiddleware.csproj
@@ -8,7 +8,7 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="Microsoft.Extensions.Hosting" Version="9.0.2" />
+    <PackageReference Include="Microsoft.Extensions.Hosting" Version="10.0.0-preview.1.25080.5" />
     <ProjectReference Include="..\AI.Shared\AI.Shared.csproj" />
   </ItemGroup>
 
diff --git a/docs/core/extensions/snippets/ai/ConsoleAI.CustomClientMiddle/ConsoleAI.CustomClientMiddle.csproj b/docs/core/extensions/snippets/ai/ConsoleAI.CustomClientMiddle/ConsoleAI.CustomClientMiddle.csproj
@@ -8,7 +8,7 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="System.Threading.RateLimiting" Version="9.0.2" />
+    <PackageReference Include="System.Threading.RateLimiting" Version="10.0.0-preview.1.25080.5" />
   </ItemGroup>
 
   <ItemGroup>
diff --git a/docs/core/extensions/snippets/ai/ConsoleAI.CustomEmbeddingsMiddle/ConsoleAI.CustomEmbeddingsMiddle.csproj b/docs/core/extensions/snippets/ai/ConsoleAI.CustomEmbeddingsMiddle/ConsoleAI.CustomEmbeddingsMiddle.csproj
@@ -8,7 +8,7 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="Microsoft.Extensions.Caching.Memory" Version="9.0.2" />
+    <PackageReference Include="Microsoft.Extensions.Caching.Memory" Version="10.0.0-preview.1.25080.5" />
     <PackageReference Include="OpenTelemetry.Exporter.Console" Version="1.11.2" />
     <ProjectReference Include="..\AI.Shared\AI.Shared.csproj" />
   </ItemGroup>
diff --git a/docs/core/extensions/snippets/ai/ConsoleAI.CustomEmbeddingsMiddle/Program.cs b/docs/core/extensions/snippets/ai/ConsoleAI.CustomEmbeddingsMiddle/Program.cs
@@ -5,23 +5,23 @@
 using OpenTelemetry.Trace;
 
 // Configure OpenTelemetry exporter
-var sourceName = Guid.NewGuid().ToString();
-var tracerProvider = OpenTelemetry.Sdk.CreateTracerProviderBuilder()
+string sourceName = Guid.NewGuid().ToString();
+TracerProvider tracerProvider = OpenTelemetry.Sdk.CreateTracerProviderBuilder()
     .AddSource(sourceName)
     .AddConsoleExporter()
     .Build();
 
 // Explore changing the order of the intermediate "Use" calls to see that impact
 // that has on what gets cached, traced, etc.
-var generator = new EmbeddingGeneratorBuilder<string, Embedding<float>>(
+IEmbeddingGenerator<string, Embedding<float>> generator = new EmbeddingGeneratorBuilder<string, Embedding<float>>(
         new SampleEmbeddingGenerator(new Uri("http://coolsite.ai"), "target-ai-model"))
     .UseDistributedCache(
         new MemoryDistributedCache(
             Options.Create(new MemoryDistributedCacheOptions())))
     .UseOpenTelemetry(sourceName: sourceName)
     .Build();
 
-var embeddings = await generator.GenerateAsync(
+GeneratedEmbeddings<Embedding<float>> embeddings = await generator.GenerateAsync(
 [
     "What is AI?",
     "What is .NET?",
diff --git a/docs/core/extensions/snippets/ai/ConsoleAI.DependencyInjection/ConsoleAI.DependencyInjection.csproj b/docs/core/extensions/snippets/ai/ConsoleAI.DependencyInjection/ConsoleAI.DependencyInjection.csproj
@@ -8,8 +8,8 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="Microsoft.Extensions.Hosting" Version="9.0.2" />
-    <PackageReference Include="Microsoft.Extensions.Caching.Memory" Version="9.0.2" />
+    <PackageReference Include="Microsoft.Extensions.Hosting" Version="10.0.0-preview.1.25080.5" />
+    <PackageReference Include="Microsoft.Extensions.Caching.Memory" Version="10.0.0-preview.1.25080.5" />
     <ProjectReference Include="..\AI.Shared\AI.Shared.csproj" />
   </ItemGroup>
 
diff --git a/docs/core/extensions/snippets/ai/ConsoleAI.DependencyInjection/Program.cs b/docs/core/extensions/snippets/ai/ConsoleAI.DependencyInjection/Program.cs
@@ -3,17 +3,17 @@
 using Microsoft.Extensions.Hosting;
 
 // App setup
-var builder = Host.CreateApplicationBuilder();
+HostApplicationBuilder builder = Host.CreateApplicationBuilder();
 
 builder.Services.AddDistributedMemoryCache();
 builder.Services.AddChatClient(new SampleChatClient(
         new Uri("http://coolsite.ai"), "target-ai-model"))
     .UseDistributedCache();
 
-using var app = builder.Build();
+using IHost app = builder.Build();
 
 // Elsewhere in the app
-var chatClient = app.Services.GetRequiredService<IChatClient>();
+IChatClient chatClient = app.Services.GetRequiredService<IChatClient>();
 
 Console.WriteLine(await chatClient.GetResponseAsync("What is AI?"));
 
diff --git a/docs/core/extensions/snippets/ai/ConsoleAI.FunctionalityPipelines/ConsoleAI.FunctionalityPipelines.csproj b/docs/core/extensions/snippets/ai/ConsoleAI.FunctionalityPipelines/ConsoleAI.FunctionalityPipelines.csproj
@@ -8,8 +8,8 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="Microsoft.Extensions.Caching.Memory" Version="9.0.2" />
-    <PackageReference Include="Microsoft.Extensions.AI.Ollama" Version="9.3.0-preview.1.25114.11" />
+    <PackageReference Include="Microsoft.Extensions.Caching.Memory" Version="10.0.0-preview.1.25080.5" />
+    <PackageReference Include="Microsoft.Extensions.AI.Ollama" Version="9.3.0-preview.1.25161.3" />
     <PackageReference Include="OpenTelemetry.Exporter.Console" Version="1.11.2" />
   </ItemGroup>
 
diff --git a/docs/core/extensions/snippets/ai/ConsoleAI.FunctionalityPipelines/Program.cs b/docs/core/extensions/snippets/ai/ConsoleAI.FunctionalityPipelines/Program.cs
@@ -5,8 +5,8 @@
 using OpenTelemetry.Trace;
 
 // Configure OpenTelemetry exporter
-var sourceName = Guid.NewGuid().ToString();
-var tracerProvider = OpenTelemetry.Sdk.CreateTracerProviderBuilder()
+string sourceName = Guid.NewGuid().ToString();
+TracerProvider tracerProvider = OpenTelemetry.Sdk.CreateTracerProviderBuilder()
     .AddSource(sourceName)
     .AddConsoleExporter()
     .Build();
diff --git a/docs/core/extensions/snippets/ai/ConsoleAI.GetStreamingResponseAsync/Program.cs b/docs/core/extensions/snippets/ai/ConsoleAI.GetStreamingResponseAsync/Program.cs
@@ -3,7 +3,7 @@
 IChatClient client = new SampleChatClient(
     new Uri("http://coolsite.ai"), "target-ai-model");
 
-await foreach (var update in client.GetStreamingResponseAsync("What is AI?"))
+await foreach (ChatResponseUpdate update in client.GetStreamingResponseAsync("What is AI?"))
 {
     Console.Write(update);
 }
diff --git a/docs/core/extensions/snippets/ai/ConsoleAI.ProvideOptions/ConsoleAI.ProvideOptions.csproj b/docs/core/extensions/snippets/ai/ConsoleAI.ProvideOptions/ConsoleAI.ProvideOptions.csproj
@@ -8,7 +8,7 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="Microsoft.Extensions.AI.Ollama" Version="9.3.0-preview.1.25114.11" />
+    <PackageReference Include="Microsoft.Extensions.AI.Ollama" Version="9.3.0-preview.1.25161.3" />
   </ItemGroup>
 
   <ItemGroup>
diff --git a/docs/core/extensions/snippets/ai/ConsoleAI.ToolCalling/ConsoleAI.ToolCalling.csproj b/docs/core/extensions/snippets/ai/ConsoleAI.ToolCalling/ConsoleAI.ToolCalling.csproj
@@ -8,7 +8,7 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="Microsoft.Extensions.AI.Ollama" Version="9.3.0-preview.1.25114.11" />
+    <PackageReference Include="Microsoft.Extensions.AI.Ollama" Version="9.3.0-preview.1.25161.3" />
   </ItemGroup>
 
   <ItemGroup>
diff --git a/docs/core/extensions/snippets/ai/ConsoleAI.ToolCalling/Program.cs b/docs/core/extensions/snippets/ai/ConsoleAI.ToolCalling/Program.cs
@@ -11,11 +11,11 @@ string GetCurrentWeather() => Random.Shared.NextDouble() > 0.5
     .UseFunctionInvocation()
     .Build();
 
-var response = client.GetStreamingResponseAsync(
+IAsyncEnumerable<ChatResponseUpdate> response = client.GetStreamingResponseAsync(
     "Should I wear a rain coat?",
     new() { Tools = [AIFunctionFactory.Create(GetCurrentWeather)] });
 
-await foreach (var update in response)
+await foreach (ChatResponseUpdate update in response)
 {
     Console.Write(update);
 }
diff --git a/docs/core/extensions/snippets/ai/ConsoleAI.UseExample/Program.cs b/docs/core/extensions/snippets/ai/ConsoleAI.UseExample/Program.cs
@@ -7,7 +7,7 @@
     QueueLimit = int.MaxValue
 });
 
-var client = new SampleChatClient(new Uri("http://localhost"), "test")
+IChatClient client = new SampleChatClient(new Uri("http://localhost"), "test")
     .AsBuilder()
     .UseDistributedCache()
     .Use(async (chatMessages, options, nextAsync, cancellationToken) =>
diff --git a/docs/core/extensions/snippets/ai/ConsoleAI.UseExampleAlt/ConsoleAI.UseExampleAlt.csproj b/docs/core/extensions/snippets/ai/ConsoleAI.UseExampleAlt/ConsoleAI.UseExampleAlt.csproj
diff --git a/docs/core/extensions/snippets/ai/ConsoleAI.UseExampleAlt/Program.cs b/docs/core/extensions/snippets/ai/ConsoleAI.UseExampleAlt/Program.cs
diff --git a/docs/core/extensions/snippets/ai/ConsoleAI.UseTelemetry/Program.cs b/docs/core/extensions/snippets/ai/ConsoleAI.UseTelemetry/Program.cs
@@ -17,4 +17,4 @@
         configure: static c => c.EnableSensitiveData = true)
     .Build();
 
-Console.WriteLine((await client.GetResponseAsync("What is AI?")).Message);
+Console.WriteLine((await client.GetResponseAsync("What is AI?")).Messages.Single());
diff --git a/docs/core/extensions/snippets/ai/ConsoleAI/ConsoleAI.csproj b/docs/core/extensions/snippets/ai/ConsoleAI/ConsoleAI.csproj
@@ -8,7 +8,7 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="Microsoft.Extensions.AI" Version="9.3.0-preview.1.25114.11" />
+    <PackageReference Include="Microsoft.Extensions.AI" Version="9.3.0-preview.1.25161.3" />
   </ItemGroup>
 
   <ItemGroup>
diff --git a/docs/core/extensions/snippets/ai/ConsoleAI/Program.cs b/docs/core/extensions/snippets/ai/ConsoleAI/Program.cs
@@ -5,4 +5,4 @@
 
 var response = await client.GetResponseAsync("What is AI?");
 
-Console.WriteLine(response.Message);
+Console.WriteLine(response.Messages.Single());

Original file line number	Diff line number	Diff line change
`@@ -7,7 +7,7 @@ public sealed class RateLimitingChatClient(`
`7`	`7`	`: DelegatingChatClient(innerClient)`
`8`	`8`	`{`
`9`	`9`	`public override async Task<ChatResponse> GetResponseAsync(`
`10`		`- IList<ChatMessage> chatMessages,`
	`10`	`+ IEnumerable<ChatMessage> chatMessages,`
`11`	`11`	`ChatOptions? options = null,`
`12`	`12`	`CancellationToken cancellationToken = default)`
`13`	`13`	`{`
`@@ -24,7 +24,7 @@ public override async Task<ChatResponse> GetResponseAsync(`
`24`	`24`	`}`
`25`	`25`
`26`	`26`	`public override async IAsyncEnumerable<ChatResponseUpdate> GetStreamingResponseAsync(`
`27`		`- IList<ChatMessage> chatMessages,`
	`27`	`+ IEnumerable<ChatMessage> chatMessages,`
`28`	`28`	`ChatOptions? options = null,`
`29`	`29`	`[EnumeratorCancellation] CancellationToken cancellationToken = default)`
`30`	`30`	`{`