mirror of
https://github.com/microsoft/agent-framework.git
synced 2026-06-16 21:04:09 +08:00
SergeyMenshykh
0fcbe7e105
* initial commit * address comments * address comments * address comments * address comments * rename executor to runner to align naming with python implementation * rename runner execute method to run method * remove poc leftovers and fix compilation issues * make script runner optional * remove unnecessary pragmas * make resources and scripts props virtual * address comments * update comment for name validation regex * address comments
49 lines
2.1 KiB
C#
49 lines
2.1 KiB
C#
// Copyright (c) Microsoft. All rights reserved.
|
|
|
|
// This sample demonstrates how to use file-based Agent Skills with a ChatClientAgent.
|
|
// Skills are discovered from SKILL.md files on disk and follow the progressive disclosure pattern:
|
|
// 1. Advertise — skill names and descriptions in the system prompt
|
|
// 2. Load — full instructions loaded on demand via load_skill tool
|
|
// 3. Read resources — reference files read via read_skill_resource tool
|
|
// 4. Run scripts — scripts executed via run_skill_script tool with a subprocess executor
|
|
//
|
|
// This sample uses a unit-converter skill that converts between miles, kilometers, pounds, and kilograms.
|
|
|
|
using Azure.AI.OpenAI;
|
|
using Azure.Identity;
|
|
using Microsoft.Agents.AI;
|
|
using OpenAI.Responses;
|
|
|
|
// --- Configuration ---
|
|
string endpoint = Environment.GetEnvironmentVariable("AZURE_OPENAI_ENDPOINT") ?? throw new InvalidOperationException("AZURE_OPENAI_ENDPOINT is not set.");
|
|
string deploymentName = Environment.GetEnvironmentVariable("AZURE_OPENAI_DEPLOYMENT_NAME") ?? "gpt-4o-mini";
|
|
|
|
// --- Skills Provider ---
|
|
// Discovers skills from the 'skills' directory containing SKILL.md files.
|
|
// The script runner runs file-based scripts (e.g. Python) as local subprocesses.
|
|
var skillsProvider = new AgentSkillsProvider(
|
|
Path.Combine(AppContext.BaseDirectory, "skills"),
|
|
SubprocessScriptRunner.RunAsync);
|
|
// --- Agent Setup ---
|
|
AIAgent agent = new AzureOpenAIClient(new Uri(endpoint), new DefaultAzureCredential())
|
|
.GetResponsesClient()
|
|
.AsAIAgent(new ChatClientAgentOptions
|
|
{
|
|
Name = "UnitConverterAgent",
|
|
ChatOptions = new()
|
|
{
|
|
Instructions = "You are a helpful assistant that can convert units.",
|
|
},
|
|
AIContextProviders = [skillsProvider],
|
|
},
|
|
model: deploymentName);
|
|
|
|
// --- Example: Unit conversion ---
|
|
Console.WriteLine("Converting units with file-based skills");
|
|
Console.WriteLine(new string('-', 60));
|
|
|
|
AgentResponse response = await agent.RunAsync(
|
|
"How many kilometers is a marathon (26.2 miles)? And how many pounds is 75 kilograms?");
|
|
|
|
Console.WriteLine($"Agent: {response.Text}");
|