OA2023/OASystem/OASystem.Api/OAMethodLib/TokenHubAI/Models/ChatMessage.cs

namespace OASystem.API.OAMethodLib.TokenHubAI.Models;

/// <summary>
/// 聊天消息
/// </summary>
public class ChatMessage
{
    /// <summary>
    /// 角色类型
    /// </summary>
    /// <remarks>
    /// - system: 系统提示，设定 AI 角色
    /// - user: 用户消息
    /// - assistant: AI 助手回复
    /// - tool: 工具调用结果
    /// </remarks>
    public string Role { get; set; } = "user";

    /// <summary>
    /// 消息内容
    /// </summary>
    public string Content { get; set; } = string.Empty;

    /// <summary>
    /// 工具调用 ID（用于 tool 角色）
    /// </summary>
    public string? ToolCallId { get; set; }

    /// <summary>
    /// 工具调用列表（用于 assistant 角色）
    /// </summary>
    public List<ToolCall>? ToolCalls { get; set; }

    /// <summary>
    /// 创建用户消息
    /// </summary>
    public static ChatMessage User(string content) => new() { Role = "user", Content = content };

    /// <summary>
    /// 创建系统消息
    /// </summary>
    public static ChatMessage System(string content) => new() { Role = "system", Content = content };

    /// <summary>
    /// 创建助手消息
    /// </summary>
    public static ChatMessage Assistant(string content) => new() { Role = "assistant", Content = content };
}