Yima Claw
易码 AI 服务端手册服务端
面向管理员与运营人员的完整操作说明，覆盖数据源、技能、对话、定时任务、图表、大屏、成员与权限、小易助手及对接工具。
01
系统简介
易码AI 是面向企业的智能数据查询与分析平台。将大模型与企业数据库连接，让非技术人员通过自然语言提问，直接获得分析结论、图表与 SQL。
QUERY
自然语言问数据
输入"今年采购总数量"即出图表
SKILL
技能配置
固化常见查询，结果更精准
CRON
定时任务
AI 按计划自动跑数据
CHART
图表项目
保存图表、定时刷新、分享
SCREEN
数据大屏
图表网格集中展示
ACL
成员与权限
精细化数据权限控制
EMBED
小易助手
嵌入第三方网站
02
登录
1
在浏览器打开管理后台地址，进入登录页。
2
输入账号、密码。
3
点击「登录」，成功进入系统。
登录
忘记密码请联系系统管理员。登录后如遇页面显示异常，请先刷新或清理浏览器缓存。
03
配置数据源
数据源是 AI 查询数据的基础。支持 MySQLSQL ServerExcel 三种类型。
新建数据源（三步向导）
1
选择类型：MySQL / SQL Server / 本地 Excel。
2
配置信息：填写连接字段，点击「测试连接」，通过后进入下一步。
3
选择数据表：勾选要开放给 AI 的数据库表。
字段说明
| 字段 | 必填 | 说明 |
|---|---|---|
| 数据源名称 | 是 | 名称需唯一 |
| 数据库地址 host | 是 | 如 1.100 |
| 端口 port | 是 | 数据库开放端口 |
| 数据库名 dbName | 是 | 要连接的库 |
| 用户名 | 是 | 有查询权限的账号 |
| 密码 | 是 | 编辑时留空表示不修改 |
| 备注 | 否 |
其他操作
- ✅ 测试连接：配置时必须测试通过才能保存。
- ✏️ 编辑：修改名称/连接信息/备注。
- 📋 管理数据表：点击数据源卡片打开，补选/移除数据表。
- 🔓 公有/私有切换：公有数据源对成员端及其他用户可见。
- 🗑️ 删除：二次确认后删除，自动同步。
数据源
务必用有查询权限（只读）的账号，避免使用高权限账号，降低风险。
04
技能配置
把"某类常见查询"固化为技能。AI 在对话中命中技能后，按技能定义的数据源、表、规则执行，结果更规范。
新建技能
1
点击「新建术语」，填写术语名称、术语描述（均必填）。
2
选择关联数据源（必填）。
3
选择关联数据表：全部数据表 或 勾选部分数据表。
4
点击「确认」保存。
同步机制
- ⚡ 同步：把技能配置提交给 AI，同步成功后新技能在对话中立即生效。
- ✅ 批量同步：对所有技能一次性同步，自动轮询直到完成。
其他操作
- 🔘 状态开关：启用/停用技能。
- ✏️ 编辑 / 🗑️ 删除 / 批量删除。
技能配置
术语名称尽量简洁、贴近业务叫法，利于 AI 命中。技能描述建议写明查询用途和数据范围。
05
图表项目
统一管理 AI 生成的图表，支持类型切换、定时刷新、分享、迁移。
新建项目与添加图表
- 新建项目：左侧「新建项目」，填写项目名。
- 添加图表：在「易码AI」对话中把图表「保存到图表项目」。
- 左侧支持搜索项目、点击切换；项目可删除。
图表卡片操作
- 🔄 切换图表类型：柱状图 / 折线图 / 饼图 / 表格。
- ⏱️ 定时刷新配置：设置每天/每周/每月/自定义频率（自定义 ≥5分钟），可「立即刷新」。
- 🔗 分享给成员：单图表或「批量分享」，弹窗内可搜索成员姓名。
- 📦 迁移项目：单图表或「批量迁移」，选择目标项目。
- ⬇️ 导出：按当前视图导出 —— 图表存 PNG（带标题），表格存 Excel。
- 🗑️ 删除：二次确认。
状态与更新日志
- 卡片底部圆点：🟢 成功 / 🔴 失败 / ⚪ 未刷新；右侧显示下次刷新时间。
- 顶部「更新日志」抽屉查看每次刷新记录（状态、时间、错误原因）。
- 分享/迁移后的图表会显示「分享者：xxx」。
图表项目
06
成员管理
管理员创建成员账号，并可为其分配数据权限。
新增成员
1
点击「添加新成员」。
2
填写 姓名、账号（编辑时不可改）、密码（≥5位）。
3
确认创建。
授权
- 列表点「授权」→ 勾选权限规则组 → 保存。
- 「已分配权限」列显示绑定情况。
其他
- 编辑（可改姓名、密码留空不改）、删除（二次确认）。
- 「成员后台」按钮：跳转成员端登录页。
成员管理
07
部门管理
部门用来划分成员归属。它影响两件事：成员列表按部门归类，以及技能授权按部门分配。
新增部门
1
点「新增」，填写部门名称（必填）和备注。
2
保存后出现在列表中，在「成员管理」新增成员时就能选到它。
字段说明
| 列 | 说明 |
|---|---|
| 部门编号 | 系统自动生成 |
| 部门名称 | 建议按实际组织结构命名（如「华东区」「仓储部」） |
| 备注 | 选填 |
| 创建时间 | 系统自动记录 |
删除部门
- 删除前会检查：部门下还有成员时不允许删除，先把成员改到别的部门。
- 删除后，之前授权给这个部门的技能会同时失效。
部门管理
部门不是必填项。如果只有一套人马、不需要分级管理，可以一个部门都不建，成员直接挂空部门。
08
权限配置
通过"权限规则组"限制成员可查看的数据范围（行级 + 列级）。
新建规则组
1
点击「添加规则组」，填写规则组名称。
2
点击「添加规则」，选择 行权限 或 列权限。
3
配置完成后「完成创建」。
行权限配置
- 规则名称 → 选数据源 → 选数据表 → 配置条件树。
- 运算符：等于、不等于、大于、大于等于、小于、小于等于、包含 LIKE、不包含 NOT LIKE、属于 IN、不属于 NOT IN、为空 IS NULL、不为空 IS NOT NULL。
- 支持「+ 添加条件」「+ 添加关系(AND/OR)」构造多层条件树。
列权限配置
- 规则名称 → 数据源 → 数据表 → 字段列表中用开关控制是否可见。
- 支持搜索字段。
规则组本身不直接绑用户，需在「成员管理-授权」中把规则组分配给成员才生效。
权限配置
09
技能授权管理
「技能授权」决定哪些部门的成员能用哪个技能。技能本身跑在 AI 侧的独立 agent 上，这里只做"谁能看见、谁能用"的控制。
授权方式
1
列表里每一行是一个技能 agent，显示 Agent ID / 名称 / 模型 / 已授权部门。
2
点该行的「授权部门」，勾选允许使用的部门（可多选）。
3
保存后立即生效：对应部门的成员在客户端「技能配置」里就能看到它。
字段说明
| 列 | 说明 |
|---|---|
| Agent ID | AI 侧 agent 的标识，形如 user_10 |
| 名称 | 技能的展示名称 |
| 模型 | 该 agent 使用的模型 |
| 授权部门 | 已授权的部门列表；为空表示没有任何成员能看到这个技能 |
技能授权管理（含授权部门弹窗）
未授权的部门，成员在客户端看不到该技能 —— 即使技能本身配置完全正常。排查"成员看不到技能"时，先看这里。
10
智能体设定
把业务口径直接写给 AI。比如「时间字段一律用 s_time」「单子指订单表」，写在这里之后 AI 每次回答都会遵守，不需要改代码或配技能。
两层规则
| 层级 | 适用范围 | 谁能改 |
|---|---|---|
| 通用规则 | 该账号下所有成员提问时都生效 | 管理端 |
| 成员专属规则 | 只有该成员提问时生效 | 管理端 + 该成员本人 |
两者冲突时成员专属规则优先：同一件事两边都写了，按成员自己那份来。
新增 / 编辑 / 删除
1
新增：点「新增规则」→ 行内输入 → 回车保存，立刻多一条。
2
编辑：点该行「编辑」→ 变成输入框 → 改完回车保存。
3
删除：点「删除」→ 二次确认。
每条操作即时保存，没有总的"保存"按钮，也不会出现"改了没存"的情况。
写规则的建议
- 一条规则只讲一件事，别把好几个口径塞进一句。
- 写清楚「什么情况 → 用什么」：「问销售额时，默认用 pay_time 而不是 create_time」。
- 术语类的写等式：「单子 = 订单表 evt_ckorder」。
更新日志
点右上角「更新日志」，右侧滑出面板，能看到每次操作谁改的、什么时候、新增或删除了哪一行。
智能体设定（通用规则 + 成员规则分组）
规则写进 AI 的提示词文件，保存后下一次提问才生效。已经开始的对话不会中途改变。
11
小易助手
创建可嵌入第三方网站的 AI 对话助手，服务外部用户。
新建小助手
1
点「新建小助手」，填写应用名称、应用描述。
2
跨域设置：填嵌入的第三方地址，多个用分号分隔，必须 http(s):// 开头。
3
确认创建，得到小助手 ID。
嵌入代码
卡片点「嵌入代码」，复制 HTML/JS，粘贴到目标网站 <body> 前。
显示设置
- 主题配色：自定义主题色、头部文本颜色。
- 图片：应用 Logo（建议 32×32）、浮窗入口图标（JPG/PNG/SVG，≤10MB）。
- 位置：可拖拽；X/Y 偏移（右侧/左侧、底部/顶部 + px）。
- 欢迎语：欢迎语文本（≤30字）、欢迎语描述（≤200字）。
- 弹窗：宽度 300-600px、高度 400-800px、字号 12-20px。
- 支持「恢复默认」、右侧实时预览。
小易助手
12
SQL 示例库
维护 AI 生成图表的参考 SQL，让 AI 写 SQL 更准确。
- 新增示例：填写问题描述（必填）、示例 SQL（必填）、关联数据源（可选）。
- 编辑 / 删除 / 批量删除、状态开关、按问题描述搜索。
13
常见问题
Q1 · 易码AI 提示"请先选择数据源"？▾
需先在右上角选择数据源；若无可用数据源，需先在本页「配置数据源」创建。
Q2 · AI 没调用我配置的技能？▾
技能需「同步」成功后才生效；确认已启用且关联正确的数据源/表。
Q3 · 定时任务没跑/没看到日志？▾
执行结果轮询回传，日志可能延迟几分钟；先点「同步」，再查看「日志」。
Q4 · 图表刷新失败？▾
确认图表保存时带生成 SQL；检查数据源连接；查看「更新日志」错误原因。
Q5 · 测试连接失败？▾
检查 host/端口/账号密码是否正确、数据库服务是否可达、账号是否有权限。
Q6 · 成员登录提示账号或密码错误？▾
确认成员已在「成员管理」创建，密码忘记可在此重置。
Q7 · 新建数据源点了确定，要等好几秒？▾
正常现象。保存后需要把数据源同步到 AI 服务（写入 MCP 配置并重载），大约 6~10 秒。这期间请勿关闭页面。同步完成后该数据源才能真正被 AI 查询。
Q8 · 成员说"看不到某个技能"？▾
先检查「技能授权管理」里该技能的授权部门是否包含这个成员所在的部门。未授权的部门，成员在客户端看不到该技能，即使技能本身配置正常。
Q9 · 页面能打开，但登录提示接口 404？▾
服务器的 nginx 里
/prod-api/ 代理配置丢失（在宝塔申请 SSL 后最常见）。需要运维在 extension 目录补回 proxy.conf 并 reload。建议把代理配置都放在 extension 目录，避免被面板重写覆盖。
