New AddClient example

Author: alexwolfmsft

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="10-31":::
 
 ### [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="12-35":::
 
 ### [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="11-31":::
 
 ---
 
@@ -59,6 +59,15 @@ 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 through the `AddClient<TClient, TOptions>` method, which provides control over how a client instance is created. Custom client factories are useful when you need to use other dependencies during the client construction, or if a service registration extension method does not exist for the service you want to register.
+
+### Register a custom client factory
+
+If you want to take control over how the client instance is created or need to use other dependencies during the client construction use the `AddClient<TClient, TOptions>` method.
+
+Here's an example of how to use `IOptions<T>` instance to construct the client:
+
+:::code language="csharp" source="snippets/dependency-injection/WebApplicationBuilder/Program.cs" id="snippet_WebApplicationBuilder" highlight="10-26":::
 
 ## Use the registered clients
 
@@ -125,6 +134,7 @@ In the [Register clients and subclients](#register-clients-and-subclients) secti
 }
 ```
 
+
 You can add any properties from the <xref:Azure.Core.ClientOptions> class into the JSON file. The settings in the JSON configuration file can be retrieved using <xref:Microsoft.Extensions.Configuration.IConfiguration>.
 
 ### [WebApplicationBuilder](#tab/web-app-builder)

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

@@ -27,6 +27,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>"), new DefaultAzureCredential(), options)); 
         });
     }).Build();
 

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

@@ -24,6 +24,11 @@
                     provider.GetService<ServiceBusClient>().CreateSender(queue)
                 ).WithName(queue);
             }
+
+            // Register a custom client factory
+            clientBuilder.AddClient<AzureOpenAIClient, AzureOpenAIClientOptions>(
+                    (options, _, _) => new AzureOpenAIClient(
+                        new Uri("<url_here>"), new DefaultAzureCredential(), options)); 
         });
     }).Build();
 

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

@@ -24,6 +24,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>"), new DefaultAzureCredential(), options)); 
 });
 
 WebApplication app = builder.Build();