Update Program.cs for Azure/OpenAI integration

EdCharbeneau · EdCharbeneau · commit 66cea27fa886 · 2025-04-11T10:51:44.000-04:00
Refactor using directives and remove commented-out AI client registrations.
Enhance chat client setup with endpoint and API key configurations,
and add guidance for using Visual Studio's "Manage User Secrets."
Modify service registration to include logging and function invocation,
and ensure consistent formatting in the HTTP request pipeline.
diff --git a/common/microsoft-extensions-ai-integration/AIPromptIntegration/AIPromptIntegration/Program.cs b/common/microsoft-extensions-ai-integration/AIPromptIntegration/AIPromptIntegration/Program.cs
@@ -1,59 +1,57 @@
-using AIPromptIntegration.Components;
+﻿using AIPromptIntegration.Components;
 using Microsoft.Extensions.AI;
-using Azure;
-using OpenAI;
+
+// Optional model provider implementations:
+// Azure models
+using Azure; 
 using Azure.AI.OpenAI;
+// OpenAI models
+using OpenAI;
+// GitHub models
+using System.ClientModel; 
 
 var builder = WebApplication.CreateBuilder(args);
 
 // Add services to the container.
 builder.Services.AddRazorComponents()
-    .AddInteractiveServerComponents();
+	.AddInteractiveServerComponents();
 
 builder.Services.AddTelerikBlazor();
 
-#region Azure AI Inference Client registration
-
-//builder.Services.AddChatClient(
-//    new Azure.AI.Inference.ChatCompletionsClient(
-//        new Uri("https://models.inference.ai.azure.com"),
-//        new AzureKeyCredential("YOUR_AZURE_OPENAI_CREDENTIAL")
-//    ).AsChatClient("Phi-3.5-MoE-instruct"));
-
-#endregion Azure AI Inference Client registration
-
-#region OpenAI Client registration
-
-//builder.Services.AddSingleton(new OpenAIClient("YOUR_API_KEY"));
-
-//builder.Services.AddChatClient(services => services.GetRequiredService<OpenAIClient>().AsChatClient("YOUR_MODEL_NAME"));
-
-#endregion OpenAI Client registration
-
-#region Azure OpenAI Client registration
-
-//builder.Services.AddSingleton(new AzureOpenAIClient(
-//   new Uri("YOUR_AZURE_OPENAI_ENDPOINT"),
-//   new AzureKeyCredential("YOUR_AZURE_OPENAI_CREDENTIAL")));
-
-//builder.Services.AddChatClient(services => services.GetRequiredService<AzureOpenAIClient>().AsChatClient("gpt-4o-mini"));
-
-#endregion Azure OpenAI Client registration
-
-#region Ollama Chat Client registration
-
-//builder.Services.AddChatClient(new OllamaChatClient(new Uri("THE_URI_OF_YOUR_CLIENT"), "llama3.1"));
-
-#endregion Ollama Chat Client registration
+// You will need to set the endpoint and key to your own values
+// You can do this using Visual Studio's "Manage User Secrets" UI, or on the command line 💻:
+//   cd this-project-directory
+//   dotnet user-secrets set Endpoint https://YOUR-DEPLOYMENT-NAME.openai.azure.com
+//   dotnet user-secrets set ApiKey super-secret-api-key
+
+// 🌐 The Uri of your provider
+var endpoint = builder.Configuration["Endpoint"] ?? throw new InvalidOperationException("Missing configuration: AzureOpenAi:Endpoint. See the README for details.");
+// 🔑 The API Key for your provider
+var apikey = builder.Configuration["ApiKey"] ?? throw new InvalidOperationException("Missing configuration: AzureOpenAi:ApiKey. See the README for details.");
+// 🧠 The model name or azure deployment name
+var model = "YOUR_MODEL_NAME";
+
+// Replace the innerClient below with your preferred model provider 
+var innerClient = new OpenAIClient(
+			new ApiKeyCredential(apikey),
+			new OpenAIClientOptions()
+			{
+				Endpoint = new Uri(endpoint)
+			}
+		).AsChatClient(model);
+
+builder.Services.AddChatClient(innerClient) // 🤖 Add the configured chat client
+	.UseFunctionInvocation() // 🛠️ Include tool calling
+	.UseLogging(); //🐞 Include Logging
 
 var app = builder.Build();
 
 // Configure the HTTP request pipeline.
 if (!app.Environment.IsDevelopment())
 {
-    app.UseExceptionHandler("/Error", createScopeForErrors: true);
-    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
-    app.UseHsts();
+	app.UseExceptionHandler("/Error", createScopeForErrors: true);
+	// The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
+	app.UseHsts();
 }
 
 app.UseHttpsRedirection();
@@ -62,6 +60,6 @@
 app.UseAntiforgery();
 
 app.MapRazorComponents<App>()
-    .AddInteractiveServerRenderMode();
+	.AddInteractiveServerRenderMode();
 
 app.Run();
diff --git a/common/microsoft-extensions-ai-integration/AIPromptIntegration/readme.md b/common/microsoft-extensions-ai-integration/AIPromptIntegration/readme.md
@@ -26,3 +26,46 @@ To run the project successfully, you need to provide your endpoint and credentia
 3. Replace the placeholder values with your actual endpoint and credentials.
 4. Run the application and interact with the `AIPrompt` component.
 
+### Client Registrations
+
+**Azure AI Inference Client registration**
+
+```csharp
+var innerClient = new Azure.AI.Inference.ChatCompletionsClient(
+        new Uri(endpoint),
+        new AzureKeyCredential(apikey)
+    ).AsChatClient(model);
+```
+
+**Azure OpenAI Client registration**
+
+```csharp
+var innerClient = new AzureOpenAIClient(
+        new Uri(endpoint),
+        new AzureKeyCredential(apikey)
+    ).AsChatClient(model);
+```
+
+**OpenAI Client registration**
+
+```csharp
+var innerClient = new OpenAIClient(apikey)
+                        .AsChatClient(model);
+```
+
+**GitHub Models Client registration**
+
+```csharp
+var innerClient = new OpenAIClient(
+			new ApiKeyCredential(apikey),
+			new OpenAIClientOptions()
+			{
+				Endpoint = new Uri(endpoint)
+			}
+		).AsChatClient(model);
+```
+
+**Ollama Client registration**
+```csharp 
+var innerClient = new OllamaChatClient(new Uri(endpoint), model);
+```
