深入解析dotnet/extensions中的AI工具调用功能实现

在dotnet/extensions项目的Microsoft.Extensions.AI.OpenAI组件中，工具调用(Tool Calling)是一个强大但需要正确配置的功能。本文将详细介绍如何正确实现AI工具调用功能，并分析常见问题的解决方案。

工具调用的基本概念

工具调用允许AI模型在执行过程中调用开发者预定义的函数或方法。这种机制极大地扩展了AI的能力边界，使其能够与外部系统交互或执行特定业务逻辑。

核心实现步骤

1. 创建Chat客户端：首先需要初始化一个IChatClient实例，这是与AI模型交互的基础。

2. 定义工具函数：使用AIFunctionFactory.Create方法将普通方法包装成AI可调用的工具函数。

3. 配置Chat选项：在ChatOptions中指定可用的工具列表。

4. 启用函数调用功能：这是关键但容易被忽略的一步，需要通过UseFunctionInvocation扩展方法显式启用。

常见问题分析

许多开发者会遇到工具函数不被调用的情况，这通常是由于缺少了函数调用功能的启用步骤。正确的做法是在获取IChatClient实例后，通过以下两种方式之一启用函数调用：

// 方式一：使用构建器模式
chatClient = chatClient
    .AsBuilder()
    .UseFunctionInvocation()
    .Build();

// 方式二：直接实例化
chatClient = new FunctionInvokingChatClient(chatClient);

完整示例代码

using System.ComponentModel;
using Microsoft.Extensions.AI;
using OpenAI;

// 初始化Chat客户端
IChatClient chatClient = new OpenAIClient(GetOpenAiKey())
    .GetChatClient("gpt-4o-mini")
    .AsIChatClient()
    .AsBuilder()
    .UseFunctionInvocation()
    .Build();

// 定义工具函数
[Description("获取天气信息")]
static string GetWeather() {
    Console.WriteLine("GetWeather工具被调用");
    return Random.Shared.NextDouble() > 0.5 ? "晴天" : "雨天";
}

// 配置Chat选项
var chatOptions = new ChatOptions
{
    Tools = [AIFunctionFactory.Create(GetWeather)]
};

// 发送消息并获取响应
await foreach (var message in chatClient.GetStreamingResponseAsync(
    [
        new ChatMessage(ChatRole.User, "作为AI助手，你必须为每个用户请求调用GetWeather工具"),
        new ChatMessage(ChatRole.User, "今天会下雨吗？")
    ],
    chatOptions))
{
    Console.WriteLine("消息: " + message);
}

最佳实践建议

1. 明确工具描述：使用Description特性为工具函数提供清晰的描述，这有助于AI模型理解何时应该调用该工具。

2. 错误处理：在工具函数中添加适当的错误处理逻辑，确保即使出现异常也能提供有意义的反馈。

3. 性能考虑：工具调用会增加响应时间，对于实时性要求高的场景需要权衡使用。

4. 版本兼容性：确保使用的Microsoft.Extensions.AI.OpenAI和OpenAI包版本兼容。

通过正确理解和配置这些组件，开发者可以充分利用AI工具调用的强大功能，构建更加智能和交互性强的应用程序。