为 AI 工程师配置大模型
在「AI 设置」里选择一个大模型服务商、填写你自己的 API Key、启用并测试连接,让 AI 工程师可以开始工作;也说明内网部署时如何接入自建的兼容接口,以及哪些数据会发送给模型服务。
视频教程 · 灵犀·Studio 从入门到精通 · 第 10 集 3:39
AI 工程师:一段需求生成整套画面
你将完成
读完本篇你将完成:
- 添加一个模型服务商并填好 API Key;
- 把它设为「使用中」,测试连接成功;
- 清楚使用 AI 工程师时哪些数据会发到模型服务。
开始之前
- 用具有系统管理权限的账号登录(例如
admin); - 已在模型服务商的官网开通服务并拿到 API Key;内网部署时,已有一个可访问的兼容接口地址。
模型服务是怎么接入的#
AI 工程师运行在你的灵犀·Studio 服务里,「思考」的部分交给你选定的大模型服务完成。用哪家、用哪个账号、花多少钱,都由你在 AI 设置 里决定。
操作步骤#
打开 AI 设置#
点击左侧菜单 系统管理 → AI 设置。页面顶部有三个页签:模型供应商、MCP 服务器、Skills 技能。第一次配置只需要 模型供应商。
页面上半部分是 已配置供应商,下半部分是可以添加的预置服务商。
- 1使用中
- 2测试连接
- 3点击服务商
选择服务商并填写 API Key#
在下方点击要使用的服务商卡片,例如 DeepSeek、智谱 GLM、通义千问 Qwen、Kimi (月之暗面) 等,弹出 添加供应商 对话框。预置服务商已经填好了 BaseURL 和推荐的模型名,你只需要:
- 点击对话框顶部的 获取 API Key ↗,到服务商官网创建密钥;
- 把密钥粘贴到 API Key;
- 核对 主模型 与 轻量模型,与你在服务商处开通的模型一致。
- 1获取密钥
- 2已预填
- 3粘贴 API Key
- 4保存
| 字段 | 说明 |
|---|---|
| 名称 | 显示在供应商列表里的名字 |
| BaseURL | 模型服务的接口地址,预置服务商已填好 |
| API Key | 你在服务商处创建的密钥 |
| 主模型 | 搭画面、写逻辑等主要工作使用的模型 |
| 轻量模型 | 简单任务使用的模型 |
| 币种、输入价、输出价 | 每百万 token 的价格,AI 助手面板据此折算本次会话的大致费用 |
| 支持视觉 (图片输入) | 模型能理解图片时勾选;不勾选时,会话里的图片不会传给模型,面板会提示你切换供应商 |
用自己的密钥,并设置用量上限
API Key 相当于付费账号的钥匙。只在 AI 设置 里填写,不要写进需求描述或截图里;建议在服务商控制台为这个密钥设置用量或金额上限。
保存并启用#
点击 保存。新供应商出现在 已配置供应商 中。如果卡片上没有 使用中 标记,点击卡片上的 启用。同一时间只有一个供应商处于使用中。
测试连接#
点击供应商卡片上的 测试。页面右上角提示 连接成功 并显示耗时,说明配置正确;提示 连接失败 时,按提示内容检查 API Key、BaseURL 和模型名。
预期结果
- 已配置供应商 中,你添加的供应商显示 使用中;
- 点击 测试 提示 连接成功;
- 打开任一组态画面的设计器,点击右上角的 AI 助手 按钮,面板底部显示当前使用的模型。
内网部署:接入自建的模型服务#
工厂网络不能访问外网时,可以接入在内网部署的模型服务:
- 在预置服务商列表的最后点击 自定义供应商;
- BaseURL 填写内网模型服务的地址,API Key 填写该服务要求的密钥;
- 保存、启用、测试,步骤与上文相同。
接口要求
AI 设置里的所有供应商都按 Anthropic 协议调用,自定义供应商也必须提供兼容该协议的接口。内网部署的模型服务需要支持这一协议,或在前面加一层协议转换。
断网环境下没有可用的模型服务时,AI 工程师不可用;采集、组态、告警等其它功能不受影响。
哪些数据会发给模型服务#
使用 AI 工程师时,会发送到你选定的模型服务的内容包括:
- 你在 AI 助手面板里输入的需求描述和上传的文件;
- 搭建过程中的画布截图;
- 完成任务所需的工程上下文,例如设备与点位名称、画面结构。
不使用 AI 工程师时,不会向模型服务发送数据。对数据外发有要求的工厂,建议使用内网部署的模型服务。
常见问题#
AI 助手面板显示「还未配置 AI 供应商」#
还没有处于 使用中 的供应商。点击面板里的 前往 AI 设置,按上文添加并启用一个供应商。
测试提示连接失败#
按提示内容逐项检查:API Key 是否复制完整、是否已过期;主模型 名称是否与服务商开通的一致(部分服务商需要填接入点或已开通的模型 ID);灵犀·Studio 所在的机器能否访问 BaseURL。
面板提示模型看不到图片#
当前供应商没有勾选 支持视觉 (图片输入)。确认模型本身支持图片输入后,编辑供应商勾选该项;模型不支持时,换一个支持图片输入的供应商。
下一步#
- 用 AI 生成组态画面 配置完成,开始第一场 AI 搭建。
- 需求描述与最佳实践 怎样描述需求,AI 更容易一次做对。
这篇文档对你有帮助吗?