test

dotnet/samples/A2AClientServer/A2AServer/A2AServer.csproj

@@ -0,0 +1,30 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFrameworks>net10.0</TargetFrameworks>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+    <UserSecretsId>5ee045b0-aea3-4f08-8d31-32d1a6f8fed0</UserSecretsId>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Azure.AI.Agents.Persistent" />
+    <PackageReference Include="Azure.Identity" />
+  </ItemGroup>
+
+  <ItemGroup Condition="!$([MSBuild]::IsTargetFrameworkCompatible($(TargetFramework), 'net10.0'))">
+    <PackageReference Include="Microsoft.Bcl.AsyncInterfaces" />
+    <PackageReference Include="System.Linq.AsyncEnumerable" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\..\..\src\Microsoft.Agents.AI.Hosting.A2A.AspNetCore\Microsoft.Agents.AI.Hosting.A2A.AspNetCore.csproj" />
+    <ProjectReference Include="..\..\..\src\Microsoft.Agents.AI.Hosting.A2A\Microsoft.Agents.AI.Hosting.A2A.csproj" />
+
+    <ProjectReference Include="..\..\..\src\Microsoft.Agents.AI.A2A\Microsoft.Agents.AI.A2A.csproj" />
+    <ProjectReference Include="..\..\..\src\Microsoft.Agents.AI.AzureAI.Persistent\Microsoft.Agents.AI.AzureAI.Persistent.csproj" />
+    <ProjectReference Include="..\..\..\src\Microsoft.Agents.AI.OpenAI\Microsoft.Agents.AI.OpenAI.csproj" />
+  </ItemGroup>
+
+</Project>

dotnet/samples/A2AClientServer/A2AServer/A2AServer.http

@@ -0,0 +1,85 @@
+### Each A2A agent is available at a different host address
+@hostInvoice = http://localhost:5000
+@hostPolicy = http://localhost:5001
+@hostLogistics = http://localhost:5002
+
+### Query agent card for the invoice agent
+GET {{hostInvoice}}/.well-known/agent-card.json
+
+### Send a message to the invoice agent
+POST {{hostInvoice}}
+Content-Type: application/json
+
+{
+    "id": "1",
+    "jsonrpc": "2.0",
+    "method": "message/send",
+    "params": {
+        "id": "12345",
+        "message": {
+            "kind": "message",
+            "role": "user",
+            "messageId": "msg_1",
+            "parts": [
+                {
+                    "kind": "text",
+                    "text": "Show me all invoices for Contoso?"
+                }
+            ]
+        }
+    }
+}
+
+### Query agent card for the policy agent
+GET {{hostPolicy}}/.well-known/agent-card.json
+
+### Send a message to the policy agent
+POST {{hostPolicy}}
+Content-Type: application/json
+
+{
+    "id": "1",
+    "jsonrpc": "2.0",
+    "method": "message/send",
+    "params": {
+        "id": "12345",
+        "message": {
+            "kind": "message",
+            "role": "user",
+            "messageId": "msg_1",
+            "parts": [
+                {
+                    "kind": "text",
+                    "text": "What is the policy for short shipments?"
+                }
+            ]
+        }
+    }
+}
+
+### Query agent card for the logistics agent
+GET {{hostLogistics}}/.well-known/agent-card.json
+
+### Send a message to the logistics agent
+POST {{hostLogistics}}
+Content-Type: application/json
+
+{
+    "id": "1",
+    "jsonrpc": "2.0",
+    "method": "message/send",
+    "params": {
+        "id": "12345",
+        "message": {
+            "kind": "message",
+            "role": "user",
+            "messageId": "msg_1",
+            "parts": [
+                {
+                    "kind": "text",
+                    "text": "What is the status for SHPMT-SAP-001?"
+                }
+            ]
+        }
+    }
+}

dotnet/samples/A2AClientServer/A2AServer/HostAgentFactory.cs

