自主集成

基础AI功能包括：工作表字段建议、工作表自定义字段、工作流代码块自动生成、应用多语言智能翻译

HAP 中基础AI功能默认基于 OpenAI https://api.openai.com/v1/chat/completions 实现，接口完整定义参考：https://platform.openai.com/docs/api-reference/chat/create

HAP 向 OpenAI 发送请求头参数：

Authorization: Bearer $API_KEY

HAP 向 OpenAI 发送的请求体仅含以下参数：

{
    "model": "gpt-4o-mini",                             // 模型名称
    "messages": [
        {
            "role": "developer",                        // 角色
            "content": "You are a helpful assistant."   // 内容
        }
    ],
    "temperature": 1,                                   // 控制生成文本的随机性。值越高，生成的文本越随机
    "top_p": 1,                                         // 核心概率阈值。控制生成文本的多样性      
    "frequency_penalty": 0,                             // 对重复出现的词进行惩罚，减少重复
    "presence_penalty": 0,                              // 对未出现过的词进行惩罚，增加新词出现的概率
    "stream": false                                     // 是否启用流式传输
}

HAP 接收 OpenAI 返回值仅使用到以下参数：

当 stream 为 false 时

{
    "choices": [
        {
            "message": {
                "content": "Full content"               // 全量内容
            }
        }
    ]
}

当 stream 为 true 时

{
    "choices": [
        {
            "delta": {
                "content": "Chunk content"              // 内容块
            }
        }
    ]
}

所以在自主集成模式下，需要开发者封装接口并满足以上的输入输出格式。可以理解为 HAP 产品中原本调用 OpenAI 接口，现改成调用自主实现的接口，接口的输入输出完全与 OpenAI 一致。如：基于百度AI自主集成的示例代码

接口开发完成并部署后，在 HAP 产品中 系统配置 > 集成 > AI服务 > 基础AI功能，类型选择自主集成，配置服务地址（baseURL）、模型名称和key，如下图：