AI 助手

1 功能概述

AI 助手用于配置 JumpServer 使用的大模型服务，支持 内置 API 与 iframe 嵌入 两种接入方式，并提供配置状态检查。

路径：登录后选择 系统设置 > AI 助手。

图 1 AI 助手配置页面

卡片右上角提供启用开关，开关左侧显示当前状态。未启用时显示 小助手未启用，开启开关后显示 小助手已启用。

模型连接 用于统一配置模型服务，模型列表将直接从服务商动态获取。

接入方式 提供 内置 API 与 iframe 嵌入 两个选项，默认选中 内置 API。内置 API 使用当前模型配置；iframe 嵌入会在隔离面板中加载外部助手页面。

选择 内置 API 后，表单包含以下参数：

参数	说明
服务地址	填写兼容 OpenAI API 的服务地址，通常以 /v1 结尾。界面提示「例如：`https://api.openai.com/v1`」，字段前有红色星号表示必填。
API 密钥	密钥只在 JumpServer 后端保存；留空不会覆盖已经保存的密钥。输入框提示「输入新的 API 密钥」。
网络代理（可选）	仅由 JumpServer 后端访问模型服务时使用。输入框提示「例如：`http://127.0.0.1:7890`」。
模型	模型来自服务商 /models 接口；也可以直接输入模型 ID。下拉框右侧提供获取模型按钮，下拉框下方显示已发现的模型数量。

选择 iframe 嵌入 后，表单只保留 iframe 页面地址 一项。

图 2 iframe 嵌入接入方式

该字段用于填写外部助手页面地址。输入框下方提示「请填写允许 iframe 嵌入的 HTTP 或 HTTPS 页面地址；外部页面无法直接访问 JumpServer 页面数据。」

表单底部显示当前状态与操作按钮。内置 API 方式下提供测试与提交两个按钮，初始状态提示 保存前建议执行测试；执行测试后状态行显示测试结果，连通时提示 连接成功，模型支持工具调用。

iframe 嵌入方式下只提供提交按钮，未填写页面地址时状态提示 等待填写有效的 iframe 页面地址。

页面右侧的 配置状态 显示 READY CHECK 检查结果。内置 API 方式下包含三项检查：

标题右侧显示已完成数量，形如 2/3。选择 iframe 嵌入 后，检查项只有 iframe 页面地址 一项。