如何开启 AI 功能
自 v7.0.0 版本起，启用平台 AI 功能的配置流程如下：
-
平台管理员进入 平台管理 > 使用设置 > 服务配置 > AI 能力 页面。
-
在该页面内，需要按顺序完成以下配置：
-
配置供应商： 设定底层的 AI 模型供应商。
-
配置模型： 在供应商基础上，添加或选择具体的开发商，配置 AI 模型。
-
功能关联： 在“功能配置”栏目中，为各项系统 AI 功能指定对应的调用模型。
模型
模型页面用于统一管理平台内可用的 AI 模型。
-
添加开发商。平台会默认添加一批预置开发商及模型（
OpenAI、通义千问、DeepSeek），管理员只需完成供应商配置即可使用（预置开发商不可重复添加）。
-
添加模型：在开发商下添加具体模型
- 名称：平台内模型的唯一标识，HAP 内部通过此标识进行模型匹配，区分大小写且不可重复。须谨慎修改，避免已经使用该模型的功能调用失败
- 显示名称：模型在前端 界面展示的名称
- 价格：针对平台版本，设置该模型的调用收费标准
- 能力：定义模型具备的技术特性，作为系统 AI 功能自动匹配模型的关键依据。
- 性能：模型的综合表现指标。建议从响应速度、输出效果、稳定性及成本等维度进行综合评价，系统将以此作为自动择优匹配的参考
- 供应商及模型ID：设置实际调用的供应商及模型 ID，支持配置多个供应商，但同一时间内仅允许启用其中一个。
-
支持设置隐藏开发商和模型。设置隐藏后，工作流AIGC相关节点的模型选择层将不显示（注意：平台管理的功能配置仍可选到）。
供应商
供应商在平台中扮演着 大模型接口提供者 的角色
管理供应商的请求接口地址与调用凭证（API key），供模型调用时使用。
-
当前支持添加
OpenAI、通义千问、DeepSeek、Azure官方供应商，也支持添加自定义供应商（注意自定义供应商需满足 OpenAI 的接口定义规范，请参阅 OpenAI 官方文档）
-
官方供应商的
Base URL非必填，均有默认地址，如存在网络问题配置过代理地址，则可通过设置Base URL的方式 -
支持开启代理。开启后，将使用平台管理的 使用设置-安全- API网络代理 配置的代理信息来转发请求
-
此外，还支持设置自定义请求头、开启SSL证书验证
功能配置
-
模型配置：设置系统AI功能调用的模型。点击【自动设置模型】，将根据模型参数及各系统AI功能的匹配规则一键匹配模型，也支持手动编辑调整模型。当所选模型不符合功能最低要求时，模型输入框下方也将有相应标识，未设置模型或所选模型不可用时，系统会调用可用列表中的第一个模型，确保功能的可用性。系统AI功能包括：
- 创建工作表
- 创建记录
- 生成代码（工作表自定义字段）
- 生成代码（工作流代码块节点）
- 生成提示词（工作流智能体节点）
- 生成示例数据
- 应用多语言翻译
- 自动选择其他模型的模型（即工作流 AI Agent 节点中的自动选择模型）
- 生成应用/工作表描述
- 其他辅助功能（指除上述功能外，其他使用到AI服务的功能，如生成对话标题、AI创建工作表的前置推荐（表名、图标等）、基于描述生成对话机器人相应配置等）
-
其他：支持配置语音转文字服务（mingo中使用）、联网搜索服务（AI创建记录中使用）
AI能力总开关
关闭后将隐藏所有AI相关功能入口。应用内已添加的AIGC节点、对话机器人等在调用模型时也将失败。
平台版定价设置
如果当前是平台版，可在 平台管理-运营-计费规则 设置面向租户的三方服务单价。
- 基础功能：短信服务、邮件服务、文本识别（OCR）、生成 PDF
- AI模型单价，按每千 tokens计算 a. 此单价为AI模型单价，而非针对AI模型调用的供应商， b. 注意，AI模型目前仅针对 工作流- AIGC 相关节点 的调用收费，系统AI功能暂不扣除使用组织信用点
历史配置兼容性
-
基础 AI 功能的默认继承
若您之前已在 AI服务-基础AI功能 配置了模型，则工作表自定义字段、工作流代码块自动生成、应用多语言智能翻译三个功能仍将默认使用原配置中的模型（如下图所示）
-
工作流 AIGC 节点的模型切换
针对已在配置文件中指定模型的 工作流 AIGC 节点，系统遵循以下逻辑：
-
默认状态： 系统将自动开启“使用配置文件”开关，以确保现有业务的连续性与稳定性。
-
切换方式： 若希望启用“新 AI 能力”模块中统一配置的模型，请手动关闭此开关。
- 当您选择关闭此开关以切换至新配置时，请务必确保： 已定义可用的 AI 模型且 “模型名称”（即平台内模型的唯一标识）与原配置文件中的 model 参数值保持完全一致（严格区分大小写）。
-