New AddClient example

docs/azure/sdk/dependency-injection.md

@@ -42,15 +42,15 @@ In the *Program.cs* file, invoke the <xref:Microsoft.Extensions.Azure.AzureClien
 
 ### [WebApplicationBuilder](#tab/web-app-builder)
 
-:::code language="csharp" source="snippets/dependency-injection/WebApplicationBuilder/Program.cs" id="snippet_WebApplicationBuilder" highlight="10-26":::
+:::code language="csharp" source="snippets/dependency-injection/WebApplicationBuilder/Program.cs" id="snippet_WebApplicationBuilder" highlight="11-36":::
 
 ### [HostApplicationBuilder](#tab/host-app-builder)
 
-:::code language="csharp" source="snippets/dependency-injection/HostApplicationBuilder/Program.cs" highlight="12-30":::
+:::code language="csharp" source="snippets/dependency-injection/HostApplicationBuilder/Program.cs" highlight="13-39":::
 
 ### [HostBuilder](#tab/host-builder)
 
-:::code language="csharp" source="snippets/dependency-injection/HostBuilder/Program.cs" id="snippet_HostBuilder" highlight="11-26":::
+:::code language="csharp" source="snippets/dependency-injection/HostBuilder/Program.cs" id="snippet_HostBuilder" highlight="12-35":::
 
 ---
 
@@ -59,6 +59,9 @@ In the preceding code:
 * Key Vault Secrets, Blob Storage, and Service Bus clients are registered using the <xref:Microsoft.Extensions.Azure.SecretClientBuilderExtensions.AddSecretClient%2A>, <xref:Microsoft.Extensions.Azure.BlobClientBuilderExtensions.AddBlobServiceClient%2A> and <xref:Microsoft.Extensions.Azure.ServiceBusClientBuilderExtensions.AddServiceBusClientWithNamespace%2A>, respectively. The `Uri`- and `string`-typed arguments are passed. To avoid specifying these URLs explicitly, see the [Store configuration separately from code](#store-configuration-separately-from-code) section.
 * <xref:Azure.Identity.DefaultAzureCredential> is used to satisfy the `TokenCredential` argument requirement for each registered client. When one of the clients is created, `DefaultAzureCredential` is used to authenticate.
 * Service Bus subclients are registered for each queue on the service using the subclient and corresponding options types. The queue names for the subclients are retrieved using a separate method outside of the service registration because the `GetQueuesAsync` method must be run asynchronously.
+* An Azure OpenAI client is registered using a custom client factory via the <xref:Microsoft.Extensions.Azure.AzureClientFactoryBuilder.AddClient%2A> method, which provides control over how a client instance is created. Custom client factories are useful in the following cases:
+  * You need to use other dependencies during the client construction.
+  * A registration extension method doesn't exist for the service client you want to register.
 
 ## Use the registered clients
 

docs/azure/sdk/snippets/dependency-injection/Directory.Packages.props

@@ -11,5 +11,6 @@
     <PackageVersion Include="Microsoft.AspNetCore.OpenApi" Version="8.0.5" />
     <PackageVersion Include="Microsoft.Extensions.Hosting" Version="8.0.0" />
     <PackageVersion Include="Swashbuckle.AspNetCore" Version="6.6.1" />
+    <PackageVersion Include="Azure.AI.OpenAI" Version="2.0.0" />
   </ItemGroup>
 </Project>

docs/azure/sdk/snippets/dependency-injection/HostApplicationBuilder/HostApplicationBuilder.csproj

@@ -14,5 +14,6 @@
     <PackageReference Include="Azure.Storage.Blobs" />
     <PackageReference Include="Microsoft.Extensions.Azure" />
     <PackageReference Include="Microsoft.Extensions.Hosting" />
+    <PackageReference Include="Azure.AI.OpenAI" />
   </ItemGroup>
 </Project>

docs/azure/sdk/snippets/dependency-injection/HostApplicationBuilder/Program.cs

@@ -3,6 +3,7 @@
 using Azure.Messaging.ServiceBus.Administration;
 using Microsoft.Extensions.Azure;
 using Microsoft.Extensions.Hosting;
+using Azure.AI.OpenAI;
 
 List<string> queueNames = await GetQueueNames();
 
@@ -15,7 +16,10 @@
             clientBuilder.AddSecretClient(new Uri("<key_vault_url>"));
             clientBuilder.AddBlobServiceClient(new Uri("<storage_url>"));
             clientBuilder.AddServiceBusClientWithNamespace("<your_namespace>.servicebus.windows.net");
-            clientBuilder.UseCredential(new DefaultAzureCredential());
+
+            // Set a credential for all clients to use by default
+            DefaultAzureCredential credential = new();
+            clientBuilder.UseCredential(credential);
 
             // Register subclients for Service Bus
             foreach (string queueName in queueNames)
@@ -27,6 +31,11 @@
                     _ => throw new InvalidOperationException("Unable to create ServiceBusClient")
                 }).WithName(queueName);
             }
