<PackageReference Include="Microsoft.Agents.AI.OpenAI" Version="1.1.0" />

internal sealed class UnitConverterSkill : AgentClassSkill<UnitConverterSkill>
{
    public override AgentSkillFrontmatter Frontmatter { get; } = new(
        "unit-converter",
        "Convert between common units using multiplication factors.");
    
    protected override string Instructions => """
        当用户询问距离或重量换算时：
        1. 先读取 conversion-table 资源，找到对应换算系数。
        2. 再调用 convert 脚本执行计算，参数为用户输入的数值value和换算系数factor。
        3. 回复内容需要清晰地展示换算系数、换算过程和换算结果，并同时标明换算前后的两个单位。
        """;
    
    protected override JsonSerializerOptions? SerializerOptions => null;
    
    [AgentSkillResource("conversion-table")]
    [Description("常见距离与重量换算系数表。")]
    public string ConversionTable => """
        # Conversion Table
        Formula: result = value × factor
        | From       | To         | Factor   |
        |------------|------------|----------|
        | miles      | kilometers | 1.60934  |
        | kilometers | miles      | 0.621371 |
        | pounds     | kilograms  | 0.453592 |
        | kilograms  | pounds     | 2.20462  |
        """;

    [AgentSkillScript("convert")]
    [Description("按 value × factor 执行换算，并返回 JSON。")]
    public static string ConvertUnits(double value, double factor)
    {
        double result = Math.Round(value * factor, 4);
        return JsonSerializer.Serialize(new { value, factor, result });
    }
}

internal class ToolExecutionLoggingMiddleware
{
    /// <summary>
    /// 简化版函数调用中间件 - 记录 Tool 执行日志
    /// </summary>
    public static async ValueTask<object?> ExecuteAsync(
        AIAgent agent,
        FunctionInvocationContext context,
        Func<FunctionInvocationContext, CancellationToken, ValueTask<object?>> next,
        CancellationToken cancellationToken)
    {
        Console.WriteLine($"\n→ 🍴Tool: {context.Function.Name}");
        var result = await next(context, cancellationToken);
        Console.WriteLine($"← 🥣Result: {result}");
        return result;
    }
}

var skillsProvider = new AgentSkillsProvider(new UnitConverterSkill());
AIAgent agent = chatClient.AsAIAgent(new ChatClientAgentOptions
{
    Name = "UnitConverterAgent",
    ChatOptions = new()
    {
        Instructions = "你是一个专业的AI助手，负责帮助用户实现单位的转换，使用用户提问的语言进行回复。",
    },
    AIContextProviders = [skillsProvider],
});
// 💡 使用 Agent Builder 注册函数调用中间件
agent = agent
    .AsBuilder()
    .Use(ToolExecutionLoggingMiddleware.ExecuteAsync) // 使用工具执行日志中间件，记录工具调用的日志
    .Build();
Console.WriteLine("✅ 基于强类型Skills 的 AI Agent 创建成功");
Console.WriteLine();

var session = await agent.CreateSessionAsync();
Console.WriteLine("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
Console.WriteLine($"开始测试：基于 Class-Based Skills");
// 中文问题：英里 -> 公里
var question1 = "马拉松比赛的距离26.2 英里是多少公里？";
Console.WriteLine($"👤 用户: {question1}");
Console.WriteLine();
var response1 = await agent.RunAsync(question1, session);
Console.WriteLine("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
Console.WriteLine($"🤖 Agent: {response1.Text}");
Console.WriteLine("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
Console.WriteLine();
// 英文问题：磅 -> 千克
var question2 = "How many pounds is 75 kilograms?";
Console.WriteLine($"👤 用户: {question2}");
Console.WriteLine();
var response2 = await agent.RunAsync(question2, session);
Console.WriteLine("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
Console.WriteLine($"🤖 Agent: {response2.Text}");
Console.WriteLine("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
Console.WriteLine();

作者：爱迪生

出处：https://edisontalk.cnblogs.com

本文版权归作者和博客园共有，欢迎转载，但未经作者同意必须保留此段声明，且在文章页面明显位置给出原文链接。