.NET: Declarative Agents (#1301)

* AgentFactory abstractions and ChatClient implementation * Add a getitng started sample * Update to latest M.B.OM * Add some additional samples * Work in progress * Merge latest from main * Start to add support for using different kinds of connections * Remove IsSupported * Remove IsSupported * Refactor code to create clients to support DI * Add some unit tests * Update based on the latest code review feedback * Add support for OOB tools when using persistent agent sdk * Fix sample naming * Fix error based on latest MEAI * Update M.B.OM package to latest * Update to the latest M.B.OM release * Remove some obsolete helper methods * Update to the latest M.B.OM version * Fix broken unit test * Update MCP sample * Bump to latest M.B.OM release * Update to latest M.B.OM release * Update to latest M.B.OM release * Switch to using ExternalModel * Update to latest M.B.OM * Resolve merge conflicts * All tests pass * All tests pass * Start to clean up the code * Start to clean up the code * More clean up * More clean up * More clean up * Fix apiType checks * Run dotnet format * Fix typo * Address code review feedback * Add all properties for MCP tool * Address code review feedback * Address code review feedback * Fix merge * Undo warnings * Undo test change * More copilot feedback * Make class sealed * Address additional core review feedback --------- Co-authored-by: Mark Wallace <markwallace@microsoft.com>
2026-06-16 21:04:09 +08:00 · 2025-11-11 11:39:20 +00:00
parent 105dc82c39
commit aaa91954c5
75 changed files with 3980 additions and 3 deletions
@@ -0,0 +1,76 @@
+// Copyright (c) Microsoft. All rights reserved.
+
+using System;
+using System.ComponentModel;
+using System.IO;
+using System.Threading.Tasks;
+using Azure.AI.OpenAI;
+using Azure.Identity;
+using Microsoft.Extensions.AI;
+using Xunit.Abstractions;
+
+namespace Microsoft.Agents.AI.Declarative.IntegrationTests;
+
+/// <summary>
+/// Tests for declarative agents created using <see cref="ChatClientAgentFactory"/>.
+/// </summary>
+public sealed class ChatClientDeclarativeAgentTests(ITestOutputHelper output) : BaseIntegrationTest(output)
+{
+    [Fact]
+    public async Task CanCreateAndRunAssistantAgentAsync()
+    {
+        // Arrange
+        var chatClient = this.CreateIChatClient();
+        var agentFactory = new ChatClientAgentFactory(chatClient);
+        var agentYaml = File.ReadAllText("../../../../../../agent-samples/chatclient/Assistant.yaml");
+
+        // Act
+        var agent = await agentFactory.CreateFromYamlAsync(agentYaml);
+        var response = await agent!.RunAsync("Tell me a joke about a pirate in Italian.");
+        this.Output.WriteLine($"Agent Response: {response.Text}");
+
+        // Assert
+        Assert.NotNull(agent);
+        Assert.NotNull(response);
+        Assert.NotEmpty(response.Text);
+    }
+
+    [Fact]
+    public async Task CanCreateAndRunGetWeatherAgentAsync()
+    {
+        // Example function tool that can be used by the agent.
+        [Description("Get the weather for a given location.")]
+        static string GetWeather(
+            [Description("The city and state, e.g. San Francisco, CA")] string location,
+            [Description("The unit of temperature. Possible values are 'celsius' and 'fahrenheit'.")] string unit)
+            => $"The weather in {location} is cloudy with a high of {(unit.Equals("celsius", StringComparison.Ordinal) ? "15°C" : "59°F")}.";
+
+        // Arrange
+        var chatClient = this.CreateIChatClient();
+        var agentFactory = new ChatClientAgentFactory(chatClient, [AIFunctionFactory.Create(GetWeather, "GetWeather")]);
+        var agentYaml = File.ReadAllText("../../../../../../agent-samples/chatclient/GetWeather.yaml");
+
+        // Act
+        var agent = await agentFactory.CreateFromYamlAsync(agentYaml);
+        var response = await agent!.RunAsync("What is the weather in Cambridge, MA in °C?");
+        this.Output.WriteLine($"Agent Response: {response.Text}");
+
+        // Assert
+        Assert.NotNull(agent);
+        Assert.NotNull(response);
+        Assert.NotEmpty(response.Text);
+    }
+
+    private IChatClient CreateIChatClient()
+    {
+        var endpoint = this.FoundryConfiguration.Endpoint;
+        var deploymentName = this.FoundryConfiguration.DeploymentName;
+
+        // Create the chat client
+        return new AzureOpenAIClient(
+            new Uri(endpoint),
+            new AzureCliCredential())
+             .GetChatClient(deploymentName)
+             .AsIChatClient();
+    }
+}