一、AI 助手配置
操作路径：【管理后台】→【开发管理】→【参数设置】→【AI助手】
权限：需要管理员权限
1.1 基础配置
- AI 功能开关：是否启用AI助手。关闭后系统中不显示AI助手入口
- 模型模式：选择AI大模型提供商（如通义千问 qwen）
- 模型名称：具体的模型型号
- 模型 API 地址：大模型API的接口地址
- 模型 API 密钥：API访问密钥
1.2 对话设置
- 上下文窗口：每次对话携带的历史消息数量（默认20条），越大越能记住更多对话内容，但消耗更多Token
- 频率限制：每分钟允许的最大请求次数（默认30次）
1.3 知识库配置
知识库是AI助手回答专业问题的核心数据来源：
- 检索条数（topK）：每次检索返回的最相关文档片段数量（默认5）
- 相似度阈值：文档片段与问题的最低相似度，低于此值的结果会被过滤（默认0.6）
- 分段大小：文档切分时每个片段的字符数（默认500）
- 分段重叠：相邻片段的重叠字符数（默认50），确保不丢失跨段信息
- 最大文件大小：单个上传文件的大小限制（默认10MB）
1.4 向量模型配置
用于将文本转换为向量（数字表示），实现语义搜索：
- Embedding 模型：向量模型名称（默认 text-embedding-v4）
- Embedding API 地址：向量模型的接口地址
- Embedding API 密钥：向量模型的访问密钥
1.5 向量存储配置
- 存储类型：
- none（本地）：使用系统内置存储，适合小规模使用
- qdrant：使用 Qdrant 向量数据库，适合大规模知识库
- 使用 Qdrant 时需配置：主机地址、端口、集合名称、API密钥
1.6 连接测试
配置完成后，点击「测试连接」可验证大模型、向量模型、Qdrant 的连接状态。
二、知识库管理
路径：【管理后台】→【AI 助手管理】→【知识库】（/ai-admin/knowledge）
权限：需要管理员权限
知识库是AI助手回答知识类问题的数据来源。
初始化新环境只执行 create_table.sql 时，系统会预置一批知识库分类和 Markdown 文档正文。预置文档保存于数据库 content_text，不携带历史分段和向量；管理员完成向量模型配置后，需要在文档列表点击「重建索引」，系统会基于当前正文重新分段和向量化。文档状态变为「已完成」后，AI 才能在知识模式中检索到这些内容。
2.1 分类管理
左侧的分类树用于组织知识库文档：
- 点击「新增」创建分类
- 支持多层级分类结构
- 选择分类后，右侧显示该分类下的文档
2.2 上传文档
上传、在线录入和重建索引都依赖向量化模型配置。若 Embedding 模型、API 地址或密钥未配置，系统会提示“知识库功能未就绪”并拒绝操作。
- 点击「上传文档」按钮
- 选择文档分类
- 选择文件（支持 PDF、Word(.docx)、Markdown(.md) 格式，单文件不超过10MB）
- 点击上传
- 系统会自动对文档进行分段和向量化处理
- 处理完成后，AI助手即可基于该文档内容回答问题
2.3 在线编辑 Markdown
除了上传文件，还可以在线创建 Markdown 文档：
- 点击「在线录入 Markdown」
- 输入标题
- 使用 Markdown 编辑器编写内容
- 保存后自动进行向量化处理
2.4 文档管理
- 查看详情：查看文档的处理状态、分段数量等信息
- 编辑：修改 Markdown 文档内容
- 删除：删除文档及其向量数据
- 重建索引：对预置文档、失败文档或已修改文档重新分段和向量化
- 处理状态：
处理中表示尚未完成向量化或等待重建索引；已完成表示已有可检索分段；失败表示解析或向量化失败，可查看失败原因后处理
三、AI 助手使用方法
3.1 打开 AI 助手
- 点击页面右下角的AI助手悬浮按钮
- 或使用键盘快捷键唤起
3.2 聊天模式
AI助手支持5种工作模式，点击输入框左侧的模式选择器切换：
- 智能模式（默认）：AI自动识别您的意图，智能选择回答方式。适合大部分场景
- 起草模式：专注合同起草。上传合同文件后，AI自动解析并帮您创建合同草拟
- 数据模式：专注数据查询。如"查询本月待审批的合同有多少"、"列出我的待处理任务"
- 知识模式：专注知识库问答。基于知识库中的文档回答制度流程等问题
- 预审模式：专注合同风险审查。上传合同文件后，AI按照预审规则检查合同风险
3.3 常见使用场景
查询数据
- "查询当前所有审批中的合同"
- "查询我的待处理任务"
- "本月新增了多少合同"
咨询知识（需先完成知识库向量化）
- "合同审批流程是什么"
- "XX类型合同需要哪些审批材料"
- "企业微信如何配置"
合同起草
- 切换到「起草」模式
- 上传合同文件
- AI自动解析并创建草拟
合同预审
- 切换到「预审」模式
- 上传待审查的合同文件
- AI根据预审规则检查风险点
预审模式开关
管理员可通过系统参数 ai.prereview.mode 控制预审入口：
| 值 | 含义 |
|---|---|
off | 关闭预审模块，自动和手动预审都不可用 |
manual | 仅允许用户手动发起预审 |
auto | 自动预审与手动重跑都可用 |
预审总开关仍依赖 AI 能力是否启用；auto 模式下手动重新预审会覆盖为该合同最新结果。
3.4 AI引导页
首次打开AI助手或新建对话时，会显示引导页，包含：
- 核心能力卡片：展示AI助手的主要功能
- 常用提问：预设的常见问题，点击即可发送
四、预审规则管理
路径：【管理后台】→【AI 助手管理】→【预审规则】（/ai-admin/prereview）
配置AI合同预审时使用的审查规则。
操作说明
- 新增或编辑预审规则
- 设置规则名称、适用的合同类型
- 编写规则内容（如"合同必须包含违约条款"、"付款条件不得超过60天"等）
- 启用规则
- AI在预审模式下会依据这些规则检查合同
五、提示模板管理
路径：【管理后台】→【AI 助手管理】→【提示词管理】
管理AI助手使用的提示词模板，影响AI的回答风格和行为。
操作说明
- 系统预置了默认提示模板
- 可自定义修改提示模板内容
- 修改后新的对话立即生效，已有对话不受影响
六、AI 抽取字段配置（动态识别扩展字段）
路径：【管理后台】→【AI 助手管理】→【AI 抽取字段配置】（/ai-admin/extract-field）
读权限：ai:settings:admin；保存权限：ai:settings:save
AI 在「起草」模式下解析上传的合同文件时，会按照本配置识别并回填合同字段。配置分为「基础字段」和「扩展元素」两类，让 AI 的识别范围可配置、可扩展——既能识别系统内置字段，也能动态识别管理员在「元素管理」中配置的扩展字段。
6.1 基础字段
系统内置字段（如合同名称、金额、期限、合作方等）。每个字段可配置：
- 启用：开启后该字段才纳入 AI 抽取范围。
- 排序：控制字段在抽取提示词中的呈现顺序。
- 补充抽取提示：可选，为该字段补充额外的识别说明，会附加到提示词中，帮助 AI 更准确地定位字段值。
当配置表为空或全部禁用时，系统回退到内置默认字段集，保证 AI 起草识别始终可用。
6.2 扩展元素（动态扩展字段）
扩展元素来源于合同类型上配置的动态表单元素（即「元素管理」中的扩展字段），系统会自动排除附件/图片类等不适合文本抽取的元素。
- 纳入 AI 抽取：勾选后，对应合同类型在草拟时会识别该元素的值并回填到扩展表单。
- 排序 / 补充抽取提示：仅在勾选纳入后可编辑，含义与基础字段一致。
- 元素数量较多时，列表支持按名称/标识搜索、按元素类型筛选、「仅看已纳入」过滤和分页。
6.3 按合同类型预览
选择某个合同类型后，可只读预览该类型草拟时实际会纳入抽取的扩展元素清单及顺序，便于在保存前确认配置效果。
6.4 与扩展字段的关系
- 扩展字段在【管理后台】→【合同基础配置】→【元素管理】中定义，并在合同类型中引用。
- 本页决定哪些扩展字段会被 AI 识别回填；台账中扩展字段的「显示 / 检索」开关另在元素管理中配置（详见《我的合同与合同台账功能说明》）。
- 三者配合实现：扩展字段一次定义 → AI 智能识别回填 → 台账按扩展字段检索的闭环。