@@ -0,0 +1,148 @@
+// Copyright (c) Microsoft. All rights reserved.
+
+using A2A;
+using Azure.AI.Agents.Persistent;
+using Azure.Identity;
+using Microsoft.Agents.AI;
+using Microsoft.Extensions.AI;
+using OpenAI;
+using OpenAI.Chat;
+
+namespace A2AServer;
+
+internal static class HostAgentFactory
+{
+    internal static async Task<(AIAgent, AgentCard)> CreateFoundryHostAgentAsync(string agentType, string model, string endpoint, string assistantId, IList<AITool>? tools = null)
+    {
+        var persistentAgentsClient = new PersistentAgentsClient(endpoint, new AzureCliCredential());
+        PersistentAgent persistentAgent = await persistentAgentsClient.Administration.GetAgentAsync(assistantId);
+
+        AIAgent agent = await persistentAgentsClient
+            .GetAIAgentAsync(persistentAgent.Id, chatOptions: new() { Tools = tools });
+
+        AgentCard agentCard = agentType.ToUpperInvariant() switch
+        {
+            "INVOICE" => GetInvoiceAgentCard(),
+            "POLICY" => GetPolicyAgentCard(),
+            "LOGISTICS" => GetLogisticsAgentCard(),
+            _ => throw new ArgumentException($"Unsupported agent type: {agentType}"),
+        };
+
+        return new(agent, agentCard);
+    }
+
+    internal static async Task<(AIAgent, AgentCard)> CreateChatCompletionHostAgentAsync(string agentType, string model, string apiKey, string name, string instructions, IList<AITool>? tools = null)
+    {
+        AIAgent agent = new OpenAIClient(apiKey)
+             .GetChatClient(model)
+             .AsAIAgent(instructions, name, tools: tools);
+
+        AgentCard agentCard = agentType.ToUpperInvariant() switch
+        {
+            "INVOICE" => GetInvoiceAgentCard(),
+            "POLICY" => GetPolicyAgentCard(),
+            "LOGISTICS" => GetLogisticsAgentCard(),
+            _ => throw new ArgumentException($"Unsupported agent type: {agentType}"),
+        };
+
+        return new(agent, agentCard);
+    }
+
+    #region private
+    private static AgentCard GetInvoiceAgentCard()
+    {
+        var capabilities = new AgentCapabilities()
+        {
+            Streaming = false,
+            PushNotifications = false,
+        };
+
+        var invoiceQuery = new AgentSkill()
+        {
+            Id = "id_invoice_agent",
+            Name = "InvoiceQuery",
+            Description = "Handles requests relating to invoices.",
+            Tags = ["invoice", "semantic-kernel"],
+            Examples =
+            [
+                "List the latest invoices for Contoso.",
+            ],
+        };
+
+        return new()
+        {
+            Name = "InvoiceAgent",
+            Description = "Handles requests relating to invoices.",
+            Version = "1.0.0",
+            DefaultInputModes = ["text"],
+            DefaultOutputModes = ["text"],
+            Capabilities = capabilities,
+            Skills = [invoiceQuery],
+        };
+    }
+
+    private static AgentCard GetPolicyAgentCard()
+    {
+        var capabilities = new AgentCapabilities()
+        {
+            Streaming = false,
+            PushNotifications = false,
+        };
+
+        var policyQuery = new AgentSkill()
+        {
+            Id = "id_policy_agent",
+            Name = "PolicyAgent",
+            Description = "Handles requests relating to policies and customer communications.",
+            Tags = ["policy", "semantic-kernel"],
+            Examples =
+            [
+                "What is the policy for short shipments?",
+            ],
+        };
+
+        return new AgentCard()
+        {
+            Name = "PolicyAgent",
+            Description = "Handles requests relating to policies and customer communications.",
+            Version = "1.0.0",
+            DefaultInputModes = ["text"],
+            DefaultOutputModes = ["text"],
+            Capabilities = capabilities,
+            Skills = [policyQuery],
+        };
+    }
+
+    private static AgentCard GetLogisticsAgentCard()
+    {
+        var capabilities = new AgentCapabilities()
+        {
+            Streaming = false,
+            PushNotifications = false,
+        };
+
+        var logisticsQuery = new AgentSkill()
+        {
+            Id = "id_logistics_agent",
+            Name = "LogisticsQuery",
+            Description = "Handles requests relating to logistics.",
+            Tags = ["logistics", "semantic-kernel"],
+            Examples =
+            [
+                "What is the status for SHPMT-SAP-001",
+            ],
+        };
+
+        return new AgentCard()
+        {
+            Name = "LogisticsAgent",
+            Description = "Handles requests relating to logistics.",
+            Version = "1.0.0",
+            DefaultInputModes = ["text"],
+            DefaultOutputModes = ["text"],
+            Capabilities = capabilities,
+            Skills = [logisticsQuery],
+        };
+    }
+    #endregion
+}

