chore: import upstream snapshot with attribution

2026-07-13 13:21:23 +08:00
commit b957a53def
5423 changed files with 863745 additions and 0 deletions
@@ -0,0 +1,63 @@
+// Copyright (c) Microsoft. All rights reserved.
+using Azure.AI.Agents.Persistent;
+using Microsoft.SemanticKernel;
+using Microsoft.SemanticKernel.Agents.AzureAI;
+using Microsoft.SemanticKernel.ChatCompletion;
+using Resources;
+
+namespace GettingStarted.AzureAgents;
+
+/// <summary>
+/// This example demonstrates invoking Open API functions using <see cref="AzureAIAgent" />.
+/// </summary>
+/// <remarks>
+/// Note: Open API invocation does not involve kernel function calling or kernel filters.
+/// Azure Function invocation is managed entirely by the Azure AI Agent service.
+/// </remarks>
+public class Step06_AzureAIAgent_OpenAPI(ITestOutputHelper output) : BaseAzureAgentTest(output)
+{
+    [Fact]
+    public async Task UseOpenAPIToolWithAgent()
+    {
+        // Retrieve Open API specifications
+        string apiCountries = EmbeddedResource.Read("countries.json");
+        string apiWeather = EmbeddedResource.Read("weather.json");
+
+        // Define the agent
+        PersistentAgent definition = await this.Client.Administration.CreateAgentAsync(
+            TestConfiguration.AzureAI.ChatModelId,
+            tools:
+            [
+                new OpenApiToolDefinition("RestCountries", "Retrieve country information", BinaryData.FromString(apiCountries), new OpenApiAnonymousAuthDetails()),
+                new OpenApiToolDefinition("Weather", "Retrieve weather by location", BinaryData.FromString(apiWeather), new OpenApiAnonymousAuthDetails())
+            ]);
+        AzureAIAgent agent = new(definition, this.Client);
+
+        // Create a thread for the agent conversation.
+        Microsoft.SemanticKernel.Agents.AgentThread thread = new AzureAIAgentThread(this.Client, metadata: SampleMetadata);
+
+        // Respond to user input
+        try
+        {
+            await InvokeAgentAsync("What is the name and population of the country that uses currency with abbreviation THB");
+            await InvokeAgentAsync("What is the weather in the capitol city of that country?");
+        }
+        finally
+        {
+            await thread.DeleteAsync();
+            await this.Client.Administration.DeleteAgentAsync(agent.Id);
+        }
+
+        // Local function to invoke agent and display the conversation messages.
+        async Task InvokeAgentAsync(string input)
+        {
+            ChatMessageContent message = new(AuthorRole.User, input);
+            this.WriteAgentChatMessage(message);
+
+            await foreach (ChatMessageContent response in agent.InvokeAsync(message, thread))
+            {
+                this.WriteAgentChatMessage(response);
+            }
+        }
+    }
+}