āĻāĻ āĻāĻĻāĻžāĻšāĻ°āĻŖāĻāĻŋ āĻĻā§āĻāĻžāĻ¯āĻŧ āĻā§āĻāĻžāĻŦā§ āĻŽāĻžāĻāĻā§āĻ°ā§āĻ¸āĻĢāĻ āĻāĻā§āĻ¨ā§āĻ āĻĢā§āĻ°ā§āĻŽāĻāĻ¯āĻŧāĻžāĻ°ā§āĻ āĻŦā§āĻ¯āĻŦāĻšāĻžāĻ° āĻāĻ°ā§ āĻāĻāĻāĻŋ āĻŦā§āĻĻā§āĻ§āĻŋāĻŽāĻžāĻ¨ āĻā§āĻ°āĻŽāĻŖ āĻĒāĻ°āĻŋāĻāĻ˛ā§āĻĒāĻ¨āĻž āĻāĻā§āĻ¨ā§āĻ āĻ¤ā§āĻ°āĻŋ āĻāĻ°āĻž āĻ¯āĻžāĻ¯āĻŧāĨ¤ āĻāĻā§āĻ¨ā§āĻāĻāĻŋ āĻ¸ā§āĻŦāĻ¯āĻŧāĻāĻā§āĻ°āĻŋāĻ¯āĻŧāĻāĻžāĻŦā§ āĻŦāĻŋāĻļā§āĻŦā§āĻ° āĻŦāĻŋāĻāĻŋāĻ¨ā§āĻ¨ āĻ¸ā§āĻĨāĻžāĻ¨ā§āĻ° āĻāĻ¨ā§āĻ¯ āĻŦā§āĻ¯āĻā§āĻ¤āĻŋāĻāĻ¤āĻā§āĻ¤ āĻĻāĻŋāĻ¨āĻāĻŋāĻ¤ā§āĻ¤āĻŋāĻ āĻā§āĻ°āĻŽāĻŖ āĻĒāĻ°āĻŋāĻāĻ˛ā§āĻĒāĻ¨āĻž āĻ¤ā§āĻ°āĻŋ āĻāĻ°āĻ¤ā§ āĻĒāĻžāĻ°ā§āĨ¤
GetRandomDestination() āĻĢāĻžāĻāĻļāĻ¨graph LR
A[User Request] --> B[AI Agent]
B --> C[GitHub Models API]
B --> D[GetRandomDestination Tool]
C --> E[Travel Itinerary]
D --> E
# zsh/bash
export GH_TOKEN=<your_github_token>
export GH_ENDPOINT=https://models.github.ai/inference
export GH_MODEL_ID=openai/gpt-5-mini
# PowerShell
$env:GH_TOKEN = "<your_github_token>"
$env:GH_ENDPOINT = "https://models.github.ai/inference"
$env:GH_MODEL_ID = "openai/gpt-5-mini"
āĻā§āĻĄ āĻāĻĻāĻžāĻšāĻ°āĻŖ āĻāĻžāĻ˛āĻžāĻ¨ā§āĻ° āĻāĻ¨ā§āĻ¯,
# 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@9.*
#:package Microsoft.Agents.AI.OpenAI@1.*-*
using System.ClientModel;
using System.ComponentModel;
using Microsoft.Agents.AI;
using Microsoft.Extensions.AI;
using OpenAI;
// 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];
}
// Extract configuration from environment variables
// Retrieve the GitHub Models API endpoint, defaults to https://models.github.ai/inference if not specified
// Retrieve the model ID, defaults to openai/gpt-5-mini if not specified
// Retrieve the GitHub token for authentication, throws exception if not specified
var github_endpoint = Environment.GetEnvironmentVariable("GH_ENDPOINT") ?? "https://models.github.ai/inference";
var github_model_id = Environment.GetEnvironmentVariable("GH_MODEL_ID") ?? "openai/gpt-5-mini";
var github_token = Environment.GetEnvironmentVariable("GH_TOKEN") ?? throw new InvalidOperationException("GH_TOKEN is not set.");
// Configure OpenAI Client Options
// Create configuration options to point to GitHub Models endpoint
// This redirects OpenAI client calls to GitHub's model inference service
var openAIOptions = new OpenAIClientOptions()
{
Endpoint = new Uri(github_endpoint)
};
// Initialize OpenAI Client with GitHub Models Configuration
// Create OpenAI client using GitHub token for authentication
// Configure it to use GitHub Models endpoint instead of OpenAI directly
var openAIClient = new OpenAIClient(new ApiKeyCredential(github_token), openAIOptions);
// Create AI Agent with Travel Planning Capabilities
// Initialize OpenAI client, get chat client for specified model, and create AI agent
// Configure agent with travel planning instructions and random destination tool
// The agent can now plan trips using the GetRandomDestination function
AIAgent agent = openAIClient
.GetChatClient(github_model_id)
.CreateAIAgent(
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 āĻŦā§āĻ¯āĻŦāĻšāĻžāĻ° āĻāĻ°ā§ āĻ
āĻ¨ā§āĻŦāĻžāĻĻ āĻāĻ°āĻž āĻšāĻ¯āĻŧā§āĻā§āĨ¤ āĻāĻŽāĻ°āĻž āĻ¯āĻĨāĻžāĻ¸āĻŽā§āĻāĻŦ āĻ¸āĻ āĻŋāĻ āĻ
āĻ¨ā§āĻŦāĻžāĻĻā§āĻ° āĻā§āĻˇā§āĻāĻž āĻāĻ°āĻŋ, āĻ¤āĻŦā§ āĻ
āĻ¨ā§āĻā§āĻ°āĻš āĻāĻ°ā§ āĻŽāĻ¨ā§ āĻ°āĻžāĻāĻŦā§āĻ¨ āĻ¯ā§ āĻ¸ā§āĻŦāĻ¯āĻŧāĻāĻā§āĻ°āĻŋāĻ¯āĻŧ āĻ
āĻ¨ā§āĻŦāĻžāĻĻā§ āĻ¤ā§āĻ°ā§āĻāĻŋ āĻŦāĻž āĻ
āĻ¸āĻā§āĻāĻ¤āĻŋ āĻĨāĻžāĻāĻ¤ā§ āĻĒāĻžāĻ°ā§āĨ¤ āĻ¨āĻĨāĻŋāĻāĻŋāĻ° āĻŽā§āĻ˛ āĻāĻžāĻˇāĻžāĻ¯āĻŧ āĻĨāĻžāĻāĻž āĻ¸āĻāĻ¸ā§āĻāĻ°āĻŖāĻāĻŋāĻā§ āĻĒā§āĻ°āĻžāĻŽāĻžāĻŖāĻŋāĻ āĻā§āĻ¸ āĻšāĻŋāĻ¸ā§āĻŦā§ āĻŦāĻŋāĻŦā§āĻāĻ¨āĻž āĻāĻ°āĻž āĻāĻāĻŋāĻ¤āĨ¤ āĻā§āĻ°ā§āĻ¤ā§āĻŦāĻĒā§āĻ°ā§āĻŖ āĻ¤āĻĨā§āĻ¯ā§āĻ° āĻāĻ¨ā§āĻ¯, āĻĒā§āĻļāĻžāĻĻāĻžāĻ° āĻŽāĻžāĻ¨āĻŦ āĻ
āĻ¨ā§āĻŦāĻžāĻĻ āĻ¸ā§āĻĒāĻžāĻ°āĻŋāĻļ āĻāĻ°āĻž āĻšāĻ¯āĻŧāĨ¤ āĻāĻ āĻ
āĻ¨ā§āĻŦāĻžāĻĻ āĻŦā§āĻ¯āĻŦāĻšāĻžāĻ°ā§āĻ° āĻĢāĻ˛ā§ āĻ¸ā§āĻˇā§āĻ āĻā§āĻ¨ā§ āĻā§āĻ˛ āĻŦā§āĻāĻžāĻŦā§āĻāĻŋ āĻŦāĻž āĻā§āĻ˛ āĻŦā§āĻ¯āĻžāĻā§āĻ¯āĻžāĻ° āĻāĻ¨ā§āĻ¯ āĻāĻŽāĻ°āĻž āĻĻāĻžāĻ¯āĻŧā§ āĻ¨āĻāĨ¤