# 模型与 Agent 设置
组织管理员在「我的组织」里配置模型来源、默认模型、每人每月额度，定制助手的名称、图标、预提示词与能力开关，并定义业务数据类型与检索已安装的知识包。
## 谁能用
页面功能主要面向组织管理员开放，不同角色在系统中的查看与操作权限如下：
| 页面 | 导航名称 | 所属分组 | 侧栏可见角色 | 页面读取权限 | 页面修改权限 |
|---|---|---|---|---|---|
| 「模型与额度」 | 「模型与额度」 | 「助手」 | 仅「管理员」 | 「管理员」；「审计员」通过链接只读查看（顶栏显示「只读」「审计员只能查看。」） | 仅「管理员」 |
| 「助手设置」 | 「助手设置」 | 「助手」 | 仅「管理员」 | 「管理员」；「审计员」通过链接只读查看（输入框禁用，无「保存」按钮） | 仅「管理员」 |
| 「Skill 与连接」 | 「Skill 与连接」 | 「助手」 | 仅「管理员」 | 「管理员」；「审计员」通过链接只读查看（输入框禁用，无「保存」按钮） | 仅「管理员」 |
| 「数据模型」 | 「数据模型」 | 「数据」 | 仅「管理员」 | 「管理员」；「审计员」通过链接只读查看（显示「审计员只能查看。」） | 仅「管理员」 |
| 「知识库」 | 「知识库」 | 「数据」 | 仅「管理员」 | 「管理员」、「审计员」、「分析员」、「成员」均可搜索 | 本页无修改操作（知识包安装与卸载在[应用与市场](/admin/apps)） |
权限表现说明：
- 「分析员」和「成员」直接打开「模型与额度」「助手设置」「数据模型」「Skill 与连接」时，展示空状态标题「没有权限」，说明「你的账号角色不允许查看这个页面。请联系租户管理员。」。
- 「分析员」和「成员」打开「我的组织」时，不显示这个应用。「审计员」侧栏不包含上述五个管理页面。
- 组织内没有配置可用模型时，[工作台](/guide/workspace)助手输入框禁用，提示「你的组织还没有可用的模型，请联系管理员（「我的组织」→ 模型与额度）」。
- 组织月度总额度耗尽时，[工作台](/guide/workspace)提示「本月的模型额度已用完，管理员可以在「模型与额度」里调整。」，且不可点击「重试」。
- 应急支持会话（平台应急只读模式）无法读取组织知识库。
- 助手代读权限：管理员的助手可以代读「模型与额度」与「助手设置」；普通成员的助手无法代读。「知识库」页面不提供助手代读。
## 怎么打开
1. 登录[工作台](/guide/workspace)（`https://app.{base}`）。
2. 在左侧套件分组「行政」中，点击系统内置应用「我的组织」（系统内置，无法卸载）。组织应用嵌入在工作台中运行；若单独在浏览器中访问组织应用域名，会提示「请从工作台打开」。
3. 在「我的组织」左侧导航中，根据需要进入对应功能：
- 「助手」分组：「模型与额度」「助手设置」「Skill 与连接」。
- 「数据」分组：「数据模型」「知识库」。
工作台页签标题由「我的组织」、分组「助手」、页名「模型与额度」与当前页签（如「用量」）用「 · 」连接。
从助手或已发出的链接进入时，可直达「模型与额度」「助手设置」「Skill 与连接」「数据模型」或「知识库」。
## 界面一览
### 1. 模型与额度
页头显示「模型与额度」，包含四个页签：「用量」「成员管控」「账单」「策略」。在「策略」页签且具备修改权限时，右上角提供「还原」与「保存」按钮。
图：「模型与额度」的「用量」
1. 页头「模型与额度」
2. 页签「用量」「成员管控」「账单」「策略」
3. 本月已用、请求数、失败请求
4. 侧栏「试一试」：会消耗额度，不要用真实供应商密钥
| 页签 | 主要内容与构成 |
|---|---|
| 「用量」 | - **周期与重置**：顶部展示「{日期} 重置额度」（下月 1 日重置），统计周期下拉菜单可选「7 天」「30 天」「90 天」（默认 30 天）。
- **统计指标卡片**：包含「本月已用 tokens」（配置上限时展示使用率进度条；满额提示「额度已用完，模型调用被拒绝。」；未满提示「额度 {上限}，已用 {百分比}%」；未设上限提示「不限额度」）、「{天数} 天请求数」、「{天数} 天 tokens」、「失败请求」（失败占比文案为「占请求的 」加上百分比与「%」）。若平台模型未接入网关，显示警告卡片「没有接入模型网关」及「平台模型不可用。改用自带密钥，或联系运营方。」。
- **每日趋势**：展示「每日 token 用量」（说明「最近 {天数} 天」），悬停显示「{日}：{n} tokens」；无调用时显示「这段时间还没有调用。」。
- **按模型分析**：表格包含「模型」「来源」（徽章「自带」「平台」）、「请求」、`Tokens`、「估算费用」（自带密钥显示「—」）；无调用时标题显示「还没有调用」。
- **侧栏「试一试」**：说明「会消耗额度。」，提供「模型」选择器、提示词输入框（默认「你好，请用一句话介绍你自己。」，最多 2000 个字符）与「发送」按钮；调用成功后标题显示「{模型} · {n} tokens」。
- **按人分析**：卡片展示「{天数} 天费用」、「平均响应」（说明「一次调用从发出到结束」）、「用的人」（展示调用种类与次数，种类包含「对话」「定时任务」「外部 Agent」「测试」「系统」）；表格展示「人」（无人调用归为「平台（无人）」）、「角色」（「管理员」「成员」「分析员」「审计员」）、「请求」、`Tokens`、「费用」、「本月额度」（展示已用与上限，或已用且不限额度；已暂停成员显示徽章「已暂停」）；无数据时显示「还没有人用过」。 |
| 「成员管控」 | - **成员列表**：标题「成员的模型使用」，说明「额度按自然月计，月初恢复。」。表格列展示「人」（显示姓名、邮箱、部门；服务账号显示徽章「服务账号」）、「角色」、「可用模型」（显示「全部」、「限定 {n} 个」或「{n} 个」）、「本月额度」（展示额度进度条，个人专属配置显示「（个人）」后缀，不限额度显示「{已用}，不限」）、「状态」（「正常」或「已暂停」）。具备权限时显示操作列「设置」按钮。无成员时显示「还没有成员」。
- **成员设置弹窗**：说明「只影响这一个人，留空则沿用组织设置。」。包含配置项：「暂停模型使用」（说明「他的助手和定时任务也会停用。」）、「每月 token 上限」（提示「默认 {组织上限或不限}，0 表示不限」，占位「沿用默认」）、「限定可用的模型」（无可选模型时提示「现在没有可选的模型。」）以及「取消」「保存」按钮。 |
| 「账单」 | - **筛选与导出**：月份下拉菜单支持选择最近 12 个月（格式为 `YYYY-MM`），提供「下载 CSV（按模型）」与「按人」按钮。
- **账单概览**：卡片展示「{月份} 合计」、「请求」、`Tokens`（提示「自带密钥不计费」）。金额单位为 USD（金额 ≤ 0 时显示「—」，不足 0.01 显示「< 0.01 USD」）。
- **明细表格**：表「按模型」展示「模型」「来源」（「自带」「平台」）、「请求」「输入 tokens」「输出 tokens」「当前单价（每百万）」「金额」，无数据提示「这个月没有调用」；表「按人」（有数据时显示）展示「人」（无人员行显示「平台（无人）」）、「角色」「请求」、`Tokens`、「金额」。 |
| 「策略」 | - **模型来源**：单选「平台模型」或「自带密钥（BYO）」。选择自带密钥时需填写「供应商」（必填）、「接口地址」（选填，留空使用默认地址）与 `API Key`（已保存密钥显示「已保存」徽章，占位「••••••••（保持不变）」）。
- **可用模型**：若有模型被停用，展示不可用警告「有 {n} 个允许的模型现在用不了」「运营方已停用：……。取消勾选即可。」；若平台新增模型，提示「平台有 {n} 个模型没有被允许」「新增的模型不会自动加入，成员暂时选不到：……。勾选需要的，或改为「全部可用模型」。」；无模型提示「没有可用的模型，请联系运营方添加。」。
平台来源模式下可选择「范围」为「全部可用模型」或「只允许选中的」，列表展示复选框、显示名、等宽标识、单价（「输入 {入} · 输出 {出} / 百万 tokens」）与「显示名称（别名）」（最多 40 个字符）；自带密钥模式下通过「自带密钥可用的模型」输入框维护（每行一个模型 ID）。
提供下拉选择「默认模型」（包含「自动（第一个可用的）」；不可用项标注「（当前不可用）」）与「后台模型」（说明用于会话命名、推荐问题、压缩长对话；选项包含「平台默认（未单独指定时用默认模型）」等）。
- **额度与限速**：包含「每月 token 额度」（提示「0 表示不限」）与「每分钟请求数」（提示「0 表示不限」）。
- **按人与角色**：说明提示个人例外可在「成员管控」中设置。包含「每人每月 token 上限」（提示「0 表示不限。超出后本月不能调用，下月初恢复。」）；平台来源下提供「按角色限定模型」，针对「成员」「分析员」「审计员」「管理员」配置关闭（「不限制」）或开启（「只能用选中的 {n} 个模型」），脚注说明「多个角色取模型并集；有一个角色不受限，就不受限。」。
- **数据与合规**：包含「数据驻留」（说明「只使用该区域内的模型。」，可选「不限制」「中国境内」「欧盟」「美国」）与「记录提示词与回复内容」（说明「关闭后只记录用量。」，开关）。 |
### 2. 助手设置
页头显示「Agent 设置」与「保存」按钮（具备写权限且有未保存改动时可点击）。
- **「基本信息」**：
- 「名称」：输入框，提示「最多 24 个字符」，占位文字「助手」。
- 「图标」：提供「恢复默认」按钮。内置 16 种图标：「星光」「机器人」「智能」「魔杖」「火箭」「闪电」「罗盘」「灯泡」「原子」「羽毛」「花」「叶子」「宝石」「星」「心」「咖啡」。留空默认使用平台星光图标。支持自定义图标（提示「或自定义：一个表情（如 🦊），或 https:// 开头的方形图片地址」）。
- **「系统提示词」**：输入框提示「不能放宽平台安全规则：助手仍只能读取和起草，修改须人工确认。」，最多支持 4000 个字符。
- **「快捷引导与提醒」**：说明提示快捷提问最多 6 条，留空则使用系统默认。提供「添加一条」与删除按钮；底部提供「提醒」输入框（提示「最多 200 个字符」，占位文字「助手仅具备读取与起草权限，修改需由人工确认后生效。」）。
- **「效果调试」**：说明「不读取业务数据、不保存记录，但会消耗模型额度。」。支持最多选择 4 个已允许模型进行并行对话对比（未允许模型带有「未允许」徽章，需先在策略中放开；默认模型带有「默认」徽章；无模型显示「没有可测试的模型。」）。每列顶部支持「设为默认」与清空对话；无对话显示「还没有对话。」，等待回复显示「思考中…」，单次回复展示耗时与 token 统计（如「{秒} 秒 · 输入 {入} · 输出 {出} tokens」）；输入框按 Enter 发送，Shift+Enter 换行，最多 2000 个字符。
- **「效果预览」**：展示助手在对话界面的欢迎效果（「随时向{名称}提问，或描述你需要处理的业务任务。」）；未配置推荐提问时默认展示两条：「我现在能用哪些应用？分别能做什么？」「总结一下最近有什么需要我处理的」；底部展示「上次保存：」时间及更新人。
### 3. Skill 与连接
页头显示「Skill 与连接」与「保存」按钮。包含两个能力开关：
- **「图表与组件」**：说明「组件在隔离环境运行，无网络，读不到你们的数据。」。开关项「允许助手生成组件」：开启显示「开：必要时画图。」；关闭显示「关：只用文字和表格回答。」。
- **「联网搜索」**：说明「搜索词会发送到外部搜索服务，每次搜索记入审计日志。默认关闭。」。开关项「允许助手联网搜索」：开启显示「开：需要时联网搜索，并给出来源链接。」；关闭显示「关：只用你们自己的数据和已有知识回答。」；若平台未配置搜索服务，提示「平台未配置搜索服务，开启暂不生效。」。
### 4. 数据模型
页头显示「数据模型」与「新建数据类型」按钮。
- **列表区域**：
- 表格列展示「名称」（下方显示等宽标识；模板导入类型显示徽章「来自模板 {条目} v{版本}」）、「字段」（展示字段名，最多 5 个用「、」连接，超出部分显示「 等 {n} 个」）、「敏感」（显示「{n} 个加密字段」或「—」）、「版本」（`v{n}`）、操作列「数据」（点击直接跳转至[数据](/admin/data)应用并携带该类型）；行操作菜单包含「编辑」「删除」。
- 列表底部显示「共 {n} 个数据类型」。
- 无数据类型时显示空状态，标题「还没有数据类型」，说明「例如“客户”：名称、邮箱、手机、阶段。」。
- **设计器（新建 / 编辑）**：
- 标题显示「新建数据类型」或「编辑 {名称}」（编辑时显示「版本 {n}」）。
- 顶部说明：「数据类型定义一类业务对象（客户、合同、工单……）的字段和规则。保存后立即生成接口、导入导出，并对智能体可见。」。
- 基础字段包含「名称」（必填）、「标识」（必填，创建后不可修改）、「说明」。
- 字段列表提供「添加字段」按钮（新建时默认包含一个标识为 `name`、名称为「名称」的必填文本字段）。每个字段可设置：
- 「字段名称」「标识」
- 「类型」：可选「文本」「长文本」「整数」「数字」「是/否」「日期」「日期时间」「单选」「邮箱」「手机」「链接」「关联（单个）」「关联（多个）」。
- 单选类型需填写「选项」（用逗号分隔）；关联类型需在「关联到」中选择目标数据类型；数值类型可设置「最小值」「最大值」。
- 属性勾选：「必填」「唯一」「敏感数据（加密）」（敏感字段说明「敏感字段逐条加密存储；智能体、搜索、排序、审计日志都看不到明文，删除记录即永久销毁其密钥。」）。
- 「记录标题字段」下拉菜单（排除敏感字段，提示「列表和关联选择里显示它」）。
- 「谁可以操作」权限控制：说明「默认：管理员、成员可写，所有角色可读，仅管理员可删除。审计员始终只读。」。分为「新建」「查看」「修改」「删除」四个动作，每个动作后跟「：限定角色」，可选角色包括「管理员」（不可取消）、「分析员」、「成员」（「查看」动作另含「审计员」）。
- 底部操作按钮：「取消」「创建」/「保存」。
图：「数据模型」列表
1. 页头「数据模型」
2. 「新建数据类型」
3. 列「字段」：最多列出 5 个，多则「等 n 个」
4. 类型「客户」：字段、敏感、版本；行内「数据」进记录页
### 5. 知识库
页头显示「知识库」，说明「按关键词匹配，不是按语义。」。
- **未启用与未安装状态**：若部署未启用，显示「这个部署没有启用知识库。」；若组织尚未安装知识包，显示空状态「还没有安装知识包」，说明「去市场安装一个知识包。」并提供按钮「去市场」跳转至[应用与市场](/admin/apps)。
- **搜索区域**：搜索框（占位文字「搜索，比如：退款要多久」）与「搜索」按钮。未发起搜索时显示「搜一个问题试试」；无搜索结果时显示「没有找到“{词}”」，说明「换个说法，或者拆成更短的词。」；命中结果显示节标题「找到 {n} 段」（说明「搜索“{词}”」）以及对应的知识包徽章（`{条目} v{版本}`）。
- **侧栏概览**：展示「已安装的知识包」，说明「{n} 个知识包 · {m} 个段落」；每个知识包展示版本、文档篇数与段落数（「v{版本} · {篇} 篇文档 · {段} 个段落」），并提供链接跳转至应用详情。
## 常用操作
### 配置与保存模型策略
图：「策略」：保持平台模型，不填真实密钥
1. 页签「策略」；可写时顶栏有「还原」「保存」
2. 「模型来源」：平台模型或自带密钥（BYO）
3. 本页保持「平台模型」，不要改成外部真实供应商
4. 「可用模型」：全部或只允许选中的；可设默认 / 后台模型
1. 在左侧导航点击「助手」→「模型与额度」，切换至「策略」页签。
2. 在「模型来源」中选择「平台模型」或「自带密钥（BYO）」。
3. 若选择「自带密钥（BYO）」：
1. 在「供应商」中填写模型供应商标识（必填，占位文字 `deepseek`）。
2. 在「接口地址」中填写服务地址（选填，留空使用供应商默认地址；若填写必须以 `http://` 或 `https://` 开头）。
3. 在 `API Key` 密码框中填入密钥（首次填写必填；已有密钥显示「已保存」徽章，占位显示「••••••••（保持不变）」）。
4. 在「自带密钥可用的模型」输入框中输入允许调用的模型 ID，每行一个（支持空格、逗号或分号分隔）。
4. 若选择「平台模型」：
1. 在「范围」中选择「全部可用模型」或「只允许选中的」。
2. 若选择「只允许选中的」，在列表中勾选允许组织使用的模型。可在每行别名输入框中填写「显示名称（别名）」（1–40 个字符，不能包含换行符或 `<` `>`）。
5. 选择默认模型与后台模型：
- 在「默认模型」下拉菜单中选择新会话起点模型（可选「自动（第一个可用的）」；所选模型必须在允许的模型列表中）。
- 在「后台模型」下拉菜单中选择用于会话命名、生成推荐问题与压缩长对话的模型（建议选择价格便宜、响应快的小模型；可选「平台默认（未单独指定时用默认模型）」）。
6. 配置额度与限速（填写的数值必须为不小于 0 的整数，0 表示不限）：
- 在「每月 token 额度」中输入组织月度总限额。
- 在「每分钟请求数」中输入组织整体调用速率上限。
- 在「每人每月 token 上限」中输入普通成员默认的月度限额（超出后该成员本月无法继续调用，下月 1 日恢复）。
7. 配置角色模型（仅限平台模型来源）：根据需要开启「按角色限定模型」，为「成员」「分析员」「审计员」「管理员」分别勾选允许使用的模型集合。
8. 配置数据与合规：
- 在「数据驻留」中选择模型运行区域，可选「不限制」「中国境内」「欧盟」「美国」。
- 根据合规审计要求设置「记录提示词与回复内容」开关（关闭后仅记录 token 消耗，不留存对话正文）。
9. 点击右下角「保存」。保存成功后提示「模型策略已保存」，新策略立即生效。未修改任何内容时「还原」与「保存」按钮为禁用状态。
### 在用量页测试模型
1. 在左侧导航进入「模型与额度」，保持在「用量」页签。
2. 在右侧「试一试」面板中，选择要测试的「模型」（默认为当前默认模型）。
3. 在提示词输入框中输入测试内容（默认提示词为「你好，请用一句话介绍你自己。」，内容不超过 2000 个字符）。
4. 点击「发送」。
5. 系统向模型发起请求，调用成功后卡片标题显示「{模型} · {n} tokens」。
> **提示**
>
> 「试一试」调用会正常扣减组织当月的 token 额度，超时时间为 60 秒，调用类型在统计中归类为「测试」。
### 设置单个成员的模型与额度
1. 在「模型与额度」页面中，切换至「成员管控」页签。
2. 在成员列表中找到目标成员，点击该行操作列的「设置」按钮。
3. 在弹出的设置弹窗中修改个人配置（留空项沿用组织设置）：
- 若需禁止该成员使用模型，勾选「暂停模型使用」（勾选后该成员的助手与定时任务将同时停用；管理员无法暂停自己的账号）。
- 在「每月 token 上限」中填写该成员专属的月度限额（输入 0 表示不限，留空表示沿用组织默认设置）。
- 在「限定可用的模型」中勾选允许该成员使用的模型集合。
4. 点击「保存」。保存成功后提示「已保存」，配置立即对该成员生效。
### 下载模型用量账单
1. 在「模型与额度」页面中，切换至「账单」页签。
2. 在月份下拉菜单中选择查询月份（最近 12 个月，格式为 `YYYY-MM`）。
3. 点击「下载 CSV（按模型）」下载按模型统计的月度消耗对账单，或点击「按人」下载按成员统计的消耗明细。
4. 浏览器接收并保存导出的 CSV 文件。
### 配置助手外观与预提示词
1. 在左侧导航点击「助手」→「助手设置」。
2. 修改「基本信息」：
- 在「名称」输入框中输入助手的对外展示名称（最多 24 个字符，不能换行或包含 `<` `>`；留空时对外默认显示为「助手」）。
- 在「图标」区域选择助手头像：可直接点击选择 16 种内置图标之一，或在自定义输入框中输入单个表情符号（如 🦊）或以 `https://` 开头的方形图片地址（最多 500 个字符，不能包含空格或 `<` `>`）；点击「恢复默认」可还原为平台星光图标。
3. 配置「系统提示词」：在提示词输入框中录入组织统一的指令与口径（最多 4000 个字符）。该内容将在服务端自动拼装至每轮对话的平台规则之后。
4. 配置「快捷引导与提醒」：
- 在开场提问列表中点击「添加一条」或点击删除图标维护推荐问题（最多 6 条，每条最多 80 个字符，须为单行且不能包含 `<` `>`；全部留空时系统展示默认提问）。
- 在「提醒」文本框中填写输入框下方的合规提醒文字（最多 200 个字符，单行且不能包含 `<` `>`）。
5. 点击右上角「保存」。保存成功后提示「已保存，新的对话立即生效」。
### 进行多模型对比调试
1. 在「助手设置」页面中，向下滚动至「效果调试」区域。
2. 选择要参与对比的模型（最多可同时选择 4 个已允许的模型；标有「未允许」徽章的模型须先在「模型与额度」策略中放开）。
3. 在输入框中输入测试内容（最多 2000 个字符），按 Enter 键发送（按 Shift+Enter 换行）。
4. 调试区域将使用表单中**尚未保存**的助手名称与预提示词进行回复，多模型并行展示回答结果、耗时及 token 消耗统计。
5. 调试过程中可点击列头的清空图标清空对话；若某个模型表现符合预期，可点击列头的「设为默认」将其直接设为组织的默认模型（设置成功提示「已把「{显示名}」设为默认模型」）。
> **提示**
>
> 效果调试不读取组织业务数据，不保存历史记录，但会真实消耗组织模型额度。单次请求超时时间为 90 秒，最多支持连续 12 轮对话。
### 开关助手能力（组件与联网搜索）
1. 在左侧导航点击「助手」→「Skill 与连接」。
2. 根据组织需要调整功能开关：
- 「允许助手生成组件」：开启时助手可在对话中渲染图表等组件（在隔离环境中运行，无网络访问权限，无法读取组织数据）；关闭时助手仅使用文字和表格回复。
- 「允许助手联网搜索」：开启时助手可在需要时检索外部互联网信息并给出参考链接；关闭时仅使用组织内部数据与已有知识回答。若平台未配置外部搜索服务，开启后界面将提示「平台未配置搜索服务，开启暂不生效。」。
3. 点击右上角「保存」。保存成功后提示「已保存，新的对话马上用上」。
### 新建与编辑数据类型
图：「新建数据类型」对话框
1. 「标识」：创建后不可改；小写字母开头
2. 「名称」：必填，例如 客户
3. 「字段」：至少 1 个，最多 100；新建默认带必填「名称」
4. 「添加字段」
1. 在左侧导航点击「数据」→「数据模型」。
2. 点击右上角「新建数据类型」（若要修改现有类型，在列表对应行点击操作菜单「编辑」）。
3. 填写基本信息：
| 字段 | 必填 | 说明 |
|---|---|---|
| 「名称」 | 是 | 填写业务对象的显示名称（如「客户」），长度不超过 60 个字符。 |
| 「标识」 | 是 | 填写英文唯一标识（如 `customer`），须为 2–41 位小写字母开头，由小写字母、数字、下划线组成。创建后永久不可修改。 |
| 「说明」 | 否 | 填写数据类型的业务说明，长度不超过 500 个字符。 |
4. 维护字段定义（点击「添加字段」新增字段；新建时默认包含一个标识为 `name`、名称为「名称」的必填文本字段；每个数据类型至少包含 1 个字段，最多 100 个字段）：
1. 填写「字段名称」与英文「标识」（同一类型内字段标识不可重复）。
2. 选择「类型」：可选「文本」「长文本」「整数」「数字」「是/否」「日期」「日期时间」「单选」「邮箱」「手机」「链接」「关联（单个）」「关联（多个）」。
3. 根据字段类型配置规则：
- 单选类型：在「选项」中输入枚举选项，用逗号分隔（1–100 项，每项不超过 80 个字符）。
- 关联类型：在「关联到」中下拉选择目标数据类型。
- 数值类型：可按需配置「最小值」与「最大值」。
4. 勾选属性选项：
- 「必填」：该字段是否必须录入。
- 「唯一」：记录值是否在全表中唯一（敏感字段与多值关联字段不支持设为唯一）。
- 「敏感数据（加密）」：勾选后字段逐条加密存储，明文不对助手、搜索、排序或审计日志开放。删除记录时密钥同步销毁。
5. 配置「记录标题字段」：下拉选择一个非敏感字段，用于在数据列表与关联选择中作为主标题显示。
6. 配置「谁可以操作」权限：默认规则为管理员与成员可写、所有角色可读、仅管理员可删除、审计员始终只读。在「新建」「查看」「修改」「删除」四个动作后点击「：限定角色」勾选允许的角色（「管理员」角色不可取消）。
7. 点击「创建」（新建）或「保存」（编辑）。保存成功后提示「已创建数据类型」或「已保存数据类型」，系统立即生成 API 接口、导入导出功能并对助手可见。
> **注意**
>
> 已有数据的数据类型：字段的数据类型、敏感加密属性以及关联目标对象不能再修改，仅支持新增字段。
### 删除数据类型
1. 在「数据模型」列表中，点击目标数据类型行的操作菜单「删除」。
2. 系统检查数据与引用依赖：
- 若该类型没有录入任何记录且未被其他类型关联引用：弹出确认弹窗「删除 {名称}？」，点击「删除」即可移除。删除成功后提示「已删除 {名称}」。
- 若该类型下仍包含业务记录：系统先提示无法直接删除；若确定全部清理，二次确认中点击「连同数据一起删除」，该类型及其全部记录和加密密钥将被永久删除。
- 若该类型被其他数据类型的字段关联引用：系统弹出提示并拦截删除，必须先前往引用方修改或移除关联字段后，方可删除。
> **危险**
>
> 执行「连同数据一起删除」会永久销毁该数据类型下的所有业务记录，敏感字段的加密密钥也将同步销毁，数据无法恢复。
### 检索知识库内容
1. 在左侧导航点击「数据」→「知识库」。
2. 确认已在[应用与市场](/admin/apps)安装知识包（未安装时点击页面中的「去市场」前往安装）。
3. 在搜索框中输入查询内容（1–200 个字符，例如「退款要多久」）。
4. 点击「搜索」。
5. 页面展示匹配的段落列表、段落数量及所属知识包版本。
> **提示**
>
> 知识库采用关键词分词匹配（中文按相邻两字匹配），不是语义向量检索，默认最多返回 8 条相关段落。
## 状态说明
### 模型额度状态流转
```
正常 ──(当月 token 达到上限)──> 额度已用完 ──(下月 1 日重置 / 管理员调高上限)──> 正常
```
- `正常`：组织或成员的 token 消耗未超过设定上限，模型调用正常进行。
- `额度已用完`：本月消耗达到上限，新的模型请求被拒绝，工作台提示额度已用完且无法重试。
### 成员模型状态
- `正常`：成员处于正常可用状态，可按组织策略或个人限定规则调用模型。
- `已暂停`：管理员在「成员管控」中勾选暂停后，成员状态变为「已暂停」，其助手对话与定时任务均被停用。
### 模型供给状态
- `可用`：平台正常提供且组织策略已允许使用。
- `未允许`：平台存在该模型，但组织策略中未勾选放开。
- `当前不可用`：模型被平台运营方停用，策略列表会提示管理员取消勾选。
### 数据类型版本流转
```
v1 (新建成功) ──(编辑保存)──> v2 ──(编辑保存)──> v3 ...
```
数据类型首次创建版本为 `v1`，每次编辑并保存后版本号自动递增（`v{n}`）。已有数据后，字段类型、敏感属性与关联目标锁定。
## 让助手帮你做
你可以让助手帮你调整模型策略、配置成员权限、更新助手外观或定义数据类型。由于涉及组织级配置与安全策略，助手执行关键操作前会发起[动作确认](/agent/confirm)，需要组织管理员确认后方可生效。
你可以这样对助手说：
> 把默认模型改成 deepseek-chat。
> 组织每月额度设为 100 万 tokens，每人每月 5 万。
> 改用我们自己的 DeepSeek 密钥。
> 暂停张三的模型。
> 把助手改名叫小智，开场建议改成问本周待办。
> 关掉联网搜索。
> 建一个客户类型，字段有名称、邮箱、手机。
> 连同数据删掉空的备忘类型。
### 助手支持的操作与确认要求
| 操作内容 | 做什么 | 管理员确认提示 | 风险级别与说明 |
|---|---|---|---|
| 修改模型与额度 | 修改允许模型、默认模型、后台模型、组织月额度、每分钟请求数、每人上限、部门额度、角色模型、别名、数据驻留、是否留存对话内容 | 「保存后，组织里每个人能用的模型与额度立刻按新的设置计算。」 | 高风险。无需二次身份验证。 |
| 设置模型来源（自带密钥） | 切换为自带密钥模式，配置服务商与接口地址 | 「组织里每个人与助手的对话都会改由这里设置的模型服务处理；自带密钥时，对话内容发给你们自己的服务商。」 | 高风险。出于安全考虑，API Key 必须由管理员在审阅页亲自填写，需进行身份验证。 |
| 设置成员的模型使用 | 暂停成员模型权限、调整个人月额度、限定可用模型 | 「这位成员使用助手和模型的权限会立刻改变。」 | 高风险。不能暂停管理员本人。 |
| 修改 Agent 设置 | 修改助手名称、图标、预提示词、开场建议、底部提醒 | 「保存后，组织里每个人与助手的每一次对话都按新的设置进行。」 | 高风险。留空则恢复平台默认。 |
| 开关 Agent 的能力 | 开关「图表与组件」或「联网搜索」 | 「改变后，组织里每个人的助手立刻按新的能力工作；打开联网搜索会把对话里的词发给第三方搜索服务。」 | 高风险。开启联网搜索会将搜索词发送至外部。 |
| 新建数据类型 | 创建新的业务数据对象定义与字段列表 | 「保存后立即生成接口与导入导出，组织里有权限的人和助手都能使用这个数据类型。」 | 高风险。创建后标识不可修改。 |
| 修改数据类型 | 修改现有数据对象的名称、说明、字段或权限配置 | 「这会改变这个数据类型的结构：所有记录、接口、导入导出和助手看到的字段都随之改变。」 | 高风险。字段列表若更新则整表替换；有记录后不可修改字段类型、敏感属性或关联目标。 |
| 删除数据类型 | 删除无记录且未被引用的空数据类型 | 系统直接执行删除 | 高风险。 |
| 强制删除数据类型及其全部记录 | 连同业务记录与敏感加密密钥一并销毁 | 「这个数据类型的全部记录会被永久删除，敏感字段的密钥同时销毁，无法恢复。」 | 高风险。需进行身份验证。 |
> **提示**
>
> 助手不能做的事项：
> - 助手不能代替你点击页面上的「试一试」或在助手设置中发起对话效果测试。
> - 助手无法查看或代填自带密钥的 API Key（密钥仅支持由人在审阅页亲自填写）。
> - 助手无法在当前页面安装或卸载知识包（知识包安装需前往[应用与市场](/admin/apps)）。
> - 助手无法代读「知识库」页面本身的内容。
## 设置
组织管理员可以在各管理页面中配置以下项目：
| 设置项 | 作用 | 取值范围 / 选项 | 默认值 | 谁能修改 |
|---|---|---|---|---|
| 「来源」 | 决定组织调用的模型从何处提供 | 「平台模型」 / 「自带密钥（BYO）」 | 「平台模型」 | 管理员 |
| 「供应商」 | 自带密钥模式下的模型服务商标识 | 文本（如 `deepseek`） | 无 | 管理员 |
| 「接口地址」 | 自带密钥模式下的 API 请求地址 | 以 `http://` 或 `https://` 开头的完整地址 | 留空使用供应商默认地址 | 管理员 |
| `API Key` | 自带密钥模式下的鉴权密钥 | 密码文本（只写不读） | 无 | 管理员 |
| 「自带密钥可用的模型」 | 自带密钥模式下允许调用的模型列表 | 每行一个模型 ID（多项用换行、逗号或分号分隔） | 无 | 管理员 |
| 「可用模型」 | 平台模式下允许组织调用的模型范围 | 「全部可用模型」 / 「只允许选中的」 | 全部可用模型 | 管理员 |
| 「默认模型」 | 成员发起新对话时默认使用的模型 | 组织允许的模型 ID | 「自动（第一个可用的）」 | 管理员（对话调试可「设为默认」） |
| 「后台模型」 | 用于系统会话命名、推荐提问、长对话压缩的模型 | 允许的模型 ID | 「平台默认（未单独指定时用默认模型）」 | 管理员 |
| 「每月 token 额度」 | 组织全月 token 消耗总上限 | 整数 ≥0（0 表示不限） | 0（不限） | 管理员 |
| 「每分钟请求数」 | 组织整体模型调用的频率速率限制 | 整数 ≥0（0 表示不限） | 0（不限） | 管理员 |
| 「每人每月 token 上限」 | 组织成员默认的月度 token 上限 | 整数 ≥0（0 表示不限） | 0（不限） | 管理员 |
| 「按角色限定模型」 | 仅限平台来源，按角色控制允许调用的模型 | 针对成员、分析员、审计员、管理员分别配置 | 不限制 | 管理员 |
| 「显示名称（别名）」 | 成员在对话模型选择器中看到的别名 | 最多 40 个字符（不能换行或包含 `< >`） | 留空使用原生 ID | 管理员 |
| 「数据驻留」 | 限制仅调用指定地理区域内的模型服务 | 「不限制」 / 「中国境内」 / 「欧盟」 / 「美国」 | 「不限制」 | 管理员 |
| 「记录提示词与回复内容」 | 是否在服务端保存提示词与回复正文 | 开启 / 关闭（关闭后仅记录 token 统计） | 关闭 | 管理员 |
| 「名称」 | 助手的全局对外称呼 | 最多 24 个字符（不能换行或包含 `< >`） | 「助手」 | 管理员 |
| 「图标」 | 助手在对话界面展示的头像 | 16 种内置图标、单个表情符号（如 🦊）、`https://` 开头的图片地址（最多 500 个字符） | 平台默认星光图标 | 管理员 |
| 「系统提示词」 | 组织全局生效的助手预置指令口径 | 最多 4000 个字符 | 空 | 管理员 |
| 推荐提问 | 对话空白页面的引导推荐问题 | 最多 6 条，每条最多 80 个字符（单行，不含 `< >`） | 系统默认提问 | 管理员 |
| 「提醒」 | 对话输入框下方的合规与免责提示语 | 最多 200 个字符（单行，不含 `< >`） | 「助手仅具备读取与起草权限，修改需由人工确认后生效。」 | 管理员 |
| 「允许助手生成组件」 | 控制助手是否可以在对话中渲染交互式组件 | 开启（必要时画图） / 关闭（仅文字和表格） | 开启 | 管理员 |
| 「允许助手联网搜索」 | 控制助手是否可以将搜索词发送至外部搜索服务 | 开启 / 关闭 | 关闭 | 管理员 |
## 注意事项
- **额度与重置规则**：
- 额度按自然月计算，在每月 1 日（UTC 时间）零点自动恢复。
- 模型调用的生效判定顺序为：组织允许模型 ∩ 数据驻留区域 ∩ 角色限定模型（多角色取并集，任一角色不限则整人不限） ∩ 成员个人限定模型；同时受组织总额度、每分钟请求上限、个人暂停状态、个人/默认月额度约束。
- 组织额度或个人额度用完后，模型调用将被系统拒绝，工作台将显示额度已用完，无法点击重试。
- **密钥安全与网关机制**：
- 自带密钥（BYO）依然通过平台统一的模型网关转发调用，并不直连供应商，网关必须配置有可用模型列表。
- 自带密钥调用不产生平台费用（账单中金额显示为「—」），但其 token 消耗仍全额计入组织与成员的月度用量。
- API Key 在系统中「只写不读」，保存后界面仅显示掩码，不会明文回显，且不记录进审计日志正文。
- **测试调用的额度消耗**：
- 「模型与额度」中的「试一试」以及「助手设置」中的「效果调试」均为真实模型调用，会正常消耗组织额度并记入审计日志（正文不进审计）。
- 效果调试不读取业务数据，不保存历史记录，单次超时时间为 90 秒，单个模型最多支持 12 轮连续对话。用量页「试一试」单次超时时间为 60 秒。
- **预提示词与安全边界**：
- 助手的预提示词在服务端拼装于平台安全规则之后，不能突破或放宽平台安全规则：助手在系统层始终仅具备读取与起草权限，修改业务数据必须经过人工确认。
- 预提示词仅在服务端参与推理，工作台前端无法读取预提示词内容。
- **数据模型规则与限制**：
- 每个组织最多创建 200 个数据类型，每个数据类型最多定义 100 个字段。
- 数据类型的英文标识创建后不可修改；一旦数据类型中已录入数据，字段的数据类型、敏感加密属性与关联目标将被锁定，无法修改（仅支持新增字段）。
- 敏感字段采用逐条加密存储，不支持设为唯一，且在助手对话、系统搜索、列表排序及审计日志中均不展示明文；删除记录时其加密密钥同步永久销毁。
- 若数据类型已被其他数据类型的字段关联引用，必须先清除关联关系后方可删除。
- 「连同数据一起删除」为不可逆操作，将连同所有业务记录与敏感加密密钥一并永久销毁。
- **知识库检索特性**：
- 知识库采用关键词分词匹配机制（中文基于相邻二字匹配），不支持语义检索；单次查询关键词长度为 1–200 个字符，默认最多返回 8 条段落。
- 知识库仅检索当前处于已安装且启用状态的知识包，停用的知识包不会被检索。
- **界面配置并发覆盖**：
- 「助手设置」与「Skill 与连接」在底层保存同一份配置，若多人在不同页面同时保存，可能会相互覆盖。
- **人员与账号限制**：
- 管理员不能在成员管控中暂停自己的模型使用权限。
- 服务账号亦会展示在成员管控列表中（带有「服务账号」徽章），可单独为其配置模型与额度。
## 目前不支持
- 策略页面目前不支持在界面中直接配置部门额度（助手指令支持设置部门每人每月额度）。
- 用量分析中的「按人」统计目前不支持单独展示后台场景分类（如会话命名、推荐问题、对话压缩等）。
- 知识库目前不支持语义向量检索，不支持在知识库页面直接安装或卸载知识包，也不支持单独调整段落权限。
- 知识库页面目前不支持助手代读。
- 实体单条深度链接（如 `?tenant=`、`?type=`）目前不支持页面自动滚动定位到具体项。
- 目前不支持按业务场景单独关闭追问或后台生成任务。
- 数据类型列表行目前暂无单独的「引用」详情查看按钮。
## 常见问题
#### 为什么在工作台发消息提示「本月的模型额度已用完，管理员可以在「模型与额度」里调整。」？
说明组织当月消耗的 token 总量已经达到了在「策略」页签设置的「每月 token 额度」，或者成员个人的调用量达到了「每人每月 token 上限」。额度按自然月计算，会在下月 1 日自动重置恢复。管理员可以前往「我的组织」→「助手」→「模型与额度」，在「策略」页签中调高组织或个人的额度上限，或者在「成员管控」中为特定成员设置更高的专属额度。
#### 为什么自带密钥（BYO）不产生平台费用，依然会受到额度限制？
自带密钥模式下，虽然模型调用费用直接与外部供应商结算（账单中金额显示为「—」），但请求依然由组织的模型网关进行统一调度与合规管控。为了防止异常调用造成过载，自带密钥的 token 消耗仍会完整计入组织与成员的月度用量，并严格遵守组织设定的月度额度与每分钟请求数限制。
#### 为什么编辑已有数据的数据类型时，无法修改字段类型或取消敏感加密？
数据类型一旦录入数据，其底层存储结构已经确定。为了保护既有数据的完整性与一致性，系统禁止修改已有字段的数据类型、敏感加密属性和关联目标对象。如果业务字段发生变化，可以点击「添加字段」新增字段；如果不再使用旧字段，可在使用层面停用。
#### 为什么配置了自定义系统提示词后，助手依然无法直接帮我修改数据？
系统的安全规则优先于自定义系统提示词。即使在系统提示词中声明允许自动修改，平台安全策略依然强制约束：助手在系统层面始终仅具备只读与起草权限。所有的业务写入或修改操作，都必须生成[草稿](/agent/drafts)或在对话中由人工确认后方可执行。
#### 为什么在「知识库」页面无法搜索到已停用的知识包内容？
知识库仅检索当前处于已安装且启用状态的知识包。若某个知识包已在[应用与市场](/admin/apps)中被停用，系统在检索时会自动排除该知识包的内容。此外，知识库采用关键词分词匹配而非语义检索，搜索时建议输入简短明确的关键词（1–200 个字符）以获得匹配结果。