dotnet/samples/A2AClientServer/A2AServer/Models/InvoiceQuery.cs

@@ -0,0 +1,167 @@
+// Copyright (c) Microsoft. All rights reserved.
+
+using System.ComponentModel;
+
+namespace A2A;
+
+/// <summary>
+/// A simple invoice plugin that returns mock data.
+/// </summary>
+public class Product
+{
+    public string Name { get; set; }
+    public int Quantity { get; set; }
+    public decimal Price { get; set; } // Price per unit  
+
+    public Product(string name, int quantity, decimal price)
+    {
+        this.Name = name;
+        this.Quantity = quantity;
+        this.Price = price;
+    }
+
+    public decimal TotalPrice() => this.Quantity * this.Price; // Total price for this product  
+}
+
+public class Invoice
+{
+    public string TransactionId { get; set; }
+    public string InvoiceId { get; set; }
+    public string CompanyName { get; set; }
+    public DateTime InvoiceDate { get; set; }
+    public List<Product> Products { get; set; } // List of products  
+
+    public Invoice(string transactionId, string invoiceId, string companyName, DateTime invoiceDate, List<Product> products)
+    {
+        this.TransactionId = transactionId;
+        this.InvoiceId = invoiceId;
+        this.CompanyName = companyName;
+        this.InvoiceDate = invoiceDate;
+        this.Products = products;
+    }
+
+    public decimal TotalInvoicePrice() => this.Products.Sum(product => product.TotalPrice()); // Total price of all products in the invoice  
+}
+
+public class InvoiceQuery
+{
+    private readonly List<Invoice> _invoices;
+
+    public InvoiceQuery()
+    {
+        // Extended mock data with quantities and prices  
+        this._invoices =
+        [
+            new("TICKET-XYZ987", "INV789", "Contoso", GetRandomDateWithinLastTwoMonths(),
+            [
+                new("T-Shirts", 150, 10.00m),
+                new("Hats", 200, 15.00m),
+                new("Glasses", 300, 5.00m)
+            ]),
+            new("TICKET-XYZ111", "INV111", "XStore", GetRandomDateWithinLastTwoMonths(),
+            [
+                new("T-Shirts", 2500, 12.00m),
+                new("Hats", 1500, 8.00m),
+                new("Glasses", 200, 20.00m)
+            ]),
+            new("TICKET-XYZ222", "INV222",  "Cymbal Direct", GetRandomDateWithinLastTwoMonths(),
+            [
+                new("T-Shirts", 1200, 14.00m),
+                new("Hats", 800, 7.00m),
+                new("Glasses", 500, 25.00m)
+            ]),
+            new("TICKET-XYZ333", "INV333", "Contoso", GetRandomDateWithinLastTwoMonths(),
+            [
+                new("T-Shirts", 400, 11.00m),
+                new("Hats", 600, 15.00m),
+                new("Glasses", 700, 5.00m)
+            ]),
+            new("TICKET-XYZ444", "INV444", "XStore", GetRandomDateWithinLastTwoMonths(),
+            [
+                new("T-Shirts", 800, 10.00m),
+                new("Hats", 500, 18.00m),
+                new("Glasses", 300, 22.00m)
+            ]),
+            new("TICKET-XYZ555", "INV555", "Cymbal Direct", GetRandomDateWithinLastTwoMonths(),
+            [
+                new("T-Shirts", 1100, 9.00m),
+                new("Hats", 900, 12.00m),
+                new("Glasses", 1200, 15.00m)
+            ]),
+            new("TICKET-XYZ666", "INV666", "Contoso", GetRandomDateWithinLastTwoMonths(),
+            [
+                new("T-Shirts", 2500, 8.00m),
+                new("Hats", 1200, 10.00m),
+                new("Glasses", 1000, 6.00m)
+            ]),
+            new("TICKET-XYZ777", "INV777", "XStore", GetRandomDateWithinLastTwoMonths(),
+            [
+                new("T-Shirts", 1900, 13.00m),
+                new("Hats", 1300, 16.00m),
+                new("Glasses", 800, 19.00m)
+            ]),
+            new("TICKET-XYZ888", "INV888", "Cymbal Direct", GetRandomDateWithinLastTwoMonths(),
+            [
+                new("T-Shirts", 2200, 11.00m),
+                new("Hats", 1700, 8.50m),
+                new("Glasses", 600, 21.00m)
+            ]),
+            new("TICKET-XYZ999", "INV999", "Contoso", GetRandomDateWithinLastTwoMonths(),
+            [
+                new("T-Shirts", 1400, 10.50m),
+                new("Hats", 1100, 9.00m),
+                new("Glasses", 950, 12.00m)
+            ])
+        ];
+    }
+
+    public static DateTime GetRandomDateWithinLastTwoMonths()
+    {
+        // Get the current date and time  
+        DateTime endDate = DateTime.UtcNow;
+
+        // Calculate the start date, which is two months before the current date  
+        DateTime startDate = endDate.AddMonths(-2);
+
+        // Generate a random number of days between 0 and the total number of days in the range  
+        int totalDays = (endDate - startDate).Days;
+        int randomDays = Random.Shared.Next(0, totalDays + 1); // +1 to include the end date  
+
+        // Return the random date  
+        return startDate.AddDays(randomDays);
+    }
+
+    [Description("Retrieves invoices for the specified company and optionally within the specified time range")]
+    public IEnumerable<Invoice> QueryInvoices(string companyName, DateTime? startDate = null, DateTime? endDate = null)
+    {
+        var query = this._invoices.Where(i => i.CompanyName.Equals(companyName, StringComparison.OrdinalIgnoreCase));
+
+        if (startDate.HasValue)
+        {
+            query = query.Where(i => i.InvoiceDate >= startDate.Value);
+        }
+
+        if (endDate.HasValue)
+        {
+            query = query.Where(i => i.InvoiceDate <= endDate.Value);
+        }
+
+        return query.ToList();
+    }
+
+    [Description("Retrieves invoice using the transaction id")]
+    public IEnumerable<Invoice> QueryByTransactionId(string transactionId)
+    {
+        var query = this._invoices.Where(i => i.TransactionId.Equals(transactionId, StringComparison.OrdinalIgnoreCase));
+
+        return query.ToList();
+    }
+
+    [Description("Retrieves invoice using the invoice id")]
+    public IEnumerable<Invoice> QueryByInvoiceId(string invoiceId)
+    {
+        var query = this._invoices.Where(i => i.InvoiceId.Equals(invoiceId, StringComparison.OrdinalIgnoreCase));
+
+        return query.ToList();
+    }
+}

