mirror of
https://github.com/microsoft/agent-framework.git
synced 2026-06-16 21:04:09 +08:00
c9cd067be6
* support script execution by code interpretor * improve the instruction prompt * Add DefaultAzureCredential production warning to AgentSkills samples Add the standard three-line WARNING comment about DefaultAzureCredential production considerations to both AgentSkills sample Program.cs files, matching the convention used in all other GettingStarted/Agents samples. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * address pr review comments * address feedback * rename Skill* types to FileAgentSkill* prefix for consistency - Rename SkillFrontmatter -> FileAgentSkillFrontmatter - Rename SkillScriptExecutor -> FileAgentSkillScriptExecutor - Add FileAgentSkillScriptExecutionContext and FileAgentSkillScriptExecutionDetails - Update sample, provider, loader, and tests accordingly Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * reorder usings * use set for props initialization instead of init * rename HostedCodeInterpreterSkillScriptExecutor --------- Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
53 lines
2.6 KiB
C#
53 lines
2.6 KiB
C#
// Copyright (c) Microsoft. All rights reserved.
|
|
|
|
// This sample demonstrates how to use Agent Skills with a ChatClientAgent.
|
|
// Agent Skills are modular packages of instructions and resources that extend an agent's capabilities.
|
|
// Skills follow the progressive disclosure pattern: advertise -> load -> read resources.
|
|
//
|
|
// This sample includes the expense-report skill:
|
|
// - Policy-based expense filing with references and assets
|
|
|
|
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 and makes them available to the agent
|
|
var skillsProvider = new FileAgentSkillsProvider(skillPath: Path.Combine(AppContext.BaseDirectory, "skills"));
|
|
|
|
// --- Agent Setup ---
|
|
// WARNING: DefaultAzureCredential is convenient for development but requires careful consideration in production.
|
|
// In production, consider using a specific credential (e.g., ManagedIdentityCredential) to avoid
|
|
// latency issues, unintended credential probing, and potential security risks from fallback mechanisms.
|
|
AIAgent agent = new AzureOpenAIClient(new Uri(endpoint), new DefaultAzureCredential())
|
|
.GetResponsesClient(deploymentName)
|
|
.AsAIAgent(new ChatClientAgentOptions
|
|
{
|
|
Name = "SkillsAgent",
|
|
ChatOptions = new()
|
|
{
|
|
Instructions = "You are a helpful assistant.",
|
|
},
|
|
AIContextProviders = [skillsProvider],
|
|
});
|
|
|
|
// --- Example 1: Expense policy question (loads FAQ resource) ---
|
|
Console.WriteLine("Example 1: Checking expense policy FAQ");
|
|
Console.WriteLine("---------------------------------------");
|
|
AgentResponse response1 = await agent.RunAsync("Are tips reimbursable? I left a 25% tip on a taxi ride and want to know if that's covered.");
|
|
Console.WriteLine($"Agent: {response1.Text}\n");
|
|
|
|
// --- Example 2: Filing an expense report (multi-turn with template asset) ---
|
|
Console.WriteLine("Example 2: Filing an expense report");
|
|
Console.WriteLine("---------------------------------------");
|
|
AgentSession session = await agent.CreateSessionAsync();
|
|
AgentResponse response2 = await agent.RunAsync("I had 3 client dinners and a $1,200 flight last week. Return a draft expense report and ask about any missing details.",
|
|
session);
|
|
Console.WriteLine($"Agent: {response2.Text}\n");
|