为 AI 工程师配置大模型

在「AI 设置」里选择一个大模型服务商、填写你自己的 API Key、启用并测试连接,让 AI 工程师可以开始工作;也说明内网部署时如何接入自建的兼容接口,以及哪些数据会发送给模型服务。

  • 入门
  • 动手约 10 分钟
  • 阅读 3 分钟
  • 更新于 2026-11-08

视频教程 · 灵犀·Studio 从入门到精通 · 第 10 集 3:39

AI 工程师:一段需求生成整套画面

你将完成

读完本篇你将完成:

  • 添加一个模型服务商并填好 API Key;
  • 把它设为「使用中」,测试连接成功;
  • 清楚使用 AI 工程师时哪些数据会发到模型服务。

开始之前

  • 用具有系统管理权限的账号登录(例如 admin);
  • 已在模型服务商的官网开通服务并拿到 API Key;内网部署时,已有一个可访问的兼容接口地址。

模型服务是怎么接入的#

AI 工程师运行在你的灵犀·Studio 服务里,「思考」的部分交给你选定的大模型服务完成。用哪家、用哪个账号、花多少钱,都由你在 AI 设置 里决定。

AI 工程师与模型服务AI 工程师运行在你的灵犀·Studio 服务里。使用时,它把需求描述、画布截图和工程上下文发送给你在 AI 设置里配置的模型服务;模型服务可以是国内服务商,也可以是内网部署的兼容接口。不使用 AI 工程师时不发送数据。你的灵犀·Studio装在厂内的服务器或工控机AI 工程师页面右侧的 AI 助手面板工程、设备与点位、画面模型接口需求描述画布截图工程上下文模型服务在「AI 设置」里选择,用你自己的密钥预置服务商DeepSeek、智谱、通义千问、Kimi 等自定义:内网部署的兼容接口不使用 AI 工程师时,不会向模型服务发送数据。
图 1 AI 工程师只在你使用时,把需求、截图和必要的工程上下文发给你配置的模型服务

操作步骤#

打开 AI 设置#

点击左侧菜单 系统管理 → AI 设置。页面顶部有三个页签:模型供应商、MCP 服务器、Skills 技能。第一次配置只需要 模型供应商。

页面上半部分是 已配置供应商,下半部分是可以添加的预置服务商。

AI 设置:上方是已配置的供应商,下方点击任一服务商卡片开始添加
  1. 1使用中
  2. 2测试连接
  3. 3点击服务商

选择服务商并填写 API Key#

在下方点击要使用的服务商卡片,例如 DeepSeek、智谱 GLM、通义千问 Qwen、Kimi (月之暗面) 等,弹出 添加供应商 对话框。预置服务商已经填好了 BaseURL 和推荐的模型名,你只需要:

  1. 点击对话框顶部的 获取 API Key ↗,到服务商官网创建密钥;
  2. 把密钥粘贴到 API Key;
  3. 核对 主模型 与 轻量模型,与你在服务商处开通的模型一致。
添加供应商:预置服务商已填好 BaseURL 与模型名,填入 API Key 即可
  1. 1获取密钥
  2. 2已预填
  3. 3粘贴 API Key
  4. 4保存
字段说明
名称显示在供应商列表里的名字
BaseURL模型服务的接口地址,预置服务商已填好
API Key你在服务商处创建的密钥
主模型搭画面、写逻辑等主要工作使用的模型
轻量模型简单任务使用的模型
币种、输入价、输出价每百万 token 的价格,AI 助手面板据此折算本次会话的大致费用
支持视觉 (图片输入)模型能理解图片时勾选;不勾选时,会话里的图片不会传给模型,面板会提示你切换供应商

用自己的密钥,并设置用量上限

API Key 相当于付费账号的钥匙。只在 AI 设置 里填写,不要写进需求描述或截图里;建议在服务商控制台为这个密钥设置用量或金额上限。

保存并启用#

点击 保存。新供应商出现在 已配置供应商 中。如果卡片上没有 使用中 标记,点击卡片上的 启用。同一时间只有一个供应商处于使用中。

测试连接#

点击供应商卡片上的 测试。页面右上角提示 连接成功 并显示耗时,说明配置正确;提示 连接失败 时,按提示内容检查 API Key、BaseURL 和模型名。

预期结果

  • 已配置供应商 中,你添加的供应商显示 使用中;
  • 点击 测试 提示 连接成功;
  • 打开任一组态画面的设计器,点击右上角的 AI 助手 按钮,面板底部显示当前使用的模型。

内网部署:接入自建的模型服务#

工厂网络不能访问外网时,可以接入在内网部署的模型服务:

  1. 在预置服务商列表的最后点击 自定义供应商;
  2. BaseURL 填写内网模型服务的地址,API Key 填写该服务要求的密钥;
  3. 保存、启用、测试,步骤与上文相同。

接口要求

AI 设置里的所有供应商都按 Anthropic 协议调用,自定义供应商也必须提供兼容该协议的接口。内网部署的模型服务需要支持这一协议,或在前面加一层协议转换。

断网环境下没有可用的模型服务时,AI 工程师不可用;采集、组态、告警等其它功能不受影响。

哪些数据会发给模型服务#

使用 AI 工程师时,会发送到你选定的模型服务的内容包括:

  • 你在 AI 助手面板里输入的需求描述和上传的文件;
  • 搭建过程中的画布截图;
  • 完成任务所需的工程上下文,例如设备与点位名称、画面结构。

不使用 AI 工程师时,不会向模型服务发送数据。对数据外发有要求的工厂,建议使用内网部署的模型服务。

常见问题#

AI 助手面板显示「还未配置 AI 供应商」#

还没有处于 使用中 的供应商。点击面板里的 前往 AI 设置,按上文添加并启用一个供应商。

测试提示连接失败#

按提示内容逐项检查:API Key 是否复制完整、是否已过期;主模型 名称是否与服务商开通的一致(部分服务商需要填接入点或已开通的模型 ID);灵犀·Studio 所在的机器能否访问 BaseURL。

面板提示模型看不到图片#

当前供应商没有勾选 支持视觉 (图片输入)。确认模型本身支持图片输入后,编辑供应商勾选该项;模型不支持时,换一个支持图片输入的供应商。

下一步#

这篇文档对你有帮助吗?