dotnet/samples/A2AClientServer/A2AServer/Program.cs

@@ -0,0 +1,113 @@
+// Copyright (c) Microsoft. All rights reserved.
+using A2A;
+using A2A.AspNetCore;
+using A2AServer;
+using Microsoft.Agents.AI;
+using Microsoft.AspNetCore.Builder;
+using Microsoft.Extensions.AI;
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.DependencyInjection;
+
+string agentId = string.Empty;
+string agentType = string.Empty;
+
+for (var i = 0; i < args.Length; i++)
+{
+    if (args[i].StartsWith("--agentId", StringComparison.InvariantCultureIgnoreCase) && i + 1 < args.Length)
+    {
+        agentId = args[++i];
+    }
+    else if (args[i].StartsWith("--agentType", StringComparison.InvariantCultureIgnoreCase) && i + 1 < args.Length)
+    {
+        agentType = args[++i];
+    }
+}
+
+var builder = WebApplication.CreateBuilder(args);
+builder.Services.AddHttpClient().AddLogging();
+var app = builder.Build();
+
+var httpClient = app.Services.GetRequiredService<IHttpClientFactory>().CreateClient();
+var logger = app.Logger;
+
+IConfigurationRoot configuration = new ConfigurationBuilder()
+    .AddEnvironmentVariables()
+    .AddUserSecrets<Program>()
+    .Build();
+
+string? apiKey = configuration["OPENAI_API_KEY"];
+string model = configuration["OPENAI_MODEL"] ?? "gpt-4o-mini";
+string? endpoint = configuration["AZURE_FOUNDRY_PROJECT_ENDPOINT"];
+
+var invoiceQueryPlugin = new InvoiceQuery();
+IList<AITool> tools =
+    [
+    AIFunctionFactory.Create(invoiceQueryPlugin.QueryInvoices),
+    AIFunctionFactory.Create(invoiceQueryPlugin.QueryByTransactionId),
+    AIFunctionFactory.Create(invoiceQueryPlugin.QueryByInvoiceId)
+    ];
+
+AIAgent hostA2AAgent;
+AgentCard hostA2AAgentCard;
+
+if (!string.IsNullOrEmpty(endpoint) && !string.IsNullOrEmpty(agentId))
+{
+    (hostA2AAgent, hostA2AAgentCard) = agentType.ToUpperInvariant() switch
+    {
+        "INVOICE" => await HostAgentFactory.CreateFoundryHostAgentAsync(agentType, model, endpoint, agentId, tools),
+        "POLICY" => await HostAgentFactory.CreateFoundryHostAgentAsync(agentType, model, endpoint, agentId),
+        "LOGISTICS" => await HostAgentFactory.CreateFoundryHostAgentAsync(agentType, model, endpoint, agentId),
+        _ => throw new ArgumentException($"Unsupported agent type: {agentType}"),
+    };
+}
+else if (!string.IsNullOrEmpty(apiKey))
+{
+    (hostA2AAgent, hostA2AAgentCard) = agentType.ToUpperInvariant() switch
+    {
+        "INVOICE" => await HostAgentFactory.CreateChatCompletionHostAgentAsync(
+            agentType, model, apiKey, "InvoiceAgent",
+            """
+            You specialize in handling queries related to invoices.
+            """, tools),
+        "POLICY" => await HostAgentFactory.CreateChatCompletionHostAgentAsync(
+            agentType, model, apiKey, "PolicyAgent",
+            """
+            You specialize in handling queries related to policies and customer communications.
+            
+            Always reply with exactly this text:
+            
+            Policy: Short Shipment Dispute Handling Policy V2.1
+            
+            Summary: "For short shipments reported by customers, first verify internal shipment records
+            (SAP) and physical logistics scan data (BigQuery). If discrepancy is confirmed and logistics data
+            shows fewer items packed than invoiced, issue a credit for the missing items. Document the
+            resolution in SAP CRM and notify the customer via email within 2 business days, referencing the
+            original invoice and the credit memo number. Use the 'Formal Credit Notification' email
+            template."
+            """),
+        "LOGISTICS" => await HostAgentFactory.CreateChatCompletionHostAgentAsync(
+            agentType, model, apiKey, "LogisticsAgent",
+            """
+            You specialize in handling queries related to logistics.
+            
+            Always reply with exactly:
+            
+            Shipment number: SHPMT-SAP-001
+            Item: TSHIRT-RED-L
+            Quantity: 900
+            """),
+        _ => throw new ArgumentException($"Unsupported agent type: {agentType}"),
+    };
+}
+else
+{
+    throw new ArgumentException("Either A2AServer:ApiKey or A2AServer:ConnectionString & agentId must be provided");
+}
+
+var a2aTaskManager = app.MapA2A(
+    hostA2AAgent,
+    path: "/",
+    agentCard: hostA2AAgentCard,
+    taskManager => app.MapWellKnownAgentCard(taskManager, "/"));
+
+await app.RunAsync();