mirror of
https://github.com/microsoft/agent-framework.git
synced 2026-06-16 21:04:09 +08:00
de791fb8a9
* Add 3 new hosted agent samples: AgentWithTools, AgentWithLocalTools, AgentThreadAndHITL - AgentWithTools: Foundry tools (MCP + code interpreter) via UseFoundryTools - AgentWithLocalTools: Local C# function tool (Seattle hotel search) with AIProjectClient - AgentThreadAndHITL: Human-in-the-loop with ApprovalRequiredAIFunction and thread persistence All samples follow agent-framework conventions (net10.0, AzureCliCredential, CPM disabled). AgentWithTools includes comprehensive README with setup guide and troubleshooting. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Add root HostedAgents README, replace test_requests.py with .http, update sample READMEs - Create root README.md with shared prerequisites, Azure AI Foundry setup, troubleshooting, and samples index - Replace test_requests.py with run-requests.http in AgentThreadAndHITL - Add pointer to root README in all 6 sample READMEs - Trim AgentWithTools README to concise style Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Fix dotnet format issues in AgentWithLocalTools/Program.cs - Add UTF-8 BOM (CHARSET) - Sort System.ClientModel.Primitives import alphabetically (IMPORTS) - Use target-typed new for AIProjectClient (IDE0090) - Add internal accessibility modifier to Hotel record (IDE0040) Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Address PR review: align model names and package versions - Change default model from gpt-4.1-mini to gpt-4o-mini in AgentWithLocalTools (Program.cs, agent.yaml, README.md) to match existing samples - Change README example from gpt-5.2 to gpt-4o-mini in AgentWithTools and root README - Align AgentWithLocalTools package versions with other samples: Azure.AI.AgentServer.AgentFramework beta.6 -> beta.8 Azure.AI.OpenAI 2.8.0-beta.1 -> 2.7.0-beta.2 Microsoft.Extensions.AI.OpenAI 10.2.0-preview -> 10.1.1-preview Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Upgrade new samples to latest package versions - Azure.AI.OpenAI: 2.7.0-beta.2 -> 2.8.0-beta.1 - Microsoft.Extensions.AI.OpenAI: 10.1.1-preview -> 10.3.0 Aligns with AgentWithHostedMCP which uses the latest versions. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Pin AgentThreadAndHITL to Microsoft.Extensions.AI.OpenAI 10.1.1 Azure.AI.AgentServer.AgentFramework beta.8 was compiled against Microsoft.Extensions.AI.Abstractions with the single-param FunctionApprovalRequestContent.CreateResponse(bool). Version 10.3.0 changed the signature to include an optional reason parameter, causing a binary incompatibility at runtime. Pin to 10.1.1 until the framework is recompiled against the newer abstractions. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
130 lines
5.2 KiB
C#
130 lines
5.2 KiB
C#
// Copyright (c) Microsoft. All rights reserved.
|
|
|
|
// Seattle Hotel Agent - A simple agent with a tool to find hotels in Seattle.
|
|
// Uses Microsoft Agent Framework with Azure AI Foundry.
|
|
// Ready for deployment to Foundry Hosted Agent service.
|
|
|
|
using System.ClientModel.Primitives;
|
|
using System.ComponentModel;
|
|
using System.Globalization;
|
|
using System.Text;
|
|
using Azure.AI.AgentServer.AgentFramework.Extensions;
|
|
using Azure.AI.OpenAI;
|
|
using Azure.AI.Projects;
|
|
using Azure.Identity;
|
|
using Microsoft.Agents.AI;
|
|
using Microsoft.Extensions.AI;
|
|
|
|
var endpoint = Environment.GetEnvironmentVariable("AZURE_AI_PROJECT_ENDPOINT")
|
|
?? throw new InvalidOperationException("AZURE_AI_PROJECT_ENDPOINT is not set.");
|
|
var deploymentName = Environment.GetEnvironmentVariable("MODEL_DEPLOYMENT_NAME") ?? "gpt-4o-mini";
|
|
Console.WriteLine($"Project Endpoint: {endpoint}");
|
|
Console.WriteLine($"Model Deployment: {deploymentName}");
|
|
|
|
var seattleHotels = new[]
|
|
{
|
|
new Hotel("Contoso Suites", 189, 4.5, "Downtown"),
|
|
new Hotel("Fabrikam Residences", 159, 4.2, "Pike Place Market"),
|
|
new Hotel("Alpine Ski House", 249, 4.7, "Seattle Center"),
|
|
new Hotel("Margie's Travel Lodge", 219, 4.4, "Waterfront"),
|
|
new Hotel("Northwind Inn", 139, 4.0, "Capitol Hill"),
|
|
new Hotel("Relecloud Hotel", 99, 3.8, "University District"),
|
|
};
|
|
|
|
[Description("Get available hotels in Seattle for the specified dates. This simulates a call to a hotel availability API.")]
|
|
string GetAvailableHotels(
|
|
[Description("Check-in date in YYYY-MM-DD format")] string checkInDate,
|
|
[Description("Check-out date in YYYY-MM-DD format")] string checkOutDate,
|
|
[Description("Maximum price per night in USD (optional, defaults to 500)")] int maxPrice = 500)
|
|
{
|
|
try
|
|
{
|
|
if (!DateTime.TryParseExact(checkInDate, "yyyy-MM-dd", CultureInfo.InvariantCulture, DateTimeStyles.None, out var checkIn))
|
|
{
|
|
return "Error parsing check-in date. Please use YYYY-MM-DD format.";
|
|
}
|
|
|
|
if (!DateTime.TryParseExact(checkOutDate, "yyyy-MM-dd", CultureInfo.InvariantCulture, DateTimeStyles.None, out var checkOut))
|
|
{
|
|
return "Error parsing check-out date. Please use YYYY-MM-DD format.";
|
|
}
|
|
|
|
if (checkOut <= checkIn)
|
|
{
|
|
return "Error: Check-out date must be after check-in date.";
|
|
}
|
|
|
|
var nights = (checkOut - checkIn).Days;
|
|
var availableHotels = seattleHotels.Where(h => h.PricePerNight <= maxPrice).ToList();
|
|
|
|
if (availableHotels.Count == 0)
|
|
{
|
|
return $"No hotels found in Seattle within your budget of ${maxPrice}/night.";
|
|
}
|
|
|
|
var result = new StringBuilder();
|
|
result.AppendLine($"Available hotels in Seattle from {checkInDate} to {checkOutDate} ({nights} nights):");
|
|
result.AppendLine();
|
|
|
|
foreach (var hotel in availableHotels)
|
|
{
|
|
var totalCost = hotel.PricePerNight * nights;
|
|
result.AppendLine($"**{hotel.Name}**");
|
|
result.AppendLine($" Location: {hotel.Location}");
|
|
result.AppendLine($" Rating: {hotel.Rating}/5");
|
|
result.AppendLine($" ${hotel.PricePerNight}/night (Total: ${totalCost})");
|
|
result.AppendLine();
|
|
}
|
|
|
|
return result.ToString();
|
|
}
|
|
catch (Exception ex)
|
|
{
|
|
return $"Error processing request. Details: {ex.Message}";
|
|
}
|
|
}
|
|
|
|
var credential = new AzureCliCredential();
|
|
AIProjectClient projectClient = new(new Uri(endpoint), credential);
|
|
|
|
ClientConnection connection = projectClient.GetConnection(typeof(AzureOpenAIClient).FullName!);
|
|
|
|
if (!connection.TryGetLocatorAsUri(out Uri? openAiEndpoint) || openAiEndpoint is null)
|
|
{
|
|
throw new InvalidOperationException("Failed to get OpenAI endpoint from project connection.");
|
|
}
|
|
openAiEndpoint = new Uri($"https://{openAiEndpoint.Host}");
|
|
Console.WriteLine($"OpenAI Endpoint: {openAiEndpoint}");
|
|
|
|
var chatClient = new AzureOpenAIClient(openAiEndpoint, credential)
|
|
.GetChatClient(deploymentName)
|
|
.AsIChatClient()
|
|
.AsBuilder()
|
|
.UseOpenTelemetry(sourceName: "Agents", configure: cfg => cfg.EnableSensitiveData = false)
|
|
.Build();
|
|
|
|
var agent = new ChatClientAgent(chatClient,
|
|
name: "SeattleHotelAgent",
|
|
instructions: """
|
|
You are a helpful travel assistant specializing in finding hotels in Seattle, Washington.
|
|
|
|
When a user asks about hotels in Seattle:
|
|
1. Ask for their check-in and check-out dates if not provided
|
|
2. Ask about their budget preferences if not mentioned
|
|
3. Use the GetAvailableHotels tool to find available options
|
|
4. Present the results in a friendly, informative way
|
|
5. Offer to help with additional questions about the hotels or Seattle
|
|
|
|
Be conversational and helpful. If users ask about things outside of Seattle hotels,
|
|
politely let them know you specialize in Seattle hotel recommendations.
|
|
""",
|
|
tools: [AIFunctionFactory.Create(GetAvailableHotels)])
|
|
.AsBuilder()
|
|
.UseOpenTelemetry(sourceName: "Agents", configure: cfg => cfg.EnableSensitiveData = false)
|
|
.Build();
|
|
|
|
Console.WriteLine("Seattle Hotel Agent Server running on http://localhost:8088");
|
|
await agent.RunAIAgentAsync(telemetrySourceName: "Agents");
|
|
|
|
internal sealed record Hotel(string Name, int PricePerNight, double Rating, string Location);
|