.NET+AI | MEAI | Function Calling 实操（3）

摘要：2）注册工具（Tool）using Microsoft.Extensions.AI;// 最小示例：无入参，返回字符串string GetCurrentWeather => Random.Shared.NextDouble > 0.5 ? "It's sunn

✅ 注册你的方法为工具（Tool）

✅ 启用中间件 UseFunctionInvocation ✅ 设置 ChatOptions.ToolMode = Auto

✅ 发起对话，MEAI 自动完成：请求 → 调用 → 回填 → 作答

ToolCollection/AITool：把你的方法包装成“可被调用的工具”

️ ChatOptions.ToolMode：控制模型是否/如何调用工具（None/Auto/Require）

FunctionCallContent / FunctionResultContent：调用意图与函数结果的消息载体

FunctionInvokingChatClient：自动完成调用循环的中间件

1）获取 ChatClient// 方式 A：课程辅助类（推荐）
var chatClient = AIClientHelper.GetDefaultChatClient;

// 方式 B：自行创建（示意）
// var chatClient = new OpenAIChatClient(apiKey: "...", model: "gpt-4o-...");
2）注册工具（Tool）using Microsoft.Extensions.AI;

// 最小示例：无入参，返回字符串
string GetCurrentWeather => Random.Shared.NextDouble > 0.5 ? "It's sunny" : "It's raining";
var tools = AIFunctionFactory.Create(GetCurrentWeather, name: "GetCurrentWeather", description: "查询当前天气");

稍复杂（带描述/类型）

using System.ComponentModel;

public record WeatherReport(string City, int TemperatureCelsius, bool WillRain);

public class TravelToolset
{
[Description("查询指定城市的实时天气")]
public WeatherReport QueryWeather(string city)
=> new(city, 25, willRain: false);
}

var travelTools = AIFunctionFactory.CreateFromMethods(new TravelToolset);
3）启用函数调用中间件var client = chatClient.AsBuilder
.UseFunctionInvocation // 关键：启用自动函数调用
.Build;
4）配置并对话var messages = new List
{
new(ChatRole.System, "你是出行助手，善于调用工具给出穿搭建议。"),
new(ChatRole.User, "帮我查看今天北京的天气，要不要带伞？")
};

var options = new ChatOptions
{
ToolMode = ChatToolMode.Auto,
Tools = [ tools ] // 或 travelTools
};

var response = await client.GetResponseAsync(messages, options);
Console.WriteLine(response.Text);
❝

依赖：Microsoft.Extensions.AI（以及选用的提供方实现，如 Microsoft.Extensions.AI.OpenAI 或 Azure.AI.OpenAI）

using System;
using System.Collections.Generic;
using Microsoft.Extensions.AI;

classProgram
{
staticasync System.Threading.Tasks.Task Main
{
// 1) 获取 ChatClient
var chatClient = AIClientHelper.GetDefaultChatClient;

// 2) 注册工具
string GetCurrentWeather => Random.Shared.NextDouble > 0.5 ? "It's sunny" : "It's raining";
var tools = AIFunctionFactory.Create(GetCurrentWeather, name: "GetCurrentWeather", description: "查询当前天气");

// 3) 启用函数调用
var client = chatClient.AsBuilder.UseFunctionInvocation.Build;

// 4) 配置与对话
var messages = new List
{
new(ChatRole.System, "你是出行助手，善于调用工具给出穿搭建议。"),
new(ChatRole.User, "帮我查看今天北京的天气，要不要带伞？")
};

var options = new ChatOptions { ToolMode = ChatToolMode.Auto, Tools = [ tools ] };
var result = await client.GetResponseAsync(messages, options);
Console.WriteLine(result.Text);
}
}