using TencentCloud.Hunyuan.V20230901.Models;

namespace OASystem.API.OAMethodLib.HunYuanAPI
{
    /// <summary>
    /// 腾讯云混元大模型服务接口
    /// </summary>
    public interface IHunyuanService
    {
        /// <summary>
        /// 发送聊天补全请求 - 使用"hunyuan-t1-latest"模型（基础对话）
        /// </summary>
        /// <param name="question">问题</param>
        /// <returns>回答的具体信息</returns>
        Task<string> ChatCompletionsHunyuan_t1_latestAsync(string question);

        /// <summary>
        /// 发送聊天补全请求（基础对话）
        /// </summary>
        /// <param name="request">问题</param>
        /// <returns>SDK自带的响应实体</returns>
        Task<ChatCompletionsResponse> ChatCompletionsAsync(ChatCompletionsRequest request);

        /// <summary>
        /// 模拟“根据文件内容提问”的流程
        /// 注意：此方法假设您已通过其他方式（如上传、解析）获取了文件文本内容。
        /// 本方法仅负责将文件内容作为上下文与问题拼接后，调用大模型。
        /// </summary>
        /// <param name="fileContent">已读取的文件文本内容</param>
        /// <param name="question">针对文件内容提出的问题</param>
        /// <param name="model">模型名称，默认使用"hunyuan-lite"</param>
        /// <returns>大模型生成的回答</returns>
        Task<string> AskWithFileContextAsync(string fileContent, string question, string model = "hunyuan-lite");
    }
}