test

dotnet/samples/GettingStarted/Workflows/Declarative/ToolApproval/Program.cs

@@ -0,0 +1,75 @@
+// Copyright (c) Microsoft. All rights reserved.
+
+using Azure.AI.Projects;
+using Azure.AI.Projects.OpenAI;
+using Azure.Identity;
+using Microsoft.Extensions.Configuration;
+using OpenAI.Responses;
+using Shared.Foundry;
+using Shared.Workflows;
+
+namespace Demo.Workflows.Declarative.ToolApproval;
+
+/// <summary>
+/// Demonstrate a workflow that responds to user input using an agent who
+/// has an MCP tool that requires approval.  Exits the loop when the user enters "exit".
+/// </summary>
+/// <remarks>
+/// See the README.md file in the parent folder (../README.md) for detailed
+/// information about the configuration required to run this sample.
+/// </remarks>
+internal sealed class Program
+{
+    public static async Task Main(string[] args)
+    {
+        // Initialize configuration
+        IConfiguration configuration = Application.InitializeConfig();
+        Uri foundryEndpoint = new(configuration.GetValue(Application.Settings.FoundryEndpoint));
+
+        // Ensure sample agents exist in Foundry.
+        await CreateAgentAsync(foundryEndpoint, configuration);
+
+        // Get input from command line or console
+        string workflowInput = Application.GetInput(args);
+
+        // Create the workflow factory.  This class demonstrates how to initialize a
+        // declarative workflow from a YAML file. Once the workflow is created, it
+        // can be executed just like any regular workflow.
+        WorkflowFactory workflowFactory = new("ToolApproval.yaml", foundryEndpoint);
+
+        // Execute the workflow:  The WorkflowRunner demonstrates how to execute
+        // a workflow, handle the workflow events, and providing external input.
+        // This also includes the ability to checkpoint workflow state and how to
+        // resume execution.
+        WorkflowRunner runner = new() { UseJsonCheckpoints = true };
+        await runner.ExecuteAsync(workflowFactory.CreateWorkflow, workflowInput);
+    }
+
+    private static async Task CreateAgentAsync(Uri foundryEndpoint, IConfiguration configuration)
+    {
+        AIProjectClient aiProjectClient = new(foundryEndpoint, new AzureCliCredential());
+
+        await aiProjectClient.CreateAgentAsync(
+            agentName: "DocumentSearchAgent",
+            agentDefinition: DefineSearchAgent(configuration),
+            agentDescription: "Searches documents on Microsoft Learn");
+    }
+
+    private static PromptAgentDefinition DefineSearchAgent(IConfiguration configuration) =>
+        new(configuration.GetValue(Application.Settings.FoundryModelMini))
+        {
+            Instructions =
+                """
+                Answer the users questions by searching the Microsoft Learn documentation.
+                For questions or input that do not require searching the documentation, inform the
+                user that you can only answer questions related to Microsoft Learn documentation.
+                """,
+            Tools =
+                {
+                    ResponseTool.CreateMcpTool(
+                        serverLabel: "microsoft_docs",
+                        serverUri: new Uri("https://learn.microsoft.com/api/mcp"),
+                        toolCallApprovalPolicy: new McpToolCallApprovalPolicy(GlobalMcpToolCallApprovalPolicy.AlwaysRequireApproval))
+                }
+        };
+}

dotnet/samples/GettingStarted/Workflows/Declarative/ToolApproval/ToolApproval.csproj

@@ -0,0 +1,38 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFrameworks>net10.0</TargetFrameworks>
+    <Nullable>enable</Nullable>
+    <ImplicitUsings>enable</ImplicitUsings>
+  </PropertyGroup>
+
+  <PropertyGroup>
+    <InjectIsExternalInitOnLegacy>true</InjectIsExternalInitOnLegacy>
+    <InjectSharedFoundryAgents>true</InjectSharedFoundryAgents>
+    <InjectSharedWorkflowsExecution>true</InjectSharedWorkflowsExecution>
+    <InjectSharedWorkflowsSettings>true</InjectSharedWorkflowsSettings>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.Extensions.Configuration" />
+    <PackageReference Include="Microsoft.Extensions.Configuration.Binder" />
+    <PackageReference Include="Microsoft.Extensions.Configuration.EnvironmentVariables" />
+    <PackageReference Include="Microsoft.Extensions.Configuration.Json" />
+    <PackageReference Include="Microsoft.Extensions.Configuration.UserSecrets" />
+    <PackageReference Include="Microsoft.Extensions.DependencyInjection" />
+    <PackageReference Include="Microsoft.Extensions.Logging" />
+  </ItemGroup>
+  
+  <ItemGroup>
+    <ProjectReference Include="..\..\..\..\..\src\Microsoft.Agents.AI.Workflows.Declarative\Microsoft.Agents.AI.Workflows.Declarative.csproj" />
+    <ProjectReference Include="..\..\..\..\..\src\Microsoft.Agents.AI.Workflows.Declarative.AzureAI\Microsoft.Agents.AI.Workflows.Declarative.AzureAI.csproj" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <None Include="ToolApproval.yaml">
+      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
+    </None>
+  </ItemGroup>
+
+</Project>

dotnet/samples/GettingStarted/Workflows/Declarative/ToolApproval/ToolApproval.yaml

@@ -0,0 +1,38 @@
+#
+# This workflow demonstrates an agent that requires tool approval
+# in a loop responding to user input.
+#
+# Example input: 
+# What is Microsoft Graph API used for?
+#
+kind: Workflow
+trigger:
+
+  kind: OnConversationStart
+  id: workflow_demo
+  actions:
+
+    - kind: InvokeAzureAgent
+      id: invoke_search
+      conversationId: =System.ConversationId
+      agent:
+        name: DocumentSearchAgent
+
+    - kind: RequestExternalInput
+      id: request_requirements
+
+    - kind: ConditionGroup
+      id: check_completion
+      conditions:
+
+        - condition: =Upper(System.LastMessage.Text) = "EXIT"
+          id: check_done
+          actions:
+
+            - kind: EndWorkflow
+              id: all_done
+
+      elseActions:
+        - kind: GotoAction
+          id: goto_search
+          actionId: invoke_search