+
+            // Register a custom client factory
+            clientBuilder.AddClient<AzureOpenAIClient, AzureOpenAIClientOptions>(
+                (options, _, _) => new AzureOpenAIClient(
+                    new Uri("<url_here>"), credential, options)); 
         });
     }).Build();
 

docs/azure/sdk/snippets/dependency-injection/HostBuilder/HostBuilder.csproj

@@ -14,5 +14,6 @@
     <PackageReference Include="Azure.Storage.Blobs" />
     <PackageReference Include="Microsoft.Extensions.Azure" />
     <PackageReference Include="Microsoft.Extensions.Hosting" />
+    <PackageReference Include="Azure.AI.OpenAI" />
   </ItemGroup>
 </Project>

docs/azure/sdk/snippets/dependency-injection/HostBuilder/Program.cs

@@ -3,6 +3,7 @@
 using Azure.Messaging.ServiceBus;
 using Azure.Messaging.ServiceBus.Administration;
 using Microsoft.Extensions.Azure;
+using Azure.AI.OpenAI;
 
 List<string> queueNames = await GetQueueNames();
 
@@ -15,7 +16,10 @@
             clientBuilder.AddSecretClient(new Uri("<key_vault_url>"));
             clientBuilder.AddBlobServiceClient(new Uri("<storage_url>"));
             clientBuilder.AddServiceBusClientWithNamespace("<your_namespace>.servicebus.windows.net");
-            clientBuilder.UseCredential(new DefaultAzureCredential());
+
+            // Set a credential for all clients to use by default
+            DefaultAzureCredential credential = new();
+            clientBuilder.UseCredential(credential);
 
             // Register a subclient for each Service Bus Queue
             foreach (string queue in queueNames)
@@ -24,6 +28,11 @@
                     provider.GetService<ServiceBusClient>().CreateSender(queue)
                 ).WithName(queue);
             }
+
+            // Register a custom client factory
+            clientBuilder.AddClient<AzureOpenAIClient, AzureOpenAIClientOptions>(
+                (options, _, _) => new AzureOpenAIClient(
+                    new Uri("<url_here>"), credential, options)); 
         });
     }).Build();
 

docs/azure/sdk/snippets/dependency-injection/WebApplicationBuilder/Program.cs

@@ -3,6 +3,7 @@
 using Azure.Messaging.ServiceBus;
 using Azure.Messaging.ServiceBus.Administration;
 using Microsoft.Extensions.Azure;
+using Azure.AI.OpenAI;
 
 WebApplicationBuilder builder = WebApplication.CreateBuilder(args);
 
@@ -15,7 +16,10 @@
     clientBuilder.AddBlobServiceClient(new Uri("<storage_url>"));
     clientBuilder.AddServiceBusClientWithNamespace(
         "<your_namespace>.servicebus.windows.net");
-    clientBuilder.UseCredential(new DefaultAzureCredential());
+
+    // Set a credential for all clients to use by default
+    DefaultAzureCredential credential = new();
+    clientBuilder.UseCredential(credential);
 
     // Register a subclient for each Service Bus Queue
     foreach (string queue in queueNames)
@@ -24,6 +28,11 @@
             (_, _, provider) => provider.GetService<ServiceBusClient>()
                     .CreateSender(queue)).WithName(queue);
     }
+
+    // Register a custom client factory
+    clientBuilder.AddClient<AzureOpenAIClient, AzureOpenAIClientOptions>(
+        (options, _, _) => new AzureOpenAIClient(
+            new Uri("<url_here>"), credential, options)); 
 });
 
 WebApplication app = builder.Build();

docs/azure/sdk/snippets/dependency-injection/WebApplicationBuilder/WebApplicationBuilder.csproj

@@ -14,6 +14,7 @@
     <PackageReference Include="Microsoft.Extensions.Azure" />
     <PackageReference Include="Microsoft.AspNetCore.OpenApi" />
     <PackageReference Include="Swashbuckle.AspNetCore" />
+    <PackageReference Include="Azure.AI.OpenAI" />
   </ItemGroup>
 
 </Project>