āļāļąāļ§āļāļĒāđāļēāļāļāļĩāđāđāļŠāļāļāļ§āļīāļāļĩāļŠāļĢāđāļēāļāļāļąāļ§āđāļāļāļ§āļēāļāđāļāļāļāđāļāļāđāļāļĩāđāļĒāļ§āļāļąāļāļāļĢāļīāļĒāļ°āđāļāļĒāđāļāđ Microsoft Agent Framework āļŠāļģāļŦāļĢāļąāļ .NET āļāļąāļ§āđāļāļāļŠāļēāļĄāļēāļĢāļāļŠāļĢāđāļēāļāđāļāļāļāļēāļĢāđāļāļīāļāļāļēāļāđāļāļāļ§āļąāļāđāļāļĩāļĒāļ§āļāļĩāđāļāļĢāļąāļāđāļŦāđāđāļŦāļĄāļēāļ°āļŠāļĄāļāļąāļāļāļļāļāļāļĨāļŠāļģāļŦāļĢāļąāļāļāļļāļāļŦāļĄāļēāļĒāļāļĨāļēāļĒāļāļēāļāļŠāļļāđāļĄāļāļąāđāļ§āđāļĨāļāđāļāļĒāļāļąāļāđāļāļĄāļąāļāļī
AzureCliCredential (az login)GetRandomDestination() āļŠāļģāļŦāļĢāļąāļāļāļąāļ§āđāļāļāđāļāđāļāļēāļgraph LR
A[āļāļģāļāļāļāļāļāļāļđāđāđāļāđ] --> B[āļāļąāļ§āđāļāļ AI]
B --> C[Azure OpenAI (API āļāļēāļĢāļāļāļāļāļĨāļąāļ)]
B --> D[āđāļāļĢāļ·āđāļāļāļĄāļ·āļāđāļĨāļ·āļāļāļāļļāļāļŦāļĄāļēāļĒāļāļĨāļēāļĒāļāļēāļāđāļāļāļŠāļļāđāļĄ]
C --> E[āļāļģāļŦāļāļāļāļēāļĢāļāđāļāļāđāļāļĩāđāļĒāļ§]
D --> E
az login# zsh/bash
export AZURE_OPENAI_ENDPOINT=https://<your-resource>.openai.azure.com
export AZURE_OPENAI_DEPLOYMENT=gpt-5-mini
# āļāļēāļāļāļąāđāļāļĨāļāļāļ·āđāļāđāļāđāļēāđāļāđāđāļāļ·āđāļāđāļŦāđ AzureCliCredential āļĢāļąāļāđāļāđāļāđāļāđāļāđ
az login
# PowerShell
$env:AZURE_OPENAI_ENDPOINT = "https://<your-resource>.openai.azure.com"
$env:AZURE_OPENAI_DEPLOYMENT = "gpt-5-mini"
# āļāļēāļāļāļąāđāļāđāļāđāļēāļŠāļđāđāļĢāļ°āļāļāđāļāļ·āđāļāđāļŦāđ AzureCliCredential āļŠāļēāļĄāļēāļĢāļāļĢāļąāļāđāļāđāļāđāļāđāļāđ
az login
āđāļāļ·āđāļāļĢāļąāļāļāļąāļ§āļāļĒāđāļēāļāđāļāđāļ,
# zsh/bash
chmod +x ./01-dotnet-agent-framework.cs
./01-dotnet-agent-framework.cs
āļŦāļĢāļ·āļāđāļāđ dotnet CLI:
dotnet run ./01-dotnet-agent-framework.cs
āļāļđ 01-dotnet-agent-framework.cs āļŠāļģāļŦāļĢāļąāļāđāļāđāļāļāļĢāļāļāđāļ§āļ
#!/usr/bin/dotnet run
#:package Microsoft.Extensions.AI@10.4.1
#:package Microsoft.Agents.AI.OpenAI@1.1.0
#:package Azure.AI.OpenAI@2.1.0
#:package Azure.Identity@1.13.1
using System.ComponentModel;
using Microsoft.Agents.AI;
using Microsoft.Extensions.AI;
using Azure.AI.OpenAI;
using Azure.Identity;
// Tool Function: Random Destination Generator
// This static method will be available to the agent as a callable tool
// The [Description] attribute helps the AI understand when to use this function
// This demonstrates how to create custom tools for AI agents
[Description("Provides a random vacation destination.")]
static string GetRandomDestination()
{
// List of popular vacation destinations around the world
// The agent will randomly select from these options
var destinations = new List<string>
{
"Paris, France",
"Tokyo, Japan",
"New York City, USA",
"Sydney, Australia",
"Rome, Italy",
"Barcelona, Spain",
"Cape Town, South Africa",
"Rio de Janeiro, Brazil",
"Bangkok, Thailand",
"Vancouver, Canada"
};
// Generate random index and return selected destination
// Uses System.Random for simple random selection
var random = new Random();
int index = random.Next(destinations.Count);
return destinations[index];
}
// Azure OpenAI with the Responses API (stable v1 endpoint). Sign in with `az login`.
var azureEndpoint = Environment.GetEnvironmentVariable("AZURE_OPENAI_ENDPOINT")
?? throw new InvalidOperationException("AZURE_OPENAI_ENDPOINT is not set.");
var deployment = Environment.GetEnvironmentVariable("AZURE_OPENAI_DEPLOYMENT") ?? "gpt-5-mini";
var azureClient = new AzureOpenAIClient(new Uri(azureEndpoint), new AzureCliCredential());
// Create AI Agent with Travel Planning Capabilities
// Get the Responses client for the specified deployment and create the AI agent
// Configure agent with travel planning instructions and random destination tool
// The agent can now plan trips using the GetRandomDestination function
AIAgent agent = azureClient
.GetChatClient(deployment)
.AsAIAgent(
instructions: "You are a helpful AI Agent that can help plan vacations for customers at random destinations",
tools: [AIFunctionFactory.Create(GetRandomDestination)]
);
// Execute Agent: Plan a Day Trip
// Run the agent with streaming enabled for real-time response display
// Shows the agent's thinking and response as it generates the content
// Provides better user experience with immediate feedback
await foreach (var update in agent.RunStreamingAsync("Plan me a day trip"))
{
await Task.Delay(10);
Console.Write(update);
}
[Description] āļāļ°āļāļĨāļēāļĒāđāļāđāļāđāļāļĢāļ·āđāļāļāļĄāļ·āļāļāļĩāđāļāļąāļ§āđāļāļāđāļāđāđāļāđāļāļāļīāđāļŠāļāļāļ§āļēāļĄāļĢāļąāļāļāļīāļāļāļāļ: āđāļāļāļŠāļēāļĢāļāļĩāđāđāļāđāļĢāļąāļāļāļēāļĢāđāļāļĨāđāļāļĒāđāļāđāļāļĢāļīāļāļēāļĢāđāļāļĨāļ āļēāļĐāļē AI Co-op Translator āļāļāļ°āļāļĩāđāđāļĢāļēāļāļĒāļēāļĒāļēāļĄāđāļŦāđāļāļ§āļēāļĄāļāļđāļāļāđāļāļ āđāļāļĢāļāļāļĢāļēāļāļ§āđāļēāļāļēāļĢāđāļāļĨāđāļāļĒāļāļąāļāđāļāļĄāļąāļāļīāļāļēāļāļĄāļĩāļāđāļāļāļīāļāļāļĨāļēāļāļŦāļĢāļ·āļāļāļ§āļēāļĄāđāļĄāđāļāļđāļāļāđāļāļ āđāļāļāļŠāļēāļĢāļāđāļāļāļāļąāļāđāļāļ āļēāļĐāļēāļāđāļāļāļēāļāļāļ§āļĢāļāļđāļāļāļīāļāļēāļĢāļāļēāđāļāđāļāđāļŦāļĨāđāļāļāđāļāļĄāļđāļĨāļāļĩāđāđāļāļ·āđāļāļāļ·āļāđāļāđ āļŠāļģāļŦāļĢāļąāļāļāđāļāļĄāļđāļĨāļāļĩāđāļŠāļģāļāļąāļ āđāļāļ°āļāļģāđāļŦāđāđāļāđāļāļēāļĢāđāļāļĨāđāļāļĒāļĄāļāļļāļĐāļĒāđāļĄāļ·āļāļāļēāļāļĩāļ āđāļĢāļēāđāļĄāđāļĢāļąāļāļāļīāļāļāļāļāļāđāļāļāļ§āļēāļĄāđāļāđāļēāđāļāļāļīāļāļŦāļĢāļ·āļāļāļēāļĢāļāļĩāļāļ§āļēāļĄāļāļĩāđāļāļīāļāļāļĨāļēāļāļāļĩāđāđāļāļīāļāļāļķāđāļāļāļēāļāļāļēāļĢāđāļāđāļāļēāļĢāđāļāļĨāļāļĩāđ