用户与管理员操作指南
/
Enterprise Brain · User Guide

完整控制台
帮助手册

从第一次登录,到自然语言问数、本体编排、知识库管理与系统权限配置。以真实页面为依据,按任务逐步操作。

完整控制台管理员视角v3.35离线单文件

适合读者:业务人员、数据分析人员、租户管理员和系统管理员。普通用户可从第 3 章开始;需要配置数据源、权限或第三方集成时,再阅读后续管理章节。

默认入口:http://localhost:9899截图日期:2026-11-22界面语言:中文

2.1 登录与租户选择

  1. 打开控制台在浏览器访问管理员提供的地址。本机开发环境通常为 http://localhost:9899。
  2. 输入分配的账号和密码多用户模式下需要用户名和密码。手册不包含任何可用账号凭据,请使用本企业分配的账户。
  3. 按需选择租户若同名账号在多个租户中均通过验证,页面会出现租户选择框。选择本次要工作的租户后再次提交。
  4. 进入 AIP TALK登录成功后默认打开 AIP TALK。若打开的是带 #view=... 的分享链接,则优先进入链接指定视图。
图 1 · 多用户登录页。截图时未填写任何凭据;请勿在共享截图、工单或聊天中展示真实密码。

2.2 页面区域与菜单差异

左侧导航

按“对话、管理、Enterprise AIP Ontology、系统管理、监控、洞察分析”分组。点击组名可展开或收起,点击条目切换视图。

顶部与头像菜单

顶部显示当前位置、语言和主题入口。右上角头像菜单用于个人中心、退出登录,以及特定场景下的租户/代运维切换。

为什么我的菜单比截图少?本手册使用系统管理员视角。平台会按角色、租户和授权动态隐藏菜单;数据源、知识库、字典和会话也会按租户隔离。菜单少并不代表功能被删除。
01

伙伴演示 Fast Start

面向合作伙伴:约 30 分钟在同一账户下搭好一个可演示的「企业 AI 大脑」——接入数据源、用数据字典对齐业务语义、按需配置业务规则,然后在 AIP TALK 中完成一场高质量的客户演示。

① 接入数据源 ≈5 分钟 ② 字典智能理解 ≈10 分钟 ③ 业务规则(可选)≈5 分钟 ④ AIP TALK 演示 ≈10 分钟

1.1 演示准备

  1. 确认演示环境与账号登录 seb.ai-soda.com(演示账号请联系系统管理员获取);本地化部署环境通常为 http://localhost:9899。
  2. 记住两个演示小技巧左上角折叠按钮收起侧边栏后,界面不出现任何品牌信息,适合对客户投屏;右上角按钮一键切换深色/浅色风格,方便不同光线环境阅读。
  3. 一个账户 = 多个客户的演示工作台在同一账户下为每个潜在客户各接入一套数据源(如商用车 fleet-vehicle、智慧园区 yunshu-os、注塑厂 CRM007/ERP007/MES007),演示时按客户切换,互不干扰。
图 2 · 演示界面两个小技巧。标注 1 为侧边栏折叠按钮(收起后不显示任何品牌信息);标注 2 为深色/浅色风格切换。

1.2 第一步 · 接入演示数据源(约 5 分钟)

  1. 新建数据源进入左侧「数据查询」,点击「新建数据源」,选择类型(演示库多为 PostgreSQL),填写主机、端口、库名与账号,保存并测试连接。
  2. 按客户命名建议「客户名 + 业务场景」,例如 fleet-vehicle(商用车)、yunshu-os(智慧园区)。名字就是稍后在 AIP TALK 里切换上下文的“口令”。
  3. 为每个潜在客户各建一套多个演示客户的数据源可以挂在同一账户下,列表一目了然(图 3),随演示安排随时增删。
图 3 · 同一账户下的多套演示数据源。每个潜在客户一套,商用车、园区、注塑厂(CRM/ERP/MES)可任意组合。
图 4 · 新建数据源对话框。以商用车 PostgreSQL 库为例:填好连接参数后先测试连接再保存。详细字段说明见 5.1 创建数据源。

1.3 第二步 · 数据字典智能理解(约 10 分钟,演示质量的关键)

为什么必做:智能理解让 AI 智能体精准对齐业务字段口径(字段含义、同义词、枚举值),演示时问数命中率与答案可读性会显著提升。建议在每套演示数据源上都跑一遍。

  1. 打开「数据字典」并选择数据源在页面右上角切换到刚接入的演示数据源。
  2. 点击「智能理解」并设置表数量默认扫描 30 张表;表多的库(如 yunshu-os 数百张)把上限调大(最大 200,超出可分批运行)。
  3. 全选并确认入库在结果预览中勾选全部候选(默认已勾选高置信度条目),点击「确认入库」。
  4. 微调低置信度条目红色低置信度条目不默认勾选,建议逐条核对、修正术语描述后单独入库。
图 5 · 智能理解启动对话框。表数量上限默认 30,表多的演示库按需调大。
图 6 · 智能理解结果预览。绿/黄/红置信度徽章一目了然,全选后点击「确认入库」。更多能力见 8.2 智能理解与 Excel 导入导出。

1.4 第三步 · 业务规则表达(可选,约 5 分钟)

用自然语言定义业务规则:「什么是重大事故」「回款逾期怎么算」这类口径,可在「本体编排」中用自然语言表达,由本体推理引擎在问数时自动套用。「本体编排 → Fast Start」页签内置了完整参考例子,照着写即可。

演示策略:时间紧可以跳过本步;当客户问起“业务规则怎么表达”时,现场打开本体编排的 Fast Start 页签展示,效果同样到位。
图 7 · 本体编排 Fast Start 页签。三步指引与验证闭环卡,演示业务规则表达能力的入口。进阶用法见 7.1 Ontology Copilot。

1.5 第四步 · AIP TALK 演示对话(约 10 分钟)

演示节奏:先一句话锁定数据源上下文,再按「图表 → 决策 → 报告」递进提问——先让数据说话,再问经营判断,最后沉淀成可带走的交付物。用例灵感可参考线上演示库 seb.ai-soda.com/demo。

  1. 先切换上下文直接说“切换到 fleet-vehicle 数据源”;不确定名字时先问“我有哪些数据源”。此后的整段对话都锁定在该数据源上下文,直到再次切换(图 8)。
  2. 图表类问题:先让数据说话趋势、占比、对比类问题直接要求出图,例如“统计各车辆状态的车辆数量,用柱状图展示”。结果带数据表、关键观察与图表,一屏说清(图 9)。
  3. 经营决策类问题:拿数据问判断接着数字追问经营决策,例如“故障车占比 17.4% 偏高,从经营决策角度应该优先排查哪些车队和车型?请给出处置建议”。AI 会给出带数据依据的决策建议(图 10);需要换视角时可结合 MOE多专家技能(第 10 章)。
  4. 报告类问题:沉淀成交付物最后收口:“把刚才的分析汇总成一份 PDF 报告,附上关键图表”;Word 文档同样可以一句话生成。演示现场直接产出可下载、可转发的成果(图 11)。
图 8 · 一句话切换数据源。明确说出“切换到 XXX 数据源”,后续问答全部在该上下文进行。
图 9 · 图表类答案。问数结果可直接出图,数据表与关键观察一屏呈现。更多对话技巧见 第 4 章 AIP TALK。
图 10 · 经营决策类答案。基于上一问的数据,AI 给出有优先级的排查路径与处置建议,并可继续追问下钻。
图 11 · 报告类答案。一句话把分析汇总为 PDF 报告(Word 文档同理),生成可下载的交付物。

1.6 演示前检查清单与资源

演示前五分钟

  • 演示账号可正常登录,目标数据源在列表中且连接正常
  • 数据字典已完成智能理解并入库,低置信条目已人工处理
  • 提前试跑 3-5 个演示问题,确认答案与图表符合预期

现场保障

03

十分钟快速上手

先完成一次可核验的自然语言问数,再逐步了解其他能力。

  1. 确认当前位置在左侧 Enterprise AIP Ontology 分组中选择 AIP TALK。页头显示“Skill 已激活”表示问数技能可用。
  2. 提出一个边界清楚的问题例如“park 数据源有多少张表?”或“本月各园区出租率是多少?按园区汇总”。尽量包含业务对象、时间范围和所需粒度。
  3. 发送并等待结果点击绿色发送按钮。复杂查询可能经历意图理解、数据源选择、SQL 生成与执行,请不要连续重复提交。
  4. 核对答案与依据阅读结果、图表和答案后的“数据来源/语义依据”。如果提示未实时取数或引用了已删除数据源,应先重新查询,不要把回答当作最新事实。
  5. 管理会话使用加号开始新会话;使用时钟图标打开历史记录;星标用于收藏,图钉用于决策复盘。
图 12 · AIP TALK 首页。标注 1 为历史记录,2 为问题输入框,3 为发送按钮;输入区左侧还提供新会话、清空和附件入口。

3.1 怎样把问题问清楚

不够明确更容易得到可用结果
看看销售情况查询 2026 年 9 月各产品销售额和销售量,按销售额降序排列。
哪个园区最好按最近一个月出租率对园区排名,并列出出租率和同比变化。
分析一下基于已选数据源,指出收入异常下降的 3 个项目,给出数据表和时间范围依据。
跨源问题也要说清关联键。例如“按客户编码关联 CRM 客户和 ERP 订单,统计每个客户的未回款金额”。如果系统缺少跨源映射,请先在 Ontology Copilot 中建立虚拟本体和映射。
图 13 · 一次真实的只读问数结果。问题限定“只回答表数量、不要提供连接信息”,适合安全演示;实际分析时应继续核对来源脚注。
04

AIP TALK

面向业务问题的多源检索、实时问数、知识问答与决策协作入口。

4.1 问数、追问与附件

  • 数据问题:直接描述业务目标和统计口径。系统可结合可用数据源、语义层和知识库选择执行路径。
  • 追问:同一会话中可继续说“换成按月趋势”“只保留前 10 个”“解释下降原因”。需要完全独立的上下文时,点击加号新建会话。
  • 附件:点击回形针选择文件。上传后先确认附件预览,再明确提出要摘要、提取、比较还是结合企业数据分析。
  • 语音:麦克风能力取决于当前模型和浏览器环境;不能使用时可直接输入文字。

4.2 历史、收藏与决策标记

入口用途使用建议
历史记录(时钟)恢复当前账户/租户下的历史会话。恢复后先核对数据源是否仍可用,避免沿用过期上下文。
我的收藏(星标)保留常用回答或重要结论。收藏不等于数据快照,引用前仍要核对时间。
决策复盘(图钉)把关键回答标记为决策依据,集中复盘。补充决策理由和后续结果,避免只保存结论。
清空(垃圾桶)清理当前显示/会话上下文。执行前确认不再需要当前内容。

4.3 如何判断答案是否可引用

数据来源与语义依据

页脚的来源块用于说明实际数据表、FAQ/知识库来源和本体映射。数据时间、指标质量信号或证据条出现时,也应一并核对。

诚实性提示

“本轮未实时取数”表示回答可能来自历史或既有上下文;红色已删数据源警示表示引用失效。这两类情况都应重新执行实时查询。

不要把流畅表述等同于事实。对外汇报前至少核对:问题口径、时间范围、数据来源、结果是否本轮实时产生,以及当前用户是否有权访问这些数据。

4.4 图表生成与文件导出

问答过程中可以随时穿插要求生成图表或导出文件:先问数、再出图、再把同一分析导出为报告,全部在同一个会话里连续完成,无需切换到其他工具。本节示例全部来自「商用车车队主动安全」演示库(10 个车队 / 322 辆车,2026 年上半年安全评分)的真实查询结果,图即对话中实际返回的图。

图表类型:可点名,也可交给系统自动匹配

直接说出想要的图(“画折线图”“用热力图”),或只描述分析目标,系统按数据形态自动选择。内置 10 类可视化意图:

意图适用场景典型图表
趋势 trend时间序列、月度或年度变化折线图、面积图
占比 proportion构成分析、份额拆解饼图、环形图、堆叠柱
排名 rankingTop N、排行榜、横向对比横向条形图
散点 scatter双变量相关性、分布散点图、气泡图
KPI kpi单指标概览、核心数字指标卡、大数字面板
漏斗 funnel转化链路、流程衰减漏斗图
瀑布 waterfall增减拆解、归因分析瀑布图
地图 map地理分布、区域对比分级设色地图
热力图 heatmap二维密度、时段×维度矩阵热力矩阵
森林图 forest效应值与置信区间、风险因素比较森林图

另支持多维度批量出图:说“一次生成多维度图表看板”,系统自动从结果中选取 3~5 个维度列生成一组网格布局的图表,适合做分析看板。

可以这样问(对话中随时穿插)

  • 折线图:“各车队月度平均安全评分的变化趋势,画折线图”
  • 对比图:“对比各车队近半年的平均安全评分,按分数排名”
  • 热力图:“生成车队×月份的安全评分热力图,看哪个车队哪个月最差”
  • 森林图:“分析超速、疲劳报警等因素对事故的影响,画成带置信区间的森林图”
  • 批量看板:“把这次查询结果按多个维度各出一张图”
图 14 · 折线图(趋势)示例。提问“各车队月度平均安全评分的变化趋势”,系统按趋势意图出图;图为演示库 322 辆车 2026 年上半年的真实月度均值。
图 15 · 对比图(排名)示例。“对比各车队近半年的平均安全评分”生成横向条形图,珠三角城配三队(77.8)领先、中原快运十队(72.1)垫底。
图 16 · 热力图示例。“车队×月份的安全评分热力图”输出 10×6 矩阵,颜色越深评分越高,一眼定位“哪个车队哪个月偏弱”。
图 17 · 森林图示例。对 322 辆车按风险因素分组计算事故效应值(ln OR):曾触发 AEB 自动制动的车辆置信区间整体位于参考线右侧,与事故关联最强;其余因素区间跨过参考线,关联不显著。森林图需要带效应值与置信区间的数据。

输出与导出格式

图表本身有 4 种输出形态;分析结论还可以进一步导出为文档或原始数据。文件生成后在回答中以下载卡片出现,刷新页面后仍可从历史会话中下载。

图表输出说明适用场景
PNG 图片静态高清图,默认格式报告插图、微信/邮件分享
ECharts 交互图表可缩放、可悬停查看数值的网页图表网页嵌入、在线看板
图表规格 spec结构化配置(JSON),可二次开发接入自有系统、定制渲染
文本报告 report图表 + 文字解读的组合快速生成分析简报
文件导出说明可以这样问
PDF固定版式,适合正式交付、打印归档“把刚才的分析汇总成一份 PDF 报告,附上关键图表”
Word(.docx)可编辑,适合需要二次修改的报告“把车队对比的结论导出成 Word 文档”
PPT(.pptx)演示文稿,适合汇报宣讲“做三页 PPT:结论页、趋势图、车队对比图”
CSV原始查询结果,可导入 Excel/WPS 继续处理点击结果表格上的「下载 CSV」,或直接说“把查询结果导出成 CSV”
图 18 · 同一分析导出的四种文件。图为本次真实生成的 PDF 首页、Word 内嵌图表页、PPT 图表页与 CSV 数据头几行的内容预览。

选择建议

  • 要放进汇报材料 → PPT,一页一个结论,配 KPI 卡片和表格
  • 要正式交付或归档 → PDF,版式固定不会跑版
  • 要同事继续改 → Word,表格和文字都可编辑
  • 要嵌到网页或系统里 → ECharts 交互图表
  • 要自己再算一遍 → CSV 导出原始数据
提示:图表语言跟随界面语言(中/英文界面出对应语言的图表);导出大结果集时 CSV 以查询实际返回行数为准;PDF/Word/PPT 由系统现场生成,内容与当次分析一致。

4.5 对话即交付:交互网页、专业报告与图文召回

除图表与文档导出外,AIP TALK 还能把同一段对话里的分析结果直接变成可分享的数字交付物:自包含交互网页、专业排版的 PPT/PDF/Word 报告、地理空间与统计图表组合页,以及综合结构化数据与知识库的图文混排回答。以下示例全部来自真实对话产物。

交互式网页看板:一句话生成,可发布分享

说「做一个可交互的分析看板」,系统会生成自包含的单文件网页:筛选器、KPI 卡片与多张联动图表齐备,双击即可离线打开,支持缩放、悬停明细与导出 PNG。点消息上的「发布」按钮,还能把页面变成带权限的分享地址,在「我的发布」中统一管理(发布与管理详见 4.6 节)。

图 19 · 交互式网页看板示例。一句「做一个因果链分析看板」生成的自包含网页:昼夜条件与救助局筛选器、6 张 KPI 卡与三张联动图表,可悬停看明细、导出 PNG,并可一键发布为带权限的分享页。
图 81 · 互动问答示例(上):问题与生成的交互页面。一句「把 Fresh Harvest 22 家门店画成一张可交互的绩效地图:气泡大小=年化销售额,颜色=坪效分档」,系统即生成图中的自包含网页——美国地图上 22 个气泡可滚轮缩放、拖拽平移、悬停查看门店明细,右侧栏汇总全网 KPI、坪效分档与末位五店榜单。
图 82 · 互动问答示例(下):对话中的答案。同一个问题在对话里的回答形态:顶部是「打开交互页面」链接与「发布」按钮——点开即图 81 的页面,点「发布」则变成带权限的分享链接(见 4.6 节);回答正文附视觉编码说明与区域格局解读,图文随会话持久化,可随时回看。

专业报告:PPT / PDF / Word 直接成稿

一句「把这次分析做成 PPT」即可产出主题式专业排版的成稿:封面、目录、章节页与图表页齐备,数据口径与当次分析一致;PDF、Word 同理。文件以卡片形式留在消息里,历史会话中仍可下载。

图 23 · 专业报告 PPT 示例(一)。「六大产业链图谱报告」成稿:深蓝主题封面、八节目录、企业规模条形图、产业链环节分布矩阵与五维能力雷达,直接可用于汇报。
图 24 · 专业报告 PPT 示例(二)。「2026 年度经营报告」成稿:统计区间、数据口径与核心 KPI 呈现在封面,内页含收入结构、现金流来源、招商去化等图表章节。

地理空间与统计图表:从经纬度到组合图页

数据里带经纬度时,一句「画分布图」即可输出地理热力聚类图(可缩放、可平移、图层可开关);森林图、气泡图、热力图等统计图还能组合成一页分析报告,悬停查看明细。

图 25 · 地理信息图表示例。107 起有坐标案件按 1°×1° 网格聚类出三大热点带,热力按遇险人数加权;地图支持滚轮缩放、拖拽平移与图层开关,页面完全离线自包含。
图 26 · 统计图表组合页示例。一次对话产出三联图:各险情类型获救率森林图(Wilson 95% 置信区间)、处置时长×获救率气泡图(气泡大小=案件数)、救助局×险情类型热力图,均可悬停查看明细。

图文召回:结构化数据 × 知识库联合作答

问题同时涉及业务数据与文档知识时,AIP TALK 会联合结构化数据源与知识库检索,给出图文并茂的回答:图片紧跟对应说明段落,页脚来源块注明出处(更多机制见 9.5 节)。

图 27 · 图文召回示例。询问病例资料时,回答从知识库召回牙齿照片、X 光片与面像照,并紧跟诊断与矫治说明混排呈现,图片随回答持久化。
提示:交付物语言跟随界面语言;交互网页与报告由系统现场生成,内容与当次分析一致;发布后的分享页沿用租户权限体系,接收人需有对应访问权限。

4.6 发布与「我的发布」:分享链接、筛选、模板与定时例行

4.5 节讲交互网页怎么「生成」,本节讲怎么「发出去」与「发出去之后」:点消息上的「发布」把页面变成带权限的分享链接(三档可见范围 × 快照/实时两种数据模式),已发布页面集中在侧栏「我的发布」统一管理。再往下是让看板「常用常新」的三件武器:给页面装上筛选器,让读者自己动手切数据;把好页面存为模板,换个参数反复跑;再设一个定时例行,让页面到点自动刷新——链接不变,打开永远是最新数据。

发布为链接:内部分享的三档可见范围

生成的交互网页不必只留在自己电脑里:点击消息上的「发布」按钮,即可把页面变成带权限的内部分享链接。发布对话框中填写标题(默认取页面文件名)与可选简介,选择可见范围和数据模式后完成发布;收到的同事在浏览器里直接打开,无需安装任何组件、无需找到原始会话。

图 20 · 发布入口。交互网页生成后,消息里会出现「打开交互页面」链接和「发布」按钮(红框处);链接本身可先本地预览,确认无误后再发布分享。
可见范围谁能打开适用场景
仅自己可见只有你自己能打开链接(租户管理员也无法查看内容)草稿沉淀、含敏感数据、暂不对外
同租户用户可见本租户内所有登录用户都能打开团队通报、部门级共享
指定用户可见仅名单内的本租户用户能打开小范围评审、按项目组分发
数据模式行为适用场景
快照(推荐)数据随页面冻结,打开即看、加载最快周报月报、归档留存、对外固定口径
实时访问者打开页面时按其本人权限重新查询数据库,数据常新;无权限的块显示占位常驻运营看板、需逐人落实数据权限的场景
图 21 · 发布对话框。标题自动取页面文件名(可改),简介可选;可见范围默认「仅自己可见」,数据模式默认「快照」——先小范围确认,再逐步放大分享面。
提示:已发布的页面集中在侧栏「我的发布」统一管理(见下节);链接沿用租户权限体系,没有权限的访问者打开会被拒绝。
图 22 · 发布后的页面(快照模式)。以快照发布的正畸医院回款看板:左上角「快照」徽章标记数据冻结时点,机构、治疗阶段、费用类型等筛选器即点即滤,KPI 卡与多张图表联动——接收人打开即看,无需等待重新取数。
图 80 · 发布后的页面(实时模式)。以实时模式发布的超市销售看板:左上角「Live」徽章旁标注数据时点——读者打开页面即按其本人权限重新取数,也可随时点右上角「Refresh data」手动刷新;筛选器、KPI 卡、图表与明细表的交互和快照页完全一致。

「我的发布」:已发布页面的统一管理台

左侧导航「我的发布」集中列出你发布的每一个页面:随时调整可见范围、复制分享链接,或取消发布(链接即刻失效,原始会话与页面文件不受影响);含取数规格的页面行上还有「存为模板」「定时例行」入口(见下两节),顶部「模板库」页签集中管理已存模板。链接沿用租户权限体系,没有权限的访问者打开会被拒绝。

图 30 · 「我的发布」管理视图。「存为模板」「定时例行」入口在页面行的操作区(含取数规格的页面才有);顶部「模板库」页签集中管理已存模板。

动态筛选:下拉、多选、搜索、区间与级联

生成页面时直接说出想要的筛选(「带区域下拉筛选、金额区间筛选」),系统会按数据特征自动选型;筛选器作用于页面内所有含该列的图表与表格,多个筛选同时生效时按「并且」组合。

控件形态适用列交互说明
按钮组(候选 ≤8 个)区域、类目等离散列点选即过滤,再点「全部」复位
下拉单选(候选 >8 个)客户、城市等长清单展开下拉选择一个值
下拉多选需要同时对比多个值勾选任意组合(IN 语义),清空恢复全部
文本搜索单号、名称、备注输入关键词,包含匹配(不区分大小写)
数值区间金额、数量填最小/最大值,单边可留空
日期区间下单日期、发生时间起止双选,单边可留空

级联筛选(如「区域 → 城市」):生成时说「区域和城市做级联筛选」即可。父筛选选中后,子筛选候选自动收窄为父值下实际存在的取值;父筛选变化时,子筛选自动重置为「全部」,避免选出不可能的组合。

图 28 · 动态筛选看板示例。一句话「做一个带筛选的销售看板」即可配齐六种控件:区域下拉单选、城市级联下拉、渠道下拉多选、金额与日期区间、单号关键词搜索;筛选即刻联动下方图表与明细表。
图 29 · 级联筛选。区域选中「华东」后,城市下拉的候选自动收窄为华东实际存在的城市(上海/杭州/南京);改选其他区域时城市自动重置,候选随之更新。
快照与实时:快照模式下筛选完全在浏览器内完成(离线可用、响应即时);实时模式下,筛选变化会以访问者本人身份把条件下推到数据库重新查询(行级权限随人生效)。两种模式的页面写法完全一致,无需额外配置。

存为模板:把好页面固化下来反复用

一张调好的看板不必每次从头再生成。「存为模板」把页面的结构、筛选器与取数口径固化成可复用配方:

  1. 存:「我的发布」里点页面行的「存为模板」,起个好记的名字(如「销售周报」);
  2. 管:模板集中收进「模板库」页签,可随时查看或删除;
  3. 用:对话里说「用销售周报模板跑一份 11 月的」——系统取出模板里冻结的查询,只换你指定的时间/区域等参数,以你本人的权限重新取数,生成一张全新页面。
图 31 · 存为模板对话框。名称默认取页面标题(可改),说明可选;保存后对话里说「用 XX 模板跑一份…」即可按名引用。
图 32 · 模板库页签。集中列出我的模板:名称、说明与更新时间;删除模板不影响已生成的页面。
提示:模板是「参数化的页面配方」,不是页面本身;换参数重跑时权限与行级过滤随当前用户生效,查不到数据会如实说明,绝不编造。

定时例行刷新:链接不变,数据常新

常驻看板不必每次手工重发。给页面设一个 cron 例行,到点由服务端按发布时冻结的查询自动重查重建(版本 +1):链接不变,读者打开即最新数据。常用写法:

刷新频率cron 表达式(分 时 日 月 周)
每天 08:000 8 * * *
每小时整点0 * * * *
每周一 09:3030 9 * * 1
每月 1 日 07:000 7 1 * *
  • 立即刷新一次:不等下个时点,对话框里点「立即刷新一次」马上重建(版本 +1);
  • 暂停与取消:取消勾选「启用例行刷新」可暂停(保留设置),「取消例行」则彻底移除;
  • 对话同款:也可以直接说「这个报表每天早上 8 点自动刷新」「把《销售看板》刷新一下」,效果相同。

刷新后推送:还可以让结果主动找你——对话里说「每天早上 8 点刷新这个报表并把链接发到飞书」,系统会同时建好例行刷新与同时间点的消息推送(内容带页面链接),到点先看推送、点链接看新数据。

图 33 · 定时例行对话框。显示当前例行与下次执行时间;填 cron、勾选启用即完成设置,也可随时点「立即刷新一次」验证效果。
权限与失败兜底:例行刷新以页面所有者身份重查(行级权限随行);若数据源不可用或所有者权限变化导致取数失败,系统会中止本次刷新并保留上一个正常版本,绝不发布半成品——排查数据源后重新设置,或点「立即刷新一次」验证。

4.7 视觉理解:手绘草图就是需求(Vision Understanding)

纸上画的一张布局草图、拍下来的一张报表照片、贴上来的 PPT 大纲,都可以直接当作需求发给 AIP TALK。视觉理解会读懂你的整体意图、布局想法与联动关系,分钟级生成可发布的成品:互动式网页、特定形态图表,甚至 PPT 大纲成稿。

三步从草图到成品

  1. 画:把想法画成分区草图——标题放哪、筛选区在哪、哪个区块是图哪个是表,写清区块名字即可,不必工整;
  2. 发:点输入框左侧的回形针上传草图照片/截图,再补一句要什么,例如「识别这张手绘图表,按它的布局生成一个交互页面」;
  3. 收:系统理解布局与联动后自动取数生成页面。在对话里打开检查,不满意直接追问调整(「左边换成饼图」「表格按应收降序」);满意后点消息上的「发布」固化成可分享的链接(发布与管理见 4.6 节)。
图 73 · 把手绘草图发给 AIP TALK。点输入框左侧回形针上传草图,再说一句要什么——草图就是需求,无需整理成正式文档。
图 74 · 按草图生成的交互看板。顶部筛选区、左侧「图 + 表」、右侧图——布局与草图一一对应;数据来自已接入的数据源,筛选即刻联动。

它能读懂什么:意图、布局与联动

草图里的信息系统怎么理解
标题与用途(「回款看板」「销售周报」)意图:要做什么分析、给谁看,据此选定数据范围与指标口径
分区与摆放(顶部筛选条、左图右表、KPI 行)布局:每个区块的类型(筛选器 / 图表 / 表格 / 指标卡)与位置
箭头与标注(「这里筛上面的图」)联动:筛选器驱动哪些图表与表格,点击 / 筛选如何联动

除了手绘草图,这些形态同样可以作为需求输入:

  • 报表照片 / 截图:拍一张别人的报表,按你的数据生成同款交互页面;
  • PPT 大纲:贴出大纲或画出演示结构,生成 PPT 大纲成稿或报告初稿;
  • 特定形态图表:描述或画出想要的图表形态(如漏斗、桑基、地图热力),按形态出图。
边界提示:只有当你明确要求生成(网页 / 看板 / 大屏 / PPT 等措辞)时系统才产出成品,普通问答仍默认图表回复;取数与指标口径来自你已接入的数据源与数据字典,权限全程生效——你无权查看的数据不会出现在生成结果里;草图分区越清晰、标题越明确,理解越准。

4.8 智能体编排与对话蒸馏:把团队口径沉淀成可复用的专家

左侧导航「智能体编排」是协作智能体的定义中心。在 AIP TALK 输入框 @智能体名 即可把任务显式委派给它(如 @ad-acos-analyst);在 AIP TALK 设置里开启「自动委派」后,主智能体也会按需调用。每个协作智能体独立运行(自己的工具白名单与预算帽),并共享主会话的租户与身份——权限边界与发起人完全一致。页面顶部还有「功能引导」按钮,随时可重放七步导览。

图 75 · 智能体编排页总览。上方为定义卡片:内置「数据侦探」「文档撰写」与自定义「广告ACoS分析师」(带「绑定 2 源」绿点徽章与近 30 天委派成效);中部为蒸馏草稿区(「广告ACoS分析」等待审阅、「广告指标周报口径」已确认);下方为委派记录表。

定义一个智能体:名称、工具、预算帽、提示词

字段说明建议
@ 唤醒名小写字母 / 数字 / 短横线;委派时在输入框 @它唤起用业务域命名,如 ad-acos-analyst
显示名(中 / 英)卡片、chips 与委派记录中展示的名称非中文界面自动显示英文名;未填则回落中文名(对话蒸馏出的草稿会自动补齐中英文双名)
工具白名单运行时还会与主智能体的可用工具取交集问数专员勾 enterprise_ai_query 即可,宁少勿多
预算帽最大步数 / Tokens / 超时秒数三件套,到顶即停默认 8 步 / 30,000 tok / 120s 起步,按需再调
系统提示词人格与纪律:数据口径、呈现要求、工作流程、边界禁区团队口头约定直接写进去;确认口径建议同时登记数据字典
权限边界:仅租户管理员可创建 / 修改 / 删除定义(普通用户在编排页只读浏览,但仍可在 AIP TALK 中 @ 使用);内置样板只读,可「另存为副本」后改造。保存即生效,AIP TALK 下一次委派使用新定义。

绑定数据源:把「专业范围」钉死在工具层

编辑器中的「绑定数据源」多选决定智能体能查哪些数据:不选 = 通用智能体(可查任意源);勾选后委派执行时,企业问数工具被限定在这批源内——越界查询会被工具层引导性拒绝,智能体据此自我纠正,而不是报错中断。

图 76 · 编辑器中的「绑定数据源」多选。图中「广告ACoS分析师」勾选了 DreameSASC 与 SBSP002 两个广告数据源——保存后,该智能体被委派时只许查询这两个源。
情形行为
部分绑定源失效(被删除)保存时给出黄色告警但不拦截;卡片绑定徽章变红点,悬停查看失效明细,在编辑器改绑后恢复绿点
绑定源全部失效委派直接收到引导答复「绑定的数据源已失效,请联系管理员重新绑定」——不占用 LLM 调用,审计如实记为未达成
只绑定一个源查询时省略 source_id 会自动回填唯一存活源;多源时缺省会引导补选
跨租户数据源保存即拒绝(400)——安全边界硬拦截,不进入定义

对话蒸馏:从一段对话沉淀出专家

  1. 发起:在 AIP TALK 打开一段团队反复校准过口径的会话(≥10 条用户消息),会话菜单点「沉淀为智能体」——任何会话成员都可发起;当系统检测到会话里积累了足够多的纠正信号,还会在会话顶部给出「生成草稿 / 不再提示」的轻提示(AIP TALK 设置中可关闭)。
  2. 提炼:系统从对话中抽取被明确陈述且未被后续推翻的口径 / 呈现 / 流程纠正,每条规则都标注来源消息(血缘可回溯),并自动补齐中英文显示名与职责描述,组装成草稿——草稿永不自动生效。草稿生成后,源会话尾部会出现一条系统通知(📌 已沉淀出草稿,待管理员审阅),方便发起人跟进。
  3. 人审:租户管理员在编排页草稿区点「审阅」,逐条核对规则与来源(如图 77)——每条规则的来源旁都有「查看上下文」按钮,一键跳回源会话对应消息并高亮定位;组装好的人格提示词确认前可直接修改。
  4. 确认 / 废弃:「确认创建」后智能体立刻出现在 chips 与 @ 补全中,可被正常委派;「废弃」丢弃草稿。草稿 7 天未处理自动过期清理。
图 77 · 蒸馏草稿审阅弹层。系统从 23 条消息、21 条信号的广告讨论会话中提炼出 2 条规则:数据口径「ACoS = 广告花费 ÷ 广告销售额」(来源 msg 25)与边界禁区「数据源缺月时如实说明覆盖范围、不得臆造数据」(来源 msg 6);每条来源行尾都有「查看上下文」按钮可跳回源会话对应消息;下方为确认前可改的组装人格提示词。
口径归属:可结构化的指标口径(如 ACoS 公式)建议同时确认进数据字典——蒸馏规则引用字典而非复制定义,单一事实源不漂移;纯呈现要求(保留两位小数、超标标红)与流程约定(先查近 7 天再环比)才写进智能体提示词。

增量再蒸馏:口径随业务演进

智能体上线后,新会话里又会积累新纠正。点击自定义智能体卡片上的旋转按钮(增量再蒸馏),粘贴包含新纠正的 AIP TALK 会话 ID(会话顶栏可复制,须 ≥10 条用户消息且含新信号),系统把新信号与现有定义比对,生成规则级 diff 草稿:

  • 新增(绿):现有定义没有的规则,合并进对应小节;
  • 修订(琥珀):替换现有表述(旧文划线 → 新文);
  • 作废(红):删除已被后续对话推翻的规则。

审阅三栏 diff(每条操作同样可回溯来源消息)后点「确认更新」,定义原地升级——无需重建智能体,团队口径越用越准。下方预览区可看到合并后的完整提示词,确认前仍可改。

图 78 · 增量再蒸馏审阅。目标 @ad-acos-analyst:从新会话(13 条消息、10 条信号)提炼出 3 条新增呈现 / 工作方式规则(ACoS 排名升序、按周汇总并给出环比、周报默认按 campaign 分组),下方预览合并后的完整提示词,「确认更新」后生效。

成效回收与委派记录

每张卡片页脚展示近 30 天委派成效:@次数 · 成功率 · 平均 Tokens(0 次委派不显示)。数据来自委派审计聚合;因绑定源失效而未达成的委派如实计入失败,不美化。页面底部的委派记录表逐条列出时间、用户、来源(@ 显式 / 自动委派)、任务摘要、Tokens / 用时与结果状态,分页可回溯——审计追溯与卡片成效统计同源。由对话蒸馏确认创建的智能体,页脚还多一枚「源会话纠正密度」芯片:以首次确认为界,对比前后 14 天窗口内源会话每百条用户消息中的纠正信号占比(如 50%→20%),让蒸馏带来的口径收敛可量化。

4.9 我的仪表盘:拖拽搭建个人驾驶舱

左侧导航「我的发布」之下、「MOE多专家技能」之上的独立入口(默认开放)。与「驾驶舱」的 Pack 模板不同:Pack 是行业模板只读消费,「我的仪表盘」是你的个人画布——问一句生成组件、自由拖拽排版、按需发布共享。页面头部的「功能引导」按钮可重放六步导览。

新建与四种组件来源

新建空白板进入编辑态后,「添加组件」有四条路:向导建组件(选数据源 → 选图表形式,AI 按表结构合成问句并出真实取数预览,确认后上板)、问一句(自然语言提问,真实取数预览、确认后上板,预览不落库)、组件库(从现有 Pack 驾驶舱拷贝现成组件)、空白组件(先选图型占位后配置)。图表形式共 11 种:KPI 卡 / 趋势 / 柱状 / 饼图 / 表格直显,「更多图表」折叠散点 / 气泡 / 热力 / 雷达 / 漏斗 / 瀑布。画布为 12 列栅格:拖左上握把移动、拖右下角缩放,组件设置可改标题 / 图型 / 问句 / 跨度(1-12 列);组件标题自动从问句精炼提炼,每板上限 30 个组件。

图 79 · 「添加组件」四个入口。向导建组件按「选数据源 → 选图表形式 → AI 生成预览」三步上板;问一句、组件库与空白组件覆盖快捷与复用场景。

编辑与保存(乐观锁)

改动都在草稿上进行——未保存的组件显示「待保存」占位、不取数;点「保存」才写入并触发数据链路。保存带乐观锁:他人先保存过会弹版本冲突(409),可选择「查看最新」或「用当前画布覆盖」。

对话挂板

在 AIP TALK 会话里鼠标悬停任意图表(ECharts / 图片 / KPI 卡),浮现「钉板」按钮——选择目标板(或就地新建)即可把该图连同问句、图型一起存入板底,并保留 chart:// 血缘。

发布、共享与嵌入

「发布」对话框可选可见性(仅自己 / 全租户 / 指定用户)与数据模式(实时 / 快照——快照为预留选项,执行语义将在后续版本提供),并自动生成嵌入链接供第三方系统 iframe 使用。组件取数沿用观看者自己的行级 / 敏感表权限(Guard 全链直通):共享板不会放大任何人的数据权限。

回收站

删除的板先进回收站,30 天内可随时还原(版本号继续单调递增);到期未还原的才物理清除。

05

数据源编排与问数

连接企业数据、检查 Schema、执行自然语言/SQL 查询并控制访问范围。

图 34 · 数据源编排首页。标注 1 创建数据源,2 选择已有数据源,3 输入查询;右侧为 Schema、ER 图和敏感表页签。

5.1 创建数据源

  1. 点击“创建数据源”选择 CSV/Excel 文件、关系型数据库、HTTP 远程 API 或飞书多维表格。
  2. 填写连接信息数据库需选择具体类型并填写主机、端口、库名和凭据;CSV/Excel/API 按页面提示提供文件或端点;飞书多维表格填写自建应用 App ID、App Secret 并粘贴表格链接。
  3. 测试并创建先确认连通性和字段解析,再提交。生产库优先使用只读账号和只读副本。
  4. 检查 Schema创建后选择数据源,核对表数量、字段类型和样例是否符合预期。
图 35 · 创建数据源对话框。手册仅展示空白表单,未提交任何新数据源,也未展示真实连接凭据。

数据源类型速查

类型需要准备适用与说明
CSV 文件、Excel 文件本地 CSV / Excel 文件上传后即可查询,适合一次性或样例数据分析。超过 500MB 会提示确认,确认后以分块方式上传(自动重试、可断点续传)。
关系型数据库主机、端口、库名、账号实时连接查询;生产库优先只读账号和只读副本。
HTTP 远程(API Endpoint)Endpoint 地址与认证方式SQL 经 URL 参数发送到远程服务执行,适合已有查询网关的系统。
飞书多维表格自建应用 App ID / App Secret、多维表格链接经飞书开放平台把表格快照同步进来查询,适合业务团队日常维护在多维表格中的台账与问卷。
Business Central(ERP)Entra 应用(Tenant ID / Client ID / Client Secret)快照同步客户、供应商、物料、发票、总账等标准实体,带水位增量与断点续传;适合把 BC 作为经营数据底座接入问数。
Salesforce(CRM)集成用户名、Consumer Key、RSA 私钥(JWT Bearer)快照同步标准对象与自定义对象(__c 需在对象白名单显式纳入);SystemModstamp 增量与删除对账,适合销售管道与客户分析。
SAP HANA(语义视图直连)HANA 主机/只读账号 + 语义视图白名单实时 SQL 直连客户侧预建的只读语义视图,不落地快照;适合私有化 S/4HANA,白名单之外一律拒绝访问。
SAP OData(快照)Gateway Base URL + 通信用户V2/V4 实体集快照同步,带回看窗与水位增量;适合 S/4 Cloud、OP Gateway 与 ES5 演示系统。

飞书多维表格:接入步骤与边界

  1. 准备自建应用在飞书开放平台创建企业自建应用,拿到 App ID 与 App Secret,并为应用开通「多维表格」(bitable)相关权限。
  2. 把应用加为表格协作者这是最容易漏掉的一步:在多维表格右上角「分享」中把应用添加为协作者(至少「可阅读」),否则接口一律返回无权限。
  3. 填写三项并测试在创建对话框选择「飞书多维表格」,填入 App ID、App Secret,粘贴浏览器地址栏中的多维表格链接,先测试连接再创建。
  4. 理解链接的表范围链接带 table= 参数时只同步该数据表;删除链接中 ? 之后的部分,则同步整个多维表格的全部数据表。
  5. 了解快照与刷新多维表格以快照方式接入:创建时全量拉取,查询时缓存到期自动重拉(默认 5 分钟),也可随时点击「刷新」手动同步;单表默认最多同步 2 万行。
图 36 · 飞书多维表格面板。图中为空白表单,未提交任何真实应用凭据;App Secret 在服务端加密存储,列表与详情页均打码显示。
边界说明:暂不支持飞书知识库(wiki)形态的多维表格链接,请使用 base 形态链接;海外版 Lark 需在高级参数中指定国际版域名。查询中文表名时直接书写即可,无需引号。

5.2 自然语言、SQL 与跨源查询

  • 自然语言模式:输入业务问题,由系统选择表、生成并校验 SQL,再返回结果和解释。
  • SQL 模式:适合明确知道表结构的用户。仍应遵守只读限制、敏感表策略、字段/行级权限和执行超时。
  • 跨源联合查询:基于虚拟本体和跨源映射拆解问题;“万能跨域”用于多数据源联合场景。先确认关联键和去重口径,防止笛卡尔积。
图 37 · 选择数据源后的工作区。标注 1 当前数据源列表,2 查询模式切换,3 Schema/ER 图/敏感表页签。

5.3 表结构与 ER 图

表结构用于核对字段和类型;ER 图用于查看主外键和推断关系,可缩放、适应屏幕、全屏和显示图例。跨表查询前,应先检查关联方向,避免把推断关系当成已确认的业务主外键。

图 38 · ER 图。实线/虚线及图例用于区分检测到的外键和推断关系;跨表查询前应先检查关联方向。

5.4 敏感表是什么:给数据源里的重点表再加一道门

数据源权限通常回答的是“这个人能不能进入这个数据库”,而敏感表设置进一步回答:“进来以后,哪些表仍然不能随便查?”它适合薪酬、财务、客户、合同、经营成本等需要单独控制的数据表。

没有配置敏感表

用户只要能访问数据源并执行查询,就可能查询其中的业务表。适合全部表都可共享的场景。

配置敏感表之后

同一张普通表仍可查,但查询一旦触及受保护的表,系统会再核对当前用户身份;不符合策略就阻断整个查询。

可以把它理解成“表级门禁”。它不是把数据加密,也不是只遮住某几列,而是在 SebAgent 的自然语言问数、SQL 执行和 AIP TALK 问数链路中,按“租户 + 数据源 + 表 + 当前身份”决定是否放行。

入口位于 数据源编排 → 选择数据源 → 右侧 Schema → 敏感表。配置需要租户管理员权限;普通用户不会因为在页面上看到表名,就自动获得读取表数据的权限。

图 39 · 敏感表管理面板。每行右侧盾牌用于新增策略,铅笔用于编辑;红色标记用于移除策略。“扫描建议”只负责找候选,不会未经确认批量放开或标记。

5.5 怎样设置一张敏感表

  1. 先选择正确的数据源策略按租户和数据源隔离。同名表在两个数据源中需要分别配置,不要因为一边已设置就认为另一边也受保护。
  2. 打开盾牌或编辑图标也可以先点击“扫描建议”。扫描会逐张弹出候选表,点击保存才标记,取消则跳过该候选。
  3. 登记业务分类和敏感级别分类包括财务、经营、人事薪酬、客户和其他;级别包括机密、敏感和内部。它们用于登记、展示和治理,不会单独决定谁能访问。
  4. 配置真正的放行条件选择放行角色、放行用户,并决定租户管理员是否也必须满足这些条件。下节的角色/用户组合规则最关键。
  5. 填写理由并保存例如“含员工工资,仅限薪酬负责人”。保存后使用不同身份做一条放行和一条阻断验证。
图 40 · 薪资表策略示例。图中使用 employee_salary、张敏等演示值说明各字段,未点击保存,也没有修改本机策略;实际配置时应从角色和用户列表选择真实身份。
字段通俗解释配置建议
业务分类 / 敏感级别说明这张表为什么需要治理,以及治理登记等级。按真实业务填写;不要把“内部”理解为自动放宽权限。
放行角色允许哪些角色访问,例如 Data Analyst(tenant:user)。适合“整个财务分析组都可以看”这类群体授权。
放行用户只允许名单中的具体用户。适合少数负责人;使用用户 ID,不要仅凭显示姓名猜测身份。
对租户管理员也强制限制勾选后,租户管理员也必须满足角色/用户名单。高敏数据可开启;该开关不改变超级管理员的跨租户管理语义。
标记理由留下业务依据,便于后续复核。写明数据内容和授权原因,不要在理由中填写密码或密钥。

5.6 放行角色与放行用户:最容易配错的地方

两类名单可以单独使用;如果两类同时配置,就是“且”的关系,不是“或”。也就是说,用户必须既拥有名单中的至少一个角色,又本人在用户名单中,才会被这份策略放行。

放行角色放行用户实际含义适用示例
不选不选普通用户均不放行;管理员按管理员规则处理。仅允许管理员处理的薪酬底表。
选择 Data Analyst不选所有具有该角色的用户都可放行。整个分析组都能看的经营表。
不选只选张敏只按用户身份判断,张敏可放行。仅指定负责人查看,不限制其必须具备某个角色。
选择 Data Analyst只选张敏张敏必须同时是 Data Analyst 且在用户名单中。只有“分析师身份的张敏”能看,其他分析师不能看。
薪资表示例:假设 employee_salary 同时配置“放行角色 = Data Analyst”和“放行用户 = 张敏”。张敏以 Data Analyst 身份查询,可以进入后续执行;李雷也是 Data Analyst 但不在用户名单中,会被阻断;张敏以后失去 Data Analyst 角色,即使仍在用户名单中,也会被阻断。这种交集语义能避免“只要沾到任意一个条件就放行”的权限扩大。

管理员规则:超级管理员默认不受该表级开关约束;租户管理员默认直通。勾选“对租户管理员也强制限制”后,租户管理员也要满足名单条件。无论是否配置敏感表,数据源可见性、租户隔离和其他权限仍然有效。

5.7 查询时到底发生了什么

  1. 用户提出问题或 SQL例如“查询员工 9 月工资”,或手工提交 SELECT * FROM employee_salary。
  2. 系统识别涉及的物理表不只检查查询文本里有没有某个词,还会分析 SQL 表引用;多表 JOIN、子查询和 CTE 也在检查范围内。
  3. 逐表核对当前身份只要涉及的一张敏感表不满足策略,整个查询就阻断,避免通过 JOIN 把无权限数据从侧面带出来。
  4. 通过后才执行并返回检查位于结果缓存读取之前,因此“以前查过、这次命中缓存”不能绕过当前权限。阻断还会留下审计记录。
-- 无权限用户:直接查询会被阻断
SELECT name, salary FROM employee_salary;

-- 无权限用户:即使主目标是 orders,只要 JOIN 触及薪资表,整体仍会阻断
SELECT o.order_id, s.salary
FROM orders o
JOIN employee_salary s ON s.employee_id = o.owner_id;

在 AIP TALK 中,阻断信息会作为明确的权限结果返回,助手不应编造一张“看起来合理”的工资表或数值。为了提高选表稳定性,模型可以收到“某表受限”的提示;看到表名或受限提示不等于读到了表中的行数据。

5.8 扫描建议、移除策略与功能边界

  • 扫描建议看什么:根据表名和列名关键词推测候选,例如 salary、payroll、财务、收入、客户、订单等;它不读取并判断每一行业务内容。
  • 为什么必须人工复核:名称不含关键词的敏感表可能漏报,名称含 order 或 account 的普通表也可能被建议标记。扫描结果只是起点。
  • 移除敏感标记意味着什么:移除的是这道附加门禁,查询恢复为数据源原有权限和其他权限规则,并不是把数据公开给所有人。
  • 它不是字段脱敏或行级过滤:不能用它实现“能看姓名但不能看身份证号”。“只能看本部门/本车间行”这类行级需求请使用下文 5.12 的「行级权限」策略(Schema 面板内有管理界面,可按用户数据属性自动过滤行);字段级隐藏/脱敏则需配合字段策略和数据库自身权限。
  • 它不替代数据库最小权限:SebAgent 会阻断其查询链路中的违规访问,但生产数据库账号仍应使用只读账号并限制直连权限。
验收至少做两条:用应放行的身份确认能查到正确结果,再用普通身份确认直查和 JOIN 都被阻断。只验证“管理员能查”不能证明敏感表策略有效。

5.9 共享范围与删除

将鼠标移到数据源条目上,可使用刷新 Schema、共享设置和删除入口。共享设置可控制私有/租户范围及允许角色;最终是否可见仍由后端权限裁决。删除后,相关历史问答中的引用可能失效,应先评估影响。

生产数据三原则:使用只读账号、限制共享范围、为敏感表配置阻断。不要在截图或手册中记录密码、连接串、私钥和 Token。

5.10 角色数据权限:按角色圈定「能看哪些源、哪些表」

敏感表回答的是“这张重点表谁都不能随便查”,而角色数据权限回答的是反方向的问题:“这个角色只应该看到哪些数据源、哪些表?”它是一张白名单(正面清单):为角色划出数据边界,边界之外的表在 AIP TALK 问数时一律视为不可见。适合按岗位做最小授权——例如“门店运营角色只需要门店、库存、销售三张表,其余几十张表连问都不能问”。

缺省状态:关闭

新角色默认不开启数据权限,不做任何数据过滤,行为与以往完全一致。只有显式打开开关的角色才受白名单约束。

开启之后:先选源,再选表

先勾选可见的数据源;每个源默认“全部表”(整源可见),也可以取消后展开只勾选具体表,精确到表级白名单。

入口位于 系统管理 → 角色权限 → 创建/编辑角色 → 数据权限 页签。它与“权限矩阵”并列:权限矩阵决定角色“能做什么操作”(功能权限),数据权限决定角色“能看哪些数据”(数据范围),两者互相独立、同时生效。页签上的绿色圆点表示该角色已开启数据权限。

图 41 · 角色弹窗的“数据权限”页签。开关已开启;SEO003 源取消“全部表”后,表列表按业务域分组并显示业务表名(如“关键词排名 keyword_rankings”),勾选 2 张关键词类表。图中为演示配置,未点击保存。
  1. 打开“启用数据权限过滤”开关位于“数据权限”页签顶部。保持关闭并保存会清除该角色已存的限制,恢复为不过滤。
  2. 勾选可见数据源勾选后默认选中“全部表”,即整源可见。
  3. 需要精细到表时,取消“全部表”再勾表表列表按业务域分组并优先显示业务表名,业务名来自该数据源本体中的业务术语;尚未做语义增强的数据源按表名前缀分组、显示物理表名。分组与名称只是帮助辨认,保存的始终是物理表名。
  4. 留意保存校验数据源被勾选但既未选“全部表”也未勾选任何表时,保存会被拦截并提示,避免“以为限制了、实际整源可见”的错觉。
  5. 把角色分配给用户在用户管理中为用户挂上该角色即生效。

多角色与管理员规则:用户拥有多个角色时,可见范围取所有已开启数据权限角色的并集;一个都没开启则不设限。超级管理员与租户管理员默认直通,便于运维排障——因此验收时不能只使用管理员账号。

图 42 · AIP TALK 中的越权拒答。演示账号的角色仅被放行一张表,询问宿舍楼入住时多条查询路径均被数据权限拦截;助手明确说明缺乏访问权限并建议联系租户管理员,没有编造数据。

越权拒答不会回显 SQL,阻断记录会写入审计日志(系统管理 → 审计日志)。问数链路中的检查位于结果缓存读取之前,因此“以前查过、这次命中缓存”不能绕过当前权限。

5.11 敏感表 × 角色数据权限:两道闸门,各管一段

两套机制方向相反、互不影响,可以单独启用,也推荐组合使用:范围用白名单管(角色最小授权),重点表用黑名单管(数据重点防护)。一次查询必须同时穿过两道闸门才会被执行。

图 43 · 两道闸门组合示意。闸门① 角色数据权限(白名单)判断“这个角色能看哪些源、哪些表”;闸门② 敏感表(黑名单)判断“这张重点表谁在查”。任一不通过即拒答并审计。
查询触及的表闸门① 角色数据权限闸门② 敏感表最终结果
白名单内的普通表通过不触发放行执行
白名单外的数据源直接拒答—拒答,不发起模型翻译
白名单外的表(含 JOIN 侧带)整体拒答—拒答,不回显 SQL
白名单内的敏感表,身份不满足放行策略通过阻断阻断并写审计
白名单内的敏感表,身份满足放行策略通过放行放行执行
典型组合:给“薪酬专员”角色开启数据权限,白名单只放 HR 库的几张表;同时把 employee_salary 标记为敏感表、放行用户只留薪酬负责人。结果是:该角色整体只能在 HR 范围内问数,而工资这一张还要再核对人头——范围归白名单管,重点表归敏感表管。
验收至少做三条:① 白名单内的表能正常问出结果;② 白名单外的表被明确拒答、不回显 SQL;③ 白名单内同时是敏感表的表,未放行身份仍被第二道闸门阻断。全部用管理员账号验证无效——管理员默认直通两道闸门。

5.12 行级数据权限:同一张表,不同的人看到不同的行

敏感表和角色数据权限都停在表级——“能不能碰这张表”。行级数据权限再细一层:同一张表进得来,但只能看到属于自己数据范围的行。典型场景:生产记录表大家都能查,但车间主任只能看到本车间的行;区域经理只能看到本区域的行。

没有行级策略

能访问表就能看到全部行。适合全租户共享的维表、公共数据。

配置行级策略之后

查询被自动改写为带条件的参数化 SQL(如 WHERE workshop_id IN (?)),范围之外的行从结果里消失;用户缺少策略所需的数据属性时,会得到明确拒答而不是一张悄悄变空的表。

入口位于 数据源编排 → 选择数据源 → 右侧 Schema → 行级权限,与敏感表页签相邻。配置需要租户管理员权限。每条策略绑定「一张表 + 一组规则」,规则把表的物理列与取值来源关联起来:

  1. 新建策略并选表行级权限页签列出该数据源的全部数据表及每张表的策略状态(规则数 / 已停用 / 未配置),点击目标表行右侧的编辑按钮进入规则配置。
  2. 添加规则选择过滤列(列名下拉,带数据字典业务名)→ 选择操作符 → 选择值来源。值来源为「用户属性」时,填属性键(如 workshops),每个用户的实际取值来自其账号上的数据属性——这是与第三方系统权限联动的关键;值来源为「固定值」时,直接填常量列表,适合无第三方集成的小场景。
  3. 用「探查真实值」避免手输错别字对该列执行 SELECT DISTINCT 后从真实值列表点选,而不是凭记忆输入。
  4. 或用预设模板一键生成「按车间 / 按部门 / 按区域」三个模板会自动填好常见的列名关键词与属性键,再按实际表微调即可。
  5. 保存后用「权限试算」验收选择任意目标用户,立即看到该用户最终生效的 WHERE 片段、参数、表总行数与可见行数——不必等用户反馈才发现配错。
操作符含义典型用法
eq / neq等于 / 不等于单列单值匹配或排除
in / not_in包含于 / 不包含于最常用:列值落在用户属性列表内,如“车间 ∈ 我负责的车间”
gt / ge / lt / le大于 / ≥ / 小于 / ≤数值或时间的上下界
between闭区间(两个值)日期区间、数值区间

用户的数据属性从哪里来

两个来源,可混用:① 第三方系统随登录同步(推荐)——第三方在 SSO 断言里声明 attrs(如 {"workshops": ["一车间"]}),发行方开启「同步用户属性」后每次登录自动刷新,第三方调整了车间授权,用户下次登录即生效,配置方法见 12.3.7;② 管理员手工维护——在 系统管理 → 用户管理 编辑用户,在「数据属性」区按键值填写(值为字符串列表)。手工填的同名键会被登录同步覆盖,未同步的键不受回收影响。

查询时到底发生了什么

  • 自动改写 SQL涉表查询在执行前注入行过滤条件,过滤值一律以 ? 参数化传递,不会拼进 SQL 文本,杜绝注入风险。
  • 缺属性 = 明确拒答用户缺少规则引用的数据属性时,查询被拒绝并提示“需要为您的账号配置数据属性(属性名)后才能查询;请联系管理员处理”——宁可拒答也不放行,拒答会写审计。
  • 多规则取交集同表多条规则、多策略命中都按 AND 收窄,不会互相放宽。
  • 管理员直通与豁免超级管理员、租户管理员默认直通;策略可另配豁免角色/用户。验收请用普通用户身份或「权限试算」,管理员账号看不出过滤效果。
  • 结果缓存按属性值隔离不同属性值的用户互不可见对方的缓存结果;属性变化后下次查询自动按新值过滤,无需重启或重建会话。
车间场景端到端示例:① 第三方断言带 attrs: {"workshops": ["一车间"]};② 管理员在「行级权限」为 prod_records 配规则:列 workshop_id、操作符 in、值来源「用户属性」、属性键 workshops;③ 张三问“各车间本月产量”只看到一车间;④ 李四的账号没有 workshops 属性,直接收到明确拒答。第三方侧如何传 attrs、如何核对同步回执,见《AIP-TALK 客户端开发指南》第 7 章。
与两道表级闸门叠加,各管一段:角色数据权限(5.10)管“这个角色能进哪些源、哪些表”(白名单);敏感表(5.4)管“这张重点表谁在查”(黑名单);行级权限管“进来以后能看哪些行”。三者全部通过才执行,任一不通过即拒答并审计。

5.13 字段级用途标签:限定每个字段能用来做什么

敏感表管“哪张表能碰”、行级权限管“能看哪些行”,用途标签管“这个字段能用来做什么”。每个字段(或整表)可标注四种允许用途:query 即席查询、analytics 统计分析、training 模型训练、export 数据导出。查询与导出两个消费口各有一道闸:用途不符即拒绝并写审计;未打标的字段一律不限制,既有数据源零行为变化。

  1. 打开 Schema 区「用途标签」页签在数据源编排选中目标数据源,右侧 Schema 区切换到「用途标签」(该页签仅管理员可见可用)。
  2. 逐表打标在表清单点「打标」按钮,弹窗中选择目标列——下拉首项 * 表示整表;勾选一个或多个允许用途,可附备注说明原因,保存即生效。
  3. 核对已打标清单面板顶部列出全部已打标字段及用途徽标,可随时编辑或移除;移除后该字段恢复不限制。
图 44 · 「用途标签」页签。已打标字段逐条列出(整表 * 或具体列),用途以徽标展示;下方表清单可对任意表发起打标。
图 45 · 打标弹窗。目标列下拉首项为整表 *;用途多选,保存即生效,无需重启。
判定口径:SELECT * 会保守命中表内全部列级标签(任一列禁止即整体被拒);按整表 * 打标时按整表策略评估。标签变化立即生效,连缓存回放也会被拦截——命中缓存不改变用途判定。
常见搭配:身份证号、手机号等标识列只允许 query(在线查询),禁止 export/training;含经营明细的整表允许 query+analytics、禁止 export。与敏感表(5.4)、角色数据权限(5.10)、行级权限(5.12)叠加使用,各管一段。

5.14 企业系统连接器:Business Central、Salesforce 与 SAP

四类预置连接器把主流 ERP/CRM 直接接入问数。Business Central、Salesforce、SAP OData 为快照型:数据周期性同步到本地,查询走内存 SQL,缓存到期自动重拉,也可在卡片上手动「刷新」;源端短暂故障时自动沿用最近一次成功快照(serve-stale),查询不中断。SAP HANA 为直连型:实时 SQL 打到客户侧只读语义视图,不落地数据。

连接器同步/访问形态增量与对账需要准备
Business Central12 个标准实体快照(客户/供应商/物料/发票/总账等)按主键水位增量、upsert 幂等;EDMX 自动生成 schemaEntra 应用(BC API 权限)+ 公司名
Salesforce对象快照(默认 11 个标准对象;自定义 __c 对象须在白名单显式纳入)SystemModstamp 水位增量 + queryAll 删除对账;大对象自动走 Bulk 2.0集成用户 + Connected App(Consumer Key + RSA 私钥)
SAP HANA实时 SQL 直连语义视图(白名单必填,为空即拒绝,防整库暴露)无快照;期间类视图内置滚动期间闸(如财务行项目 92 天)HANA 只读账号 + 已执行语义视图 DDL 包
SAP OData实体集快照(V2/V4 双解包,/Date/ 时间戳自动还原)首拉回看窗 + 水位 ge 增量 + $count 对账Gateway Base URL + 通信用户 + 实体集白名单
  1. 先在对应系统备好凭据BC 用 Entra 应用、SF 用 Connected App + 集成用户、SAP 用只读账号或通信用户——一律最小权限、只读优先。凭据在服务端加密存储,页面只显示打码。
  2. 创建并测试数据源页选对应类型填写,先「测试连接」再创建。SF 的自定义对象、SAP OData 的实体集务必在白名单里显式声明(未声明的不采集);SAP HANA 未装驱动时测试连接会给出明确的安装指引而非含糊报错。
  3. 核对 Schema 再开问创建后到 Schema 面板确认实体、行数与最近刷新时间;快照源可在卡片上随时「刷新」手动重拉。
  4. 权限闸门照常生效敏感表(5.4)、角色数据权限(5.10)与行级权限(5.12)对所有连接器一视同仁——例如按 BUKRS 公司代码配置行级规则后,SAP 查询即按用户属性自动收窄。
逐项配置与排障见部署指南:docs/bc-datasource-setup.md、docs/sf-datasource-setup.md、docs/sap-datasource-setup.md(含高级参数:快照 TTL、单对象行数上限、Bulk 阈值、API 配额预留等)。

5.15 字段级血缘视图:这张表/字段被谁引用

前面各节回答的是“谁能碰数据”(敏感表、角色权限、行级权限、用途标签);血缘视图回答另一个问题:“这张表、这个字段被谁引用着”。它把分散在四个模块的引用关系聚成一张清单:本体绑定(哪些本体类/属性映射到该字段)、字典术语(哪些业务术语指向该字段)、用途标签(该字段被限定了哪些用途)、敏感表策略(该表是否纳入敏感管控)。改表结构、下线字段、做治理审计之前,先在这里看清影响面。

  1. 打开 Schema 区「血缘」页签在数据源编排选中目标数据源,右侧 Schema 区切换到第六个页签「血缘」。页签人人可见,但引用数据仅租户管理员可读——非管理员看到的是锁形提示,与敏感表(5.4)、用途标签(5.13)同一道闸。
  2. 先看顶部四层计数徽标本体绑定 / 字典术语 / 用途标签 / 敏感表策略各一枚计数,一眼判断该数据源的治理覆盖度;某层为零通常意味着该层尚未配置,而非异常。
  3. 逐层读引用明细每层按“引用项 → 目标表.字段”逐条列出(例如术语「黑名单车牌号」→ ip_parking_black…plate_number);无引用的层显示「无引用」。清单在每次打开页签时实时拉取,配置改动后重进页签即可看到最新口径。
图 46 · 「血缘」页签。顶部四层计数徽标(本体绑定 / 字典术语 / 用途标签 / 敏感表策略);下方逐层列出引用明细,无引用的层标注「无引用」。
典型用法:① 改表/下线字段前先查血缘——被本体类绑定的字段改名会直接冲击语义层与问数口径;② 排查“这个字段为什么被拦”——用途标签层直接给出生效策略;③ 治理审计按层核对覆盖度。同口径接口 GET /api/v1/lineage/{source_id} 可接入自研审计脚本(需租户管理员身份)。
06

驾驶舱与 API 开发指南

从交互式看板阅读指标,也可通过开放接口集成到自有系统。

6.1 驾驶舱

  1. 进入“洞察分析 → 驾驶舱”,选择配置包和看板驾驶舱由 Pack 驱动,不同配置包提供不同指标布局。
  2. 刷新并核对时间点击刷新后检查每张卡片是否正常返回,以及指标的时间范围是否符合汇报口径。
  3. 处理权限或配置提示“无权访问数据源”表示当前身份缺少对应数据源权限,不是图表计算结果;请联系数据源所有者或租户管理员。
  4. 按需配置有配置权限时,使用右上角“配置”维护看板与数据源绑定。
图 47 · 驾驶舱的真实权限状态示例。当前截图账户未获 park_db 授权,因此卡片显示锁形提示;这也是排查“看板没有数字”时的第一类检查项。

6.2 API 与第三方嵌入

入口位于 系统管理 → API开发指南(系统管理员与租户管理员可见)。API 开发指南集中提供 OpenAPI JSON、服务器地址、连接测试、AIP TALK SSO/嵌入说明和示例代码。外部调用通常先通过 /auth/login 获取令牌,再按具体接口要求携带认证信息;流式回答使用 SSE。

POST /auth/login
Content-Type: application/json

{"username":"YOUR_ACCOUNT","password":"YOUR_PASSWORD"}
  • 将示例中的占位符替换为本环境值,不要把真实密码或令牌提交到代码仓库。
  • 嵌入第三方页面前,在“系统管理 → 第三方集成设置”配置发行方和允许来源。
  • 反向代理需要同时转发页面、/message、/stream 和相关 API 路径,并调整上传大小限制。
图 48 · API 开发指南。图中的 TOKEN 是示例占位符,不是可用凭据;实际地址应以部署环境为准。
07

本体编排

把物理表结构转化为业务对象、关系、指标和可治理的语义资产。

7.1 Ontology Copilot

在左侧选择数据源或跨源虚拟本体,再通过快捷入口或自然语言指令完成 Schema 查看、业务实体识别、语义增强、推理规则、派生指标和跨源映射。涉及生成或修改时,先阅读预览/澄清内容,再确认入库。

图 49 · Ontology Copilot 首页。顶部快捷入口覆盖常见任务;没有跨源虚拟本体时,跨源功能会给出先创建虚拟本体的提示。

三个 TAB 与 Fast Start 快速上手

Copilot 视图顶部有三个 TAB:Copilot(对话式编排主入口)、图谱(随对话实时刷新的本体图谱,工具栏与经典模式一致)、Fast Start(快速上手指引)。不知道第一步做什么时,先看 Fast Start。

  • Fast Start 三步路径第一步数据字典(语义地基)→ 第二步本体编排(表达业务实体与规则)→ 第三步同义词与口径(问数命中率)。每张步骤卡给出“为什么、怎么做、真实案例”和配置入口。
  • 一键预填 Copilot步骤卡上的“在 Copilot 中试试”会把示范话术预填进输入框(不自动发送),你确认或改写后发出即可。
  • 实时状态徽章与验证闭环选中数据源后,Fast Start 实时显示字典词条数、本体规则数与成熟度百分比;底部“验证闭环”卡给出可照抄的问数题目与期望结果——配置不等于生效,每条配置都要用 AIP TALK 真实问数验收。

7.2 经典图谱模式

基本流程

  1. 选择数据源加载已有本体;没有本体时,可返回 Copilot 或使用“生成本体”流程。
  2. 阅读图谱使用节点/关系筛选、搜索、缩放和复位定位对象类型、数据属性及关系。
  3. 查看详情点击类、属性或关系节点,在详情面板检查业务术语、映射和约束。
  4. 治理变更版本、Action、Function、推理规则和指标应经过审核;不要把实验修改直接当成已发布语义。
图 50 · 经典模式中的真实本体图谱。图谱用于理解语义结构;具体查询结果仍取决于映射、权限和底层数据。

工具栏速查 · 浏览与导航

  • 数据源侧栏与「生成本体」左侧列表选择数据源加载本体;没有本体时点底部「生成本体」,系统从 Schema 自动草拟(进度条可随时取消)。侧栏顶部按钮可折叠侧栏。
  • 搜索框按类名、属性名或业务术语模糊匹配,回车定位并高亮节点。
  • 类型筛选「类 / 对象属性 / 子类关系 / 推理 / 实例」五个开关控制图谱中显示哪些元素;图太密时先关掉「实例」。
  • 「主要节点」与「显示子节点属性」右侧面板顶部的两个开关:前者只看类主干及其关系,适合先摸清全貌;后者控制是否展开类的数据属性。
  • 图例 / 放大 / 缩小 / 重置视图左侧竖排工具栏的前四个按钮:图例解释颜色与线型;缩放飞来飞去找不到图时点「重置视图」。
  • 统计面板与成熟度卡片统计面板显示类、对象属性、数据属性、规则的计数;成熟度卡片给出综合分、雷达图与 Top 缺口,是「下一步该补什么」的指挥棒。
  • 导出把当前本体导出为 Turtle(TTL)文件,用于备份、评审或迁移到其他工具。

工具栏速查 · 探索与查询

  • 路径查找选起点和终点两个类节点,找出最短有向路径并在图谱中高亮——回答「这两张表是怎么关联起来的」。
  • 自然语言查询右下角输入「Customer 是什么」这类问题,系统按确定性规则匹配并高亮相关节点;它是探索演示工具,不替代 AIP TALK 问数。
  • 对象浏览器按类浏览真实实例:过滤构建器(eq/contains/gt 等)、分页、聚合视图、CSV 导出,点单条记录可看详情与一跳关联。
  • 节点详情面板点击任意节点或连线,右侧「节点详情」显示业务术语、来源表/列(sourceTable / sourceColumn)与约束——写规则前先来这查准确的类名和属性名。

工具栏速查 · 规则表达与推理

  • 三条表达路径推荐在 Copilot 里直接口述规则(多轮澄清 → 草案卡 → 确认抽屉 → 落库);本页「自然语言生成规则」按钮打开 NL 编辑器,以 diff 预览方式增改本体;「规则编辑」(蓝色高亮按钮)打开规则面板,用表单或 DSL 精确定义。
  • 两类规则「自定义推理规则」由条件推出新关系/新分类;「数据缺口检查规则」反推哪些实例缺少应有的数据(如哪些公司缺少 SEO 关键词),结果在「推理结果」面板列出。
  • 条件写法对象属性 objectProperty(属性, 域, 范围)、数据属性 dataProperty(属性, 域, 范围)、子类 subclassOf(子类, 父类);数值比较用五参数形 dataProperty(total_persons, ?D, integer, gte, 100),多条条件默认 AND,可用 [or] 前缀改 OR。
  • 动作写法addObjectProperty / addDataProperty / addClass 追加图谱元素;缺口规则动作为「报告缺失」(填类与缺失提示)。
  • 执行推理「推理规则」面板顶部按钮执行所有启用规则:存在性规则做 Schema 层模式匹配,带数值比较的规则自动加载实例逐行求值(上限 5000 行),命中的实例被打上标签。
  • 推理结果与清除推断元素以虚线叠加到图谱,不改动原始本体;「推理结果」面板可点项高亮,「清除」一键恢复原状;历史面板保留每次推理的记录。
  • 落库即生效规则保存后自动回写数据字典词条,AIP TALK 问数命中该业务词时 WHERE 条件自动按规则口径落实——用真实问数题验收,例如「重大险情案例有多少起?」。

工具栏速查 · 指标、函数与动作

  • 受控指标表单定义业务指标:聚合表达式(比率型选分子/分母两个属性)、下钻维度、口径过滤、单位与别名。保存前先 Dry-run 看编译 SQL 和样本值;「认证」后成为唯一直答口径,问数时不再由 AI 自由发挥。
  • Functions只读函数库:按参数表单调用并查看 JSON 结果树;复合函数用 JSON 声明步骤,步骤间用 $prev 与 $input.xxx 引用,适合把常用取数逻辑沉淀成可复用资产。
  • Action 操作对语义层的受控变更:选 Action 类型 → 按参数 schema 填表 → Dry-run 预览 → 填决策理由(Rationale)→ 应用。Action 只写语义层定义,不直接改业务数据。
  • 治理收件箱统一处理指标纠错工单与 LLM 提议:受理 / 驳回 / 办结,提议撞名时给出逐字段 diff 视图供仲裁(保留现有 / 合并为别名 / 替换定义)。

工具栏速查 · 版本、编辑与跨源

  • 历史版本版本时间线列出每次变更(操作类型、操作人、diff 摘要);任选两个版本看 diff;回滚需二次确认,回滚后图谱自动刷新。
  • 编辑模式开启后直接在图谱上改:双击空白加类、双击类节点改名/改描述、Shift+从 A 拖到 B 加关系、Delete 弃用所选。所有写操作走 Action API,自动带版本与审计。
  • 跨源虚拟本体把多个数据源的类映射成一个虚拟本体:面板中创建虚拟本体、挑选数据源,再用映射编辑器确认自动推荐的类级/属性级映射。
  • 统一跨源查询基于虚拟本体执行跨源联合查询——例如「客户」实体同时落在 CRM 与订单库时,一次查询返回统一视图。

7.3 苏格拉底澄清访谈:把业务口径聊成语义资产

本体成熟度低于 50% 时,Copilot 会主动提示开启「苏格拉底式本体工程访谈」。系统按成熟度差距逐题提问:字段的业务叫法、表间关系与基数、常用派生指标口径、一词多义冲突确认、对象的业务描述。全程自然语言作答,顶部显示访谈进度;回答模糊时系统会追问澄清,而不是替你猜测。

  1. 开始访谈在本体编排页选择数据源,成熟度卡片加载后,点击聊天区上方提示条中的“开始访谈”。答不上的题可跳过;中断后重新进入会从上次进度继续。
  2. 像带新同事一样回答直接口述业务口径,例如“这个字段叫救援作业编号”“一张事故表对应多条打捞记录,1 对多”“毛利率 =(收入-成本)/收入,按含税口径”。系统会把回答解析成待确认的本体修改。
  3. 预览并确认全部问题答完后进入更新预览抽屉,逐条核对将要写入的修改(字段术语、关系、指标公式),确认无误再点“应用”。应用即生成版本快照,可在版本历史中回滚。

与数据字典的四个闭环

  • 访谈确认 → 自动入字典访谈里确认过的术语会自动写入数据字典(置信度 100%,来源标记为“访谈确认”),无需重复录入。
  • 字典低置信 → 访谈升级“智能理解”等 AI 推测入库、置信度低于 60% 的术语,会在下次访谈中生成带“数据字典升级”角标的确认题;答“准确”即升级为人工确认,答“不准确,我来纠正”可当场改名。
  • 规则确认 → 字典词条在 Copilot 口述并确认的业务规则(如“如果病例有牙周问题就推断为复杂病例”)会自动生成关联规则的字典词条,后续 AIP TALK 问数时能直接命中该业务口径。
  • 字典高置信 → 确认题/一键回填字典里置信度 ≥80% 的词条有两个去处:访谈遇到同字段的开放提问时,自动降级为带“字典候选”角标的确认题(快答“沿用”即采纳,无需重新口述);成熟度卡片上的“从字典回填”按钮可先预览、再把高置信词条批量回填到本体空位——本体已有不同叫法的列为冲突绝不覆盖,已一致的自动跳过。

越聊越懂你:访谈记忆与知识议程

  • 答过的题不再问,跳过的题不失联答过的题永久不再重问;跳过的题不会消失——它会带着“回访”角标排在后续轮次的新话题之后再次提问(只有连跳 3 次才进入 30 天冷却,防止纠缠)。重开访谈时,聊天区会提示“已积累业务知识 N 条 · 本轮新话题 M 个”。
  • 每轮都有新话题,问题集问完为止除结构缺口外,访谈会按知识议程盘点四类业务知识:值域口径(字段 status 都有哪些取值、各代表什么业务状态)、表粒度(一行数据代表什么、靠什么字段区分)、业务规则线索(什么情况算“异常/高质量/需要跟进”)、典型场景(日常最想用数据回答哪些问题)。同类题不会连发,像带着你巡览业务全景;本轮把池子里识别出的问题全部问完才进入预览,不再固定 7 题收尾。
  • 趁热追问确认一个字段的业务叫法后,系统会紧接着追问“业务上还有别的称呼吗”(别名采集)和枚举字段的取值口径——别名与值域随后直接服务于 AIP TALK 问数:用户怎么说都能听懂,过滤值都能翻译对。
  • 答“没有”也是知识“没有业务含义”“没有别的叫法”“暂时没有”这类否定回答同样会被记住,后续不再重提;全部答“没有”的访谈也能正常完成,不强制产生修改。

一次完整的访谈长这样

系统怎么问(示例)你可以这样答系统接下来做什么
字段 rescue_id(表 t_rescue)在你们业务里通常叫什么?“这个字段在我们业务里叫救援作业编号。”生成一条字段术语修改;预览抽屉里可逐条核对 before → after。
表 t_accident 和 t_salvage 之间是什么业务关系?一条事故记录通常对应多少条打捞记录?“1 对多,一张事故表对应多条打捞记录,打捞必须挂在事故下。”生成表间关系(1:N),基数写入关系说明;图谱中随后可见新连线。
你们最常用的 3~5 个业务指标是什么?“最常用的是毛利率,口径是(收入-成本)/收入,按含税口径。”生成派生指标:名称、公式、结果类型一应俱全,进入本体指标列表。
“状态”同时对应多个字段,它们是同一个业务概念吗?“不是同一个概念,请按字段分别登记。”系统不会硬猜,而是追问“请分别为以下字段给出各自的业务术语:1) … 2) …”,逐字段给名后分别登记。
AI 推测字段 accident_id(表 t_accident)的业务含义是“事故编号”(置信度 45%),这个叫法准确吗?(题卡带“数据字典升级”角标)点快答“准确”,或答“不准确,它应该叫救援事故编号”。“准确”→ 字典条目升级为 100% 人工确认;纠正 → 条目改名并标记人工确认。
数据字典里记着字段 backlink_id(表 backlinks)叫“外链编号”,沿用这个叫法吗?(题卡带“字典候选”角标)点快答“沿用”。字段本体术语直接落为“外链编号”,与高置信字典条目保持一致——开放提问被降级为一键确认,无需重新口述。

确认之后去哪验证

  1. 看本体切到经典图谱模式,点刚确认的字段节点,详情面板的业务术语应是你口述的叫法;关系题确认的连线也应出现。
  2. 看字典在数据字典搜索刚确认的术语:置信度应为 100%,来源标记为“访谈确认”;规则名对应的词条带规则引用。
  3. 看规则Copilot 口述的规则(如“如果车辆事故的 severity 大于 3,就推断为重点跟踪事故”)确认后出现在规则列表,可随时停用。
  4. 看问数在 AIP TALK 直接问“什么叫重点跟踪事故”,应命中刚沉淀的业务口径。

成熟度提升闭环实拍

当雷达图面积较小或存在薄弱维度时,成熟度卡会给出可执行的「提升建议」。下图为一次完整闭环的实拍。

图 83 · 成熟度提升闭环实拍。雷达以 🔴(<50%)/🟠(50–80%)标记薄弱轴、灰色虚线标出 80% 目标;点「Improve/提升建议」在对话区生成建议卡——按得分升序给出原因、涉及字段与可执行动作,动作生效后雷达自动刷新。
  • 雷达轴标记:得分 <50% 的维度标 🔴、50–80% 标 🟠;灰色虚线轮廓标出 80% 目标线。
  • 建议卡生成:点击卡片头部的「Improve / 提升建议」,Copilot 在对话区生成建议卡——按得分升序列出薄弱维度,逐条给出原因、涉及字段与可执行动作。
  • 动作闭环:建议卡的动作 Chip 一键进闭环——描述类走字典回填(零 LLM 即时生效),实体/关系/派生指标类发送预填提示进 Copilot 对话补全;动作生效后雷达自动刷新。
  • 综合分析:卡片尾部的「让 Copilot 综合分析」让 LLM 给出叙述性整改方案(影响、修复顺序、预期收益)——Copilot 只解释不执行,落地仍走确定性动作。
  • 效果可见:动作生效后成熟度分数变化会弹出提示,建议卡重渲染时顶部出现「提升前后对比条」,展示总分与变化最大的三个维度增量。
  • 空态引导:若某数据源尚未生成本体,成熟度卡显示灰色提示与「识别业务实体」引导按钮(属正常初始状态,不是系统错误);一键进本体识别流程后雷达自动出现。

7.4 与 Palantir AIP 的差异化优势

本系统的本体体系以 Palantir AIP Ontology 为参照设计,在原语级对位的基础上形成了八项差异化优势,一览如下。

优势点本系统的做法Palantir AIP 对照带来的价值
声明式规则表达与推理SWRL 风格规则:存在性匹配 + 数值比较(五参数形)+ AND/OR 组合;实例级逐行求值与数据缺口反推;推断结果虚线叠加图谱、可撤销,落库自动回写数据字典。无声明式规则语言,业务逻辑须用 TypeScript Functions 或 AIP Logic 编写。业务人员可读可写,Copilot 口述即生成;规则可审计、可版本化。
自然语言本体建模Copilot 多轮澄清 → 草案卡 → 确认抽屉;NL 生成规则带 diff 预览;Fast Start 三步路径与功能引导浮层。建模主要靠数据工程师在管理器中手工完成。建模门槛从「周级排期」降到「小时级自助」。
苏格拉底访谈 × 字典置信闭环知识议程逐题访谈、跳题回访;AI 推测低置信分级 → 访谈 / Excel 回流升级;规则确认自动生成字典词条。无对应机制,语义靠实施期一次性梳理。语义资产持续自增值,越用越准。
轻量联邦跨源语义虚拟本体 + 类/属性级映射 + 联邦查询(OBDA),数据不落地复制、实时可见。物化 Object Database:管道落库成图谱,链路重、时效依赖同步。接入快、改动即时生效,数据不出域更合规。
受控指标:唯一认证口径指标 Dry-run 看编译 SQL 与样本值,认证后成为唯一直答口径,AI 不再自由发挥。指标逻辑分散在各应用与报表中,口径难统一。全公司同一指标同一数字,可向管理层背书。
开箱即用的问数闭环AIP TALK 自然语言问数直接命中术语、同义词与值域口径;接库 → 智能理解 → 提问当天闭环。需先建数据管道与本体才能问数。当天接库当天问数,试错成本极低。
本土化与全员触达中英双语全界面;微信、飞书、Teams 全通道;M365 / SharePoint / BC / SAP / Salesforce 连接器开箱即用。界面英文为主,国内 IM 生态缺位。一线员工零学习成本,在已有 IM 里直接用。
私有化部署与总成本三档硬件方案(¥4 万起)、轻量依赖、多租户 SaaS 化、行业扩展包零代码交付。重型平台:投入千万级、实施以年计。TCO 低一到两个数量级,交付以周计。

这八项优势指向同一个立场:把「本体工程」从数据工程师的专项工作,变成业务人员随手可用的日常能力——这是本系统对标 Palantir AIP 时最核心的差异化。

打开完整对照专题页 ↗(原语对位地图 / 十维对照 / 规则表达专题 / 架构路线 / TCO 对比)

什么时候需要数据字典?本体描述对象和关系,数据字典补充术语、同义词及表/字段映射。两者保持一致,可以显著减少“同物不同名”造成的误查询。
08

数据字典

集中维护业务术语、同义词和物理表字段之间的对应关系。

8.1 查询和维护术语

  • 使用搜索框以及分类、表、数据源筛选快速缩小范围;列表顶部显示术语、表和分类统计。
  • 有写权限时可新增/编辑术语。普通查看者只能读取,租户之间按权限隔离。
  • 全局共享和单一数据源术语的作用域不同,避免把某个系统的字段含义误套到所有数据源。
  • 术语条目带置信度与来源标记:AI 推测且置信度低于 60% 的条目会自动进入本体访谈议程等待人工确认;经访谈或人工维护确认的条目置信度为 100%。
图 51 · 数据字典。标注 1 搜索/筛选,2 智能理解,3 Excel 导入;右侧还提供导出能力。

8.2 智能理解与 Excel 导入导出

  1. 选择范围在“智能理解”中指定数据源和需要分析的表/字段。
  2. 预览建议检查术语、描述、分类和映射,尤其注意已经在库中的条目。
  3. 确认入库提交后区分新增和更新数量;不要只看“操作成功”提示。
  4. 批量治理使用 Excel 导出做审阅和离线整理,再按模板导入。导入前备份,导入后抽查同义词和作用域。
09

知识库与记忆

知识库管理可引用的企业文档;记忆保存随时间沉淀的上下文和长期偏好。

9.1 上传文档到知识库

  1. 进入“Enterprise AIP Ontology → 知识库管理”确认顶部租户知识库身份,再点击“上传文件”。
  2. 选择目标分类和入库方式直接入库、AI 整理和 FAQ 导入适用于不同文档结构。
  3. 按需启用 OCR扫描版 PDF 可启用全文识别;运行环境不支持时开关会不可用并给出原因。
  4. 上传并等待索引处理中不要关闭弹窗。上传完成不等于所有图注/向量索引均已完成,应等待状态结束后再验收检索。
图 52 · 知识库上传。上传对话框中的标注区域用于选择入库方式和文件;工具栏「上传文件」右侧的「上传具体网址」按钮用于站点抓取入库(见「网站 URL 抓取入库」小节)。手册未实际上传文件,背景中的企业文档内容也未作为手册素材。
方式适用场景注意事项
直接入库结构清晰、希望保留原文的文档。速度快;先检查文本抽取和章节结构。
AI 整理需要提炼为结构化知识的资料。耗时更长;抽查模型整理是否改变原意。
FAQ 导入明确的一问一答资料。没有 Q&A 结构时可能降级为直接入库。
OCR扫描 PDF、图片型页面。通常限单个 PDF;识别和深度补页可能是长任务。

网站 URL 抓取入库

  1. 点「上传具体网址」输入站点 URL知识库管理页工具栏的「上传具体网址」按钮(在「上传文件」右侧)打开独立抓取对话框:按深度(默认 5)与页数上限(默认 200)逐页抓取同域页面,也可切换为「仅限同路径前缀」收窄范围;页面正文与配图一并入库,JS 渲染型站点自动启用无头浏览器渲染并滚动触发懒加载内容;对客户端路由、页面间无传统链接的 SPA 站点,自动读取 robots.txt 声明的 sitemap 清单播种全站页面,逐层收录完整内容。
  2. 后台任务化执行抓取在后台任务系统进行,知识库视图的进度卡实时显示已入库/已发现页数与当前 URL,可取消、失败可重试;整站收尾自动生成「站点抓取索引」页(页面清单 + 失败清单)。
  3. 重复抓取幂等同一 URL 重新抓取会覆盖更新原文档(版本历史保留),不会生成“-2”副本,适合定期同步产品文档站。
  4. 安全与礼貌抓取仅支持 http/https;内网与本机地址默认被 SSRF 防护拦截,管理员可在配置中置 knowledge_crawl_allow_private=true 显式放行(弹窗内会出现提示条);尊重 robots.txt 并限速抓取;正文图片经尺寸/类型过滤后落入知识库资产仓并自动生成图注,参与图文召回。
  5. 适用边界需要登录鉴权的站点内容无法抓取;页面中的视频内容不参与入库与分析;超大站点建议先用「同路径前缀 + 较小页数」试抓验收,再放大范围。

知识库管理页还提供文档/图谱/快问快答、分类、新建文档、批量管理、搜索和版本操作。写入口仅对有知识库写权限的角色开放。

9.2 批量上传:文件夹、ZIP 与断点续传

业务文档多、目录结构复杂时不必逐文件上传:可以直接选择或拖拽整个文件夹,也可以先打包为 ZIP 再上传。原目录结构会自动生成为目标分类下的嵌套分类,同名文件在不同目录下各入各类、互不冲突。

  1. 文件夹上传点击虚线框内的“选择文件夹”,或把整个文件夹拖进虚线框;系统隐藏文件(.DS_Store、.git 等)自动忽略并提示数量。
  2. ZIP 包上传压缩包自动解压并逐文件入库;路径逃逸条目直接拒绝,嵌套 ZIP、加密条目、不支持类型会跳过并在结果中标注。ZIP 内的 PDF 不走 OCR 车道(OCR 仍限单个 PDF)。
  3. 查看进度大文件显示字节级百分比,整体进度条按字节聚合;小文件自动合批上传。处理中不要关闭弹窗。
  4. 中断后续传网络中断或页面关闭后,重新打开上传弹窗会看到上次未完成批次的提示;重新选择同一批文件或文件夹,已完成项按“文件名+大小”匹配自动跳过,未完成项重新上传。
  5. 失败项重试上传结束后如有失败,失败文件会在弹窗底部单独列出并附原因;点“重试失败项”只重传失败文件(已完成项自动跳过),点“不重试,退出”则关闭弹窗并清除本批续传记录。
场景行为建议
单批数量单次最多 500 个文件,超出会被整批拒绝并提示。超量时分批上传或打包为 ZIP。
目录层级目录自动映射为嵌套分类,最深 8 层、段名超长截断、非法字符替换。先在源侧整理好目录结构再上传。
重复上传续传场景已完成项自动跳过;常规重复上传同一文件会生成“-2”副本而非覆盖。想更新文档请直接编辑,或删除后重传。
ZIP 安全限制成员数、单成员大小与解压总量均有护栏,超限条目跳过并标注原因。超大资料库建议拆分多个 ZIP。

9.3 全文检索:直接找到文件本身

知识库从「只能问答」升级为「可找文件」:全文检索管「找」,RAG 问答管「答」,两者并轨不相互替代。检索覆盖当前租户知识库全部文档的标题与正文,中文按字切分——单字、二字词、词中子串都能命中;桌面端管理页为固定布局(顶栏与左侧导航固定,仅右侧内容区滚动)。

  1. 搜索框回车进入结果区知识库管理页顶部搜索框输入关键词后按 Enter(或点下拉速览里的「查看全部结果」)进入完整结果区;下拉速览仍保留,用于快速预览前几条命中。
  2. 查询语法多个关键词默认 AND(同时命中才返回);英文双引号 "…" 或中文引号「…」表示短语;大写 OR / NOT 表示或 / 排除;词尾 * 表示前缀匹配。
  3. 结果卡片与页级命中每张卡片显示标题(命中词高亮)、所在目录、更新时间,以及按页码升序列出的页命中(至多 3 条);点击页命中会打开文档并跳到对应页锚点,所在段落短暂闪烁提示位置。
  4. 过滤、排序与翻页过滤条支持按目录、更新时间(近 7 / 30 / 90 天)收窄范围,并可按相关度或更新时间排序;命中总数精确,翻页不重复、不遗漏。
  5. 键盘操作与链接分享搜索框内按 ↓ 进入结果列表,↑↓ 在卡片间移动(越过首张回到搜索框),Enter 打开,Esc 退出并回到搜索框;地址栏会携带当前搜索词、过滤条件与页码,刷新页面或把链接发给同事都能恢复到同一状态。从结果区打开的文档,标题栏提供「返回搜索结果」按钮。
  6. 首次使用自动建库空库首次检索会在后台自动建立全文索引并提示正在建库,稍候自动重试出结果;极少数运行环境缺少 FTS5 组件时,自动回落到旧版搜索并在结果区如实标注。

原件保留与下载

上传 PDF、Word 等需要转换的文档时,系统会在知识库中保留原始文件(直接上传的 Markdown / 纯文本不再重复保留)。文档查看器提供「原件」按钮,可下载原始文件;删除进回收站、从回收站恢复、彻底删除、移动分类时,原件都随文档一起走。知识库统计行会单独显示原件占用的体积。

边界说明:检索范围限定当前租户知识库;系统文件(索引、日志、隐藏目录、图片资产)不参与检索;按相关度排序的命中超过内部上限(2 万行)时按排名截顶并在结果区以横幅如实披露,命中总数仍然精确;功能上线前已入库的存量文档无原件可回溯(原件保留只对新上传生效)。管理员可通过管理接口重建索引(幂等,不影响在线检索)。

9.4 记忆管理

记忆列表区分 Global、Daily 等类型,可查看文件名、大小和更新时间。长期记忆用于稳定偏好与事实,日常记忆用于时间上下文;修改共享记忆前要评估对其他会话的影响。

图 53 · 记忆管理。记忆与知识库用途不同:前者偏时间线和长期上下文,后者偏可引用、可分类的企业文档。

9.5 AIP TALK 知识库的图文召回

文档入库时系统会抽取其中的图片并生成图注与向量索引;在 AIP TALK 提问时,相关图片随回答一并召回,内嵌在对应说明位置(图文混排),而不是堆在回答末尾。页脚来源块会注明图片出自哪份知识库文档。

  1. 入库即建图索引上传 PDF、Word 或图片文档后,系统自动抽取文中图片(含矢量图表页的整页渲染),由视觉模型生成图注并建立索引;等处理状态结束后再验收图片召回效果。
  2. 提问时说明要图直接说“产品图片或指南图片”“把安装步骤的图发我”等;系统按语义召回匹配图片并内嵌到对应段落,点击可放大查看。
  3. 图文混排与来源脚注图片紧跟对应说明段落并带图注,页脚来源块注明出自哪份文档(如“RSP 系列用户手册 VERSION A3”);图片随回答持久化,刷新和历史回填后仍在。
  4. 典型场景产品手册查阅、医学/工程影像资料对照、车间现场维保:语音提问后,云端从设备维保知识库召回工程图纸与排障步骤,同步到智能看板大屏。
图 54 · 产品手册图片召回。询问“产品图片或指南图片”,回答从 RSP 系列用户手册(VERSION A3,2025-09-19)召回安装与展开步骤图,内嵌在对应说明位置。
图 55 · 专业知识图文混排。口腔正畸问答中,诊断要点、方案表格与 X 光影像按上下文混排呈现;影像图片召回自知识库文档的原位插图。
图 56 · 车间现场工程图纸召回(场景示意)。工人语音提问后,云端从设备维保知识库召回工程图纸与标准化排障步骤,实时同步到智能看板大屏。

9.6 多源同步中心:让外部文档库自己走进知识库

知识库管理页顶层分为两层:「文档知识库」(上传/抓取/检索的既有面板)与「多源同步中心」。同步中心把外部文档系统登记为同步单元——首次全量,此后按设定间隔自动增量:新增/修改自动入库,源端删除自动移除(tombstone),中断自动断点续传。当前支持 SharePoint、飞书文档、Google Drive 三源(操作手册见 9.7–9.9);卡片行中的 ELO、Confluence、钉钉文档等为「即将上线」占位。

  1. 选源建单元顶部源卡片行选择源类型(已上线源卡片显示「{n} 个单元」计数),在对应面板点「新建同步单元」;卡片行缺省显示 7 张,点「更多 +n」展开全部,再点「收起」还原。
  2. 示意图可折叠顶部示意图右上角有折叠/展开按钮:折叠后仅留一条细条占位,需要时再点展开;折叠偏好跨会话保留。
  3. 三源共享同一套语义目标分类、同步间隔、单文件大小上限、OCR 开关、内容指纹幂等(同字节内容不重复入库,记为 unchanged)、健康状态口径(ok / degraded / error / stale)完全一致——学会一个源即会用所有源。
维度SharePoint飞书文档Google Drive
同步根站点 + 文档库路径云空间文件夹或 Wiki 知识库空间我的云端硬盘文件夹或共享盘
认证Entra 应用(Tenant / Client ID + Secret)飞书应用(App ID / App Secret)服务账号 JSON(可域级委派)或 OAuth 三件套
增量机制Graph delta 原生增量全量列表 + 本地 diff 逐轮比对changes.list 原生 delta(pageToken 断点)
删除一致性周期对账发现源端缺失即移除事件订阅即时移除 + 全量 diff 对账兜底removed/trashed 标记即时移除,免对账
近实时按同步间隔轮询事件订阅:删除即时,编辑/新建 15 秒防抖触发按同步间隔轮询(delta 拉取开销低)
正文车道文件下载后标准抽取,扫描件走 OCR新版文档 raw_content 快车道;旧文档/表格/幻灯片走导出车道;云空间文件直接下载Google 文档/表格/幻灯片导出为 Office 或纯文本;二进制文件下载前先做大小预闸
特色边界IRM 保护或超限文件记入 skipped 并注明原因多维表格默认跳过——结构化数据请走「数据源编排」的飞书多维表格连接器(NL2SQL 问数平面)文件夹根按父链判定归属,移出根目录视同删除

接入之后的统一效果

所有源(含手工上传与网站抓取)走同一条入库管道:抽取正文与图片 → 落为带来源脚注的知识库文档 → 立即建立向量与全文双索引。因此——统一搜索:管理面全文检索与 AIP TALK 问答检索覆盖同一库,同步文档与手工文档无差别命中;RAG 增强:知识类提问先查库再答,相关图片随答案图文混排;统一输出:答案末尾自动附「知识库」出处,文档脚注带源系统深链,可一键跳回 SharePoint / 飞书 / Google Drive 原文。唯一时序差异:图片图注异步生成,大文档同步后稍候才参与图片召回。

权限边界(三源共同):同步解决的是「文档进得来」——源系统原有的访问权限不会自动映射进来,同步文档的可见范围按知识库分类的既有规则控制,需要在本系统侧重新声明。部署运维页(12.5)的同步监控当前覆盖 SharePoint 单元;飞书文档与 Google Drive 单元的健康状态在各自面板的单元列表与运行史中查看。

9.7 SharePoint 同步单元

「多源同步中心」把 SharePoint 文档库登记为同步单元:首次全量,此后按设定的间隔自动增量(Graph delta)——新增/修改自动入库,源端删除经周期对账自动移除(tombstone),中断自动断点续传。同步进来的文档落在指定分类,与手工上传的文档一样参与检索与图文召回(9.5);三源共享的语义与统一效果见 9.6。

  1. 准备 Entra 应用注册应用并授予 Graph 站点读取权限(Sites.Read 等,需管理员同意),拿到 Tenant ID / Client ID / Client Secret;详见 docs/sp-sync-setup.md。
  2. 新建同步单元知识库管理 →「多源同步中心」层选择 SharePoint 卡片:填写站点主机(如 contoso.sharepoint.com)、站点路径(如 /sites/contracts)、三项凭据、目标分类、同步间隔与单文件大小上限,按需开 OCR。
  3. 先手动同步验证保存后点「立即同步」,等状态变为 ok / degraded 后到目标分类核对条目;degraded 表示部分条目失败,单元详情列出逐项原因。
  4. 交给周期增量到达间隔自动跑增量;想暂停直接把单元停用——停用后不参与调度,也不计入同步监控的最差聚合(12.5)。
源端变化同步行为备注
新增/修改文件按 delta 增量入库或更新同字节内容已在库时只挂映射、不重复入库(内容指纹幂等,统计记为 unchanged)
删除文件知识库对应文档同步移除(tombstone)移除的是同步映射与 KB 条目,SharePoint 源端不受影响
纯改名删旧标题文档、以新标题重入库保证 KB 标题与源端一致;纯元数据变化只刷新映射
中断/失败断点续传,下一周期自动接力大小超限、类型不支持、IRM 保护的条目记入 skipped 并注明原因
权限边界:同步解决的是「文档进得来」——SharePoint 原有的站点/文件级权限不会自动映射到 SebAgent,同步文档的可见范围按知识库分类的既有规则控制,需要在 SebAgent 侧重新声明。状态口径:ok(全部成功)/ degraded(部分失败)/ error(整体失败)/ stale(超过 2×间隔 + 5 分钟未执行,见 12.5 同步监控)。

9.8 飞书文档同步

把飞书云空间文件夹或 Wiki 知识库空间登记为同步单元。飞书没有原生增量接口,系统每轮拉取全量列表在本地比对(新增/修改/改名/删除一轮全判,收集完整才对账,中途异常不会产生误删);若飞书应用配置了事件订阅,删除事件即时移除对应文档,编辑/新建事件 15 秒防抖后触发一次同步——轮询兜底与事件加速并存。新版飞书文档(docx)走 raw_content 纯文本快车道,旧版文档/表格/幻灯片经导出车道转换,云空间普通文件直接下载,扫描 PDF 走 OCR 车道。

  1. 准备飞书应用凭据在飞书开放平台创建企业自建应用,开通云文档相关只读权限(drive / docx / wiki),拿到 App ID / App Secret;如需事件近实时,在同一应用配置事件订阅(webhook 回调与长连接两种模式系统均已接线,且绝不影响 IM 消息收发)。
  2. 新建飞书文档同步单元多源同步中心选择「飞书文档」卡片:根类型二选一——云空间文件夹(填 folder_token)或 Wiki 空间(填 space_id,自动递归节点树);填写凭据、目标分类、同步间隔与大小上限,按需开 OCR;保存前可点「测试连接」验证。
  3. 手动同步验证点「立即同步」,等状态落定后到目标分类核对条目。多维表格(Bitable)默认跳过并计入提示——它是结构化数据,应走「数据源编排」的飞书多维表格连接器进入 NL2SQL 问数平面,两个平面互补不重叠。
  4. 交给周期增量与事件到达间隔自动跑全量 diff;源端改名会同步改知识库标题(删旧入新);需要推倒重来时可开 force_full 清空映射全量重入库——内容未变的条目按指纹幂等不重复计数。
边界:Wiki 节点本身不返回修改时间,系统会用元数据批量接口补齐,补齐失败时降级为内容指纹比对;事件类型名以飞书后台实际订阅为准;应用无权限访问的文档记入 skipped。同步监控(12.5)暂未接入飞书单元,健康状态请在同步中心面板查看。

9.9 Google Drive 同步

把「我的云端硬盘」中的文件夹或整个共享盘(Shared Drive)登记为同步单元。Google Drive 是原生增量源:首爬全量并锚定 pageToken,此后 changes.list 逐页返回变更(含 removed/trashed 删除标记,即时移除免对账);必须走完所有分页才推进水位,中途异常由内容指纹幂等兜底,下轮从断点自动续传。

  1. 准备认证(二选一)服务账号:在 GCP 创建 Service Account 并下载 JSON 密钥,Workspace 企业场景可配置域级委派(需 Workspace 管理员授权);或 OAuth:准备 Client ID / Client Secret / Refresh Token 三件套。凭据内容支持 env: 变量引用,不明文落库。
  2. 新建 Google Drive 同步单元多源同步中心选择「Google Drive」卡片:根类型二选一——文件夹(填 folder ID)或共享盘(填 drive ID);选择认证方式并填入凭据;Google 文档可选导出为纯文本或 Word;保存前点「测试连接」验证。
  3. 手动同步验证点「立即同步」跑首爬:Google 文档/表格/幻灯片自动导出为文本或 Office 格式入库,PDF 等二进制文件下载前先做大小预闸,超限记入 skipped;扫描 PDF 走 OCR 车道。
  4. 交给原生增量到达间隔自动跑 changes.list;文件夹根场景下文件移出根目录视同删除、知识库对应文档同步移除;共享盘场景自动包含盘内全部内容。
边界:v1 不接 Google push 通知(需要公网端点与频道续期),原生 delta 轮询已足够高效;域级委派需要客户 Workspace 管理员配合授权;配额限流(429)自动退避并把单元状态记为 degraded。同步监控(12.5)暂未接入 Google Drive 单元。

9.10 科学表达兼容性:任意写法皆可命中

企业文档中的科学、医学、化学、工程表达形态复杂:同一个「水」可以写作 H₂O、H2O、H2O 或 H_2O;α 与 alpha 并存;检验报告里满是 ↑↓±。通用知识库对这些符号的默认行为是丢弃或截断(主流搜索引擎的标准分词器会把 ° ± ↑ → ⇌ 当作不可检索的噪声,朴素分块器会把公式从中间切开)。本知识库通过「形态归一 × 结构原子化」双闸解决——默认不可搜的,我们可搜;默认被截断的,我们整体保护:索引与查询同口径规范化(原字符保留并追加别名),公式/表格/代码块作为原子单元永不截断;snippet 展示永远使用原文形态。

表达家族支持的形态示例检索效果
希腊字母与分型记法α / alpha、ο / Omicron、融合记法 α1↔alpha1、μg↔ug查 alpha受体 命中写有 α受体 的文档,反之亦然
化学式与反应符号H₂O / H2O / H2O / H_2O、¹⁴C、⇌(可逆)、↑↓(气体/沉淀)、−(负号)四种水的写法互命中;方程式符号可检索
医学符号与单位℞→Rx、μg↔ug、↑↓(血压↑)、±(8.2±1.1)、Ⅳ期处方、检验报告、统计记法都可按符号或别名检索
数学/物理公式$$…$$ 与 \[…\] 展示公式、行内 $…$、LaTeX 记法 x^2↔x²、ΔG°=−RT ln K公式块永不从中间截断,且带章节链前缀获得语义锚点
工程与计量⌀10↔Φ10、500㎡↔m2、85℃↔85°C、½↔1/2、5′8″↔5'8"、‰/‱图纸、面积、温度、分数、英制写法跨形态互通
数字与元素别名三单匹配↔3单匹配、第十二条↔12月、Fe↔铁、氯化钠↔NaCl、补钙↔Ca计数语境数字互认(虚指不展开);元素双向别名带精度护栏
开关与演示:「AIP TALK设置 → 知识检索形态归一(科学符号兼容)」默认开启,支持按租户覆盖;仅作用于查询侧、即时生效、无需重建索引,关闭即降级为通用字面检索(用于演示对比或应急止血)。开箱演示语料见 samples/knowledge-symbol-demo/(含 CHEAT-SHEET 对照表)。路线图(后续支持,随市场节奏):德语 ä/ö/ü/ß 与 ae/oe/ue/ss 互通、繁简归一、扫描件图片公式增强识别。
10

MOE多专家技能、洞察与决策复盘

用不同思维框架拓宽分析角度,再把关键判断沉淀为可复盘记录。

10.1 MOE多专家技能

按分类选择传奇导师、科学思维、战略管理、投资、军事等框架,用于评审方案、梳理假设和生成问题清单。MOE 提供的是分析视角,不是实时数据源;涉及经营数字时仍应回到 AIP TALK 或数据源查询核验。

图 57 · MOE多专家技能目录。先选适合问题的框架,再提供明确背景、约束和期望输出。

10.2 洞察中心

洞察中心按即时、每周、月度、空闲和 AIP TALK 等来源组织问题。系统生成的问题用于启发排查,不应直接视为已验证结论;点击问题后仍需查看查询过程和依据。

页面布局左侧是洞察问题列表,可按「全部 / 即时问题 / 每周复盘 / 月度复盘」筛选;顶部「生成问题」提供三种模式——从对话历史生成、围绕单次查询生成即时问题、生成周/月复盘问题。右侧上方是总洞察数、已验证、待验证、问题数四张统计卡,下方是洞察卡片网格;相关开关在「洞察分析 > 洞察设置」。

  1. 查询后自动提取洞察卡片在数据查询页执行自然语言查询后,系统会在后台自动提炼趋势、异常、关联、建议类洞察并进入「待验证」队列(可在洞察设置中关闭「自动提取洞察」)。卡片只是候选结论,需要人工点击「验证」后才计入已验证。
  2. 回答问题沉淀洞察回答洞察问题时,若回答中包含建议、关联类判断(如“建议…”“因为…导致…”),系统会自动把该回答沉淀为待验证洞察卡片,形成“提问→回答→沉淀→验证”的闭环。
  3. 每周/月度复盘问题点击「生成问题」选择「生成复盘问题」,按周或按月基于对话历史生成更深层的复盘问题;洞察层级的问题可进入线程式深挖对话。
  4. 按用户隔离问题与洞察卡片按当前登录用户隔离展示;升级前的历史数据对全员可见。统计卡片与列表为全量口径,非时间窗口。

日常操作点击问题卡上的「回答」提交你的业务判断——含建议或关联类结论的回答会自动沉淀为待验证洞察。每张洞察卡片带类型徽章(趋势 / 异常 / 关联 / 建议)与状态标记(琥珀色时钟=待验证,绿色对勾=已验证);确认无误点「验证洞察」计入已验证,噪声卡片随时可「删除洞察」。

洞察设置在「洞察分析 > 洞察设置」可调:「自动提取洞察」开关(默认开启;提取在后台线程进行,不拖慢查询响应)、「置信度阈值」滑块(默认 70%,低于该值的提取结果不落卡),以及即时反问、定期复盘、空闲触发等生成时机开关。

图 58 · 洞察中心。数量表示待探索的问题,不代表异常数量或风险已经成立。

10.3 决策复盘

  1. 标记关键回答在 AIP TALK 消息操作中使用图钉,保存当时的判断依据。
  2. 补充决策上下文记录为什么选择该方案、使用了哪些假设以及预期结果。
  3. 生成复盘报告实际结果出现后,回到“决策复盘”对比预期与实际,形成后续改进。
图 59 · 当前账户暂无决策记录时的真实空状态。先在消息上标记,列表才会有内容。
11

通用控制台

管理普通对话、模型、技能、记忆、通道、定时任务和运行日志。

11.1 普通对话

普通“对话”适合通用 Agent 任务,可调用文件、终端、浏览器、知识、技能等工具;AIP TALK 则更聚焦企业问数和跨源语义。选择入口时先判断任务目标,避免把通用讨论当成实时数据查询。

图 60 · 普通对话首页。顶部会话工具和历史记录与 AIP TALK 分开理解。

11.2 模型与配置

“模型”统一管理厂商凭据及主模型、图像理解、语音、向量和搜索能力;“配置”用于更底层的 Agent 参数和安全设置。修改后先做一条简单问答和一条实际业务问数,确认模型能力、延迟和来源脚注均正常。

图 61 · 模型管理。厂商名称可见不代表凭据有效;保存前应使用测试能力,并妥善保护 API Key。

11.3 技能与工具

内置工具是原子能力,Skill 是可复用的工作流。技能页支持搜索、启停和探索技能广场。安装第三方 Skill 前应审查来源、权限和工具调用范围,不要因“功能需要”而放宽无关系统权限。

图 62 · 技能管理。禁用关键工具可能同时影响普通对话和 AIP TALK,变更后需回归验证。

11.4 通道、定时任务与日志

通道页管理微信、飞书、钉钉、企微智能机器人、企微自建应用、QQ 机器人、微信客服、公众号、Telegram、Slack、Discord、Microsoft Teams、WhatsApp、Messenger、Instagram、Google Chat 等全部消息入口(五个海外通道的接入步骤见 11.6)。顶部「快速接入」区以产品 LOGO 平铺所有通道类型,默认完整展示、无需展开,点击图标即进入对应的扫码或凭据填写流程;也可以点右上角「接入通道」从下拉框选择类型。已接入通道以卡片展示运行状态与配置,修改凭据保存后即生效。定时任务页展示计划、下次执行和启停状态;日志页用于实时排查,但日志可能包含内部路径、账号或请求细节,分享前应脱敏。

接入通道的价值在于「对话即洞察」:业务同事无需登录控制台,在日常 IM 里即可直接向企业 AI 大脑提问——在飞书群里 @机器人 问「本月各区域销售额排名」,或在 Discord 私聊里问「上季度出货量同比多少」,系统按提问者的身份与数据权限完成问数,把答案、图表和结论发回会话。数据洞察随日常对话触达一线员工,不增加新系统的学习成本;群内默认 @ 或回复触发,私聊直接提问即可。

通道按归属分三层:默认层由系统管理员维护,存于全局配置;租户共享通道由租户管理员创建,全租户成员可用;个人通道由每位用户自助绑定自己的飞书 / Telegram / Discord / QQ 账号,仅本人可见可用,对话身份、记忆与数据权限均按本人计算。非系统管理员打开本页时,列表按「我的通道 / 租户通道 / 成员个人通道」分区:租户管理员可在第三区查看成员通道的归属与状态并强制断开(滥用治理),但看不到也无法修改成员凭据。个人通道默认每人最多 3 个,全租户同时运行的通道默认不超过 50 个。

图 63 · 通道管理。顶部「快速接入」区平铺全部通道类型,点击 LOGO 即可接入;断开通道会影响外部消息收发,操作前确认使用方和维护窗口。
页面常见操作变更后检查
配置模型/Agent 参数、安全设置。登录、问答、工具调用和数据权限。
定时查看计划、下次运行、启停和编辑。时区、执行账户、目标通道和实际运行记录。
日志按级别筛选实时日志。先定位时间和错误,再决定是否需要管理员介入。

11.5 过程脉络与链路详情:一次问答的全程追踪

主聊天与 AIP TALK 在回答涉及工具调用的问题时,会在答案上方显示「过程脉络」工作面板:当前阶段与已完成的工具步骤逐条列出。面板右上角的「链路详情」开关可进一步展开本次问答的完整调用链——run_id、Token 合计、每个 LLM 调用与工具调用的耗时逐行呈现。

  • 面板何时出现只有真正调用了工具(查数、检索、生成文件等)的问答才显示面板;纯闲聊的快速回答不显示。
  • 链路详情看什么run_id 是这次问答的全链唯一凭据;span 行逐条列出 LLM 调用(模型、耗时、Token)与工具调用(名称、耗时),顶部汇总 Token 合计——排查“这次为什么慢、为什么错”先看这里。
  • 谁能看链路数据仅限会话本人查看(系统管理员除外);面板在答案开始输出后自动收起,不影响正文阅读。
图 64 · 「链路详情」展开态。run_ab5d… 为本次问答的 run_id;下方逐行为 LLM 调用(模型、毫秒)与工具调用,顶部汇总 Token。

11.6 海外主流通道接入:Teams / WhatsApp / Messenger / Instagram / Google Chat

面向海外与跨境团队的五个消息通道,全部为 Webhook 回调形态:平台方主动把消息推送到控制台,因此控制台必须具备公网可达的 HTTPS 地址(内网演练可用 ngrok / cloudflared 隧道临时暴露)。接入步骤一致:在通道管理页点击对应 LOGO 填入平台侧凭据(secret 类字段加密落盘),再把回调地址与端口填回平台后台。各平台后台的配置截图位已预留,随首次客户接入逐步补入。

Microsoft Teams 消息 Bot(端口 9893)

① Azure Portal 注册 Bot(Bot Framework),取得 App ID 与客户端密钥;② 通道管理 → Teams 磁贴填入 App ID 与密钥;③ Azure Bot 的「消息终结点」填 https://<域名>:9893/api/messages;④ 若需在 Teams 客户端内使用,把 App ID 填入 Teams App 清单的 bots 段(与既有 Teams Tab 共存,见 12.3)并上传。频道与群聊中 @机器人 提问,私聊直接提问;入站逐一校验平台签发的 JWT,验签失败一律 401 并记日志。

WhatsApp Business Cloud API(端口 9894)

① Meta 开发者后台创建应用并开通 WhatsApp,取得 phone_number_id 与永久访问令牌;② 通道管理 → WhatsApp 磁贴填入两者,并自定义一段 Verify Token;③ Meta 后台回调地址填 https://<域名>:9894/webhook,Verify Token 与磁贴一致,订阅字段勾选 messages。注意 24 小时客服窗:用户来消息后 24 小时内可自由回复;窗口外主动推送需模板消息(本期未开放,定时任务推送会被拒绝并记日志)。图片/文档/语音消息会自动下载落库。

Facebook Messenger(端口 9895)与 Instagram DM(端口 9897)

两者共用同一 Meta 应用与协议:Messenger 填 Page ID 与 Page Access Token;Instagram 填 IG 专业账号 ID 与 Page Access Token(IG 账号须先绑定 Facebook 公共主页并开通消息 API)。Verify Token 自定义,回调地址分别为 https://<域名>:9895/webhook 与 https://<域名>:9897/webhook,订阅 messages 字段。同一 Meta 应用的双平台回调会互投,系统按 object 字段自动路由到对应通道实例。Instagram 正式上线前需通过 App Review,此前仅测试用户可对话;两通道同样受 24 小时窗口约束。

Google Chat(端口 9896)

① GCP 控制台启用 Google Chat API,创建 Service Account 并下载 JSON 密钥;② 通道管理 → Google Chat 磁贴粘贴 JSON 全文与 GCP 项目编号(Project Number,非项目 ID);③ Chat API 配置的 App URL 填 https://<域名>:9896/webhook。空间中 @机器人 提问,私聊(DM)直接提问;出站经 Service Account 换取访问令牌异步发送,不占 Google 回调响应预算。Google Chat 无 24 小时窗口,定时任务可直接推送到已加入的空间。

12

系统管理与个人中心

以最小权限管理租户、用户、角色、集成、全局问答行为、部署运维与用量计量。

先明确作用域再操作。系统级、租户级和个人级配置可能同名但影响范围不同。生产环境执行创建、删除、重置密码、角色分配、代运维或清理审计前,应遵守本企业审批流程。
本章的读写分界:12.1–12.7 与 12.9–12.10 面向管理角色——左侧「系统管理」/「管理」菜单组仅系统管理员(Super Admin)与租户管理员(Tenant Admin)可见,普通用户不会看到该组;其中标注「仅系统管理员」的入口(租户管理、部署运维、第三方集成设置、AIP TALK 设置)对租户管理员也不可见。12.8 个人中心面向所有登录用户。菜单隐藏只是界面便利,全部权限均由后端接口强制校验,无法通过直接访问地址绕过。

12.1 角色与权限

当前内置角色包括 Super Admin、Tenant Admin、Data Analyst 和 Data Viewer。角色决定菜单可见性和后端权限,但具体数据仍受租户、数据源 ACL、共享范围、字段/行级策略和敏感表策略共同约束。

用户数据属性:角色之外,每个用户还可携带一组「数据属性」键值(如 workshops = [一车间, 二车间]),供行级权限策略按属性过滤数据行(见 5.12)。管理员在 系统管理 → 用户管理 → 编辑用户 的「数据属性」区手工维护;接入了第三方集成的租户,更常见的是由第三方系统在登录断言中声明、随登录自动同步(见 12.3.7),手工维护的键与同步的键互不影响。

下表逐项列出「系统管理」菜单组各入口的角色门槛与数据作用域——哪些功能仅限系统管理员,以表中「—」为准:

菜单系统管理员租户管理员
租户管理✓ 全部租户—
用户管理✓ 全部租户✓ 仅本租户
角色权限✓ 全部租户✓ 仅本租户
Skill 管理✓ 全局与全部租户✓ 仅本租户
审计日志✓ 全部租户✓ 仅本租户
用量计量✓ 全部租户✓ 仅本租户
部署运维✓—
第三方集成设置✓—
AIP TALK 设置✓—
API开发指南✓✓
系统上限配置✓ 全部租户✓ 仅本租户(全局只读)
数据脱敏✓ 全部租户✓ 仅本租户
图 65 · 角色权限。系统角色通常不应直接改坏;需要新能力组合时,优先创建和验证自定义角色。

12.2 系统管理页面速查

页面用途高风险操作
租户管理创建、筛选、启停和切换租户。停用、切换工作身份。
用户管理创建用户、分配角色、重置密码、维护数据属性(行级权限取值来源)。删除、重置密码、提升权限、清空数据属性。
角色权限维护角色与权限集合。修改系统角色、扩大数据范围。
Skill 管理维护全局/租户/个人 Skill 配置。全局禁用、引入不可信技能。
审计日志查询和导出安全事件。清理、导出含敏感信息的日志。
第三方集成设置SSO 发行方、嵌入来源、角色/数据属性同步映射和示例工程。放宽 allowed_origins、更换签名配置、扩大同步的角色与属性范围。
AIP TALK 设置统一控制来源显示等问答行为。关闭来源显示影响可核验性。
部署运维(仅系统管理员)查看服务器性能与运行状态、活跃用户与并发、文件存储分布;按时间范围预览并清理历史对话文件,配置定期自动清理。执行清理、开启定期清理(文件删除不可恢复,先预览)。
用量计量按租户/用户/模型/场景统计大模型 Token 用量与费用估算,支持周/月/季/年/自定义报表与 CSV 导出;维护计量开关、保留期、汇率与单价。关闭计量、修改单价/汇率、联网刷新价格(写操作仅系统管理员)。
API开发指南OpenAPI 规范、服务器地址、连接测试、AIP TALK SSO/嵌入说明与示例代码。无(只读文档页)。
系统上限配置集中调节上传、查询/导出行数、并发防护与爬站等 19 项系统上限;支持租户级导出行数覆盖,全部热生效无需重启。超出建议阈值的上限修改(标红、需逐条确认);租户级覆盖的新增与删除(全局写操作仅系统管理员)。
数据脱敏管控发给云端大模型的内容:按数据源扫描并确认敏感字段,主体假名化、联系方式抑制,金额保持可计算;本地执行与界面显示始终为真实值。关闭已生效数据源的脱敏(出境恢复明文,需走审批)。

为保护真实账户信息,本手册不展示本机用户清单、租户联系信息、审计明细或第三方密钥。

12.3 第三方集成设置:SSO 单点登录与 iframe 嵌入

这部分用于让一个已有的企业系统(例如 ERP、OA、CRM 或数据门户)把自己的用户带进 AIP TALK,而不必让每个人再维护一套 SebAgent 密码。典型效果是:用户登录 ERP 后打开“AI 问数”页面,页面中的 iframe 自动以其本人、其所在租户和既定角色进入 AIP TALK。

用户浏览器                 第三方服务端                         SebAgent
    │  已登录 ERP/OA             │                                   │
    │  请求打开 AI 问数           │  1. 用共享 Secret 签发 HS256 断言  │
    │───────────────────────────▶│  2. POST /api/v1/sso/token       │
    │                            │──────────────────────────────────▶│
    │                            │  3. 返回 SebAgent v2 token        │
    │                            │◀──────────────────────────────────│
    │  4. 返回带 token 的 iframe 地址                                  │
    │◀───────────────────────────│                                   │
    │  5. iframe 打开 /embed/aip-talk?token=...                       │
    │───────────────────────────────────────────────────────────────▶│
先分清两个地址:audience 指 SebAgent 自己的服务地址;allowed_origins 指放置 iframe 的第三方父页面地址。把二者填反,是集成时最常见的配置错误之一。

入口为 系统管理 → 第三方集成设置,仅系统管理员可见。开始之前,应启用多用户模式,并确认第三方服务端和浏览器都能访问 SebAgent;生产环境还应确认 HTTPS、反向代理和上传限制已正确配置。

12.3.1 配置项逐项说明

配置项它回答的问题填写要点
issuer_id哪一个外部系统发行了这条断言?每个外部系统一个稳定 ID,只能含字母、数字、下划线和横线,例如 demo_erp。JWT 的 iss 必须完全一致。
audience这条断言准备给哪个 SebAgent 服务使用?通常填 SebAgent 基础 URL,不带页面路径,例如 http://127.0.0.1:9899。JWT 的 aud 必须匹配它或某个附加受众。
secretSebAgent 凭什么相信断言确实来自该系统?点击“自动生成”,只交给第三方服务端安全保存;双方必须使用同一份 HMAC 密钥。不要写进浏览器 JavaScript。
allowed_origins哪些网页可以把 AIP TALK 放进 iframe?每行一个完整 origin:协议 + 主机 + 端口,不带路径、不支持通配符。例如 http://127.0.0.1:6001。留空表示不限制嵌入来源,生产环境不建议留空。
additional_audiences同一 SebAgent 是否还经其他地址被访问?把局域网 IP、域名等其他可达基础 URL 每行一个列出。断言的 aud 与主受众或任一附加受众匹配即可。
tenant_mapping外部组织 tid 对应哪个 SebAgent 租户?JSON 对象,键是外部租户 ID,值是本地 tenant_id。未命中时才考虑按外部链接查找或自动创建。
user_mapping外部用户 sub 对应哪个 SebAgent 用户?JSON 对象,键是外部用户 ID,值是本地 user_id。映射用户必须属于本次解析出的同一租户。
自动创建未映射用户(JIT)首次见到外部用户时是否自动建号?关闭即严格模式,仅显式映射或历史已开通用户可登录;生产环境推荐关闭。
自动创建未映射租户首次见到外部组织时是否自动建租户?自动创建的 ID 为 ext:<issuer>:<tid>。生产环境若需先配置数据源和权限,应关闭并显式映射。
同步属性 / 默认角色登录时同步什么资料,自动建号时给什么角色?同步仅更新 display_name/email,不覆盖已有用户角色。自动建号时优先使用断言中的 roles,未携带时才使用默认角色。
同步角色 / role_mapping第三方声明的角色要不要随登录覆盖式同步?开启后,断言 roles(外部角色名)经 role_mapping 翻译为内部角色:新增补授、消失回收,只回收同步来源角色,管理员手工授予的角色不受影响。未映射的外部角色忽略,映射到不存在角色也按未映射处理。JSON 对象,如 {"ws_operator": "tenant:user"}。
同步用户属性 / attribute_mapping第三方声明的数据属性要不要随登录同步?开启后,断言 attrs 中只有 attribute_mapping 左键列出的键会写入用户数据属性(行级权限的取值来源,见 5.12);上次同步但这次未声明的键被移除。JSON 对象,如 {"workshops": "workshops"}。两个同步开关缺省关闭,不配置时行为与旧版完全一致。
AIP TALK 页面文案嵌入页显示什么品牌标题和欢迎语?可分别设置头部标题、副标题和初始提示语;留空使用缺省值,保存后刷新嵌入页。

12.3.2 完整示例:把本机 demo_erp 嵌入 AIP TALK

下面是不使用省略号的同机联调示例,三方地址含义如下:

组成示例地址 / 值说明
SebAgenthttp://127.0.0.1:9899签发断言的 aud,也是换 Token 和嵌入页的基础地址。
第三方前端http://127.0.0.1:6001真正放置 iframe 的父页面,所以要加入 allowed_origins。
第三方后端http://127.0.0.1:6002保管 Secret、签发断言并换 Token;它不是 iframe 父页面,因此不必因这个端口单独加 origin。
外部用户 / 组织alice / acme-corp分别进入 JWT 的 sub 和 tid。
  1. 新增发行方点击“新增发行方”,填写 issuer_id = demo_erp、audience = http://127.0.0.1:9899,点击“自动生成”创建 Secret。
  2. 限制嵌入页面在 allowed_origins 填入 http://127.0.0.1:6001。如果同一服务还要通过 http://192.168.0.151:9899 访问,把它加入 additional_audiences,而不是加入 allowed_origins。
  3. 选择开通方式同机首次联调可暂时开启自动创建用户和自动创建租户,默认角色填 tenant:user;映射留空。正式环境应改用后面的严格模式。
  4. 保存并准备第三方服务端新增后立即生效,无需重启。可使用“查看示例代码”或“生成示例工程”,但示例代码和 ZIP 会包含明文 Secret,只应通过安全方式交给服务端开发人员。
图 66 · 新增发行方的完整填写示例。图中演示值仅用于说明字段,未点击保存;Secret 由页面随机生成且未用于任何真实集成。联调后应按生产策略收紧自动开通。

点击发行方卡片上的“生成示例工程”后,填写下面三个值。生成器会产出包含前端、后端代理和配置说明的 ZIP:

  • SebAgent 服务地址:http://127.0.0.1:9899,写入示例工程的 COWAGENT_BASE_URL。
  • 示例前端 origin:http://127.0.0.1:6001。
  • 示例后端代理端口:6002。
图 67 · 生成示例工程的参数示例。真正点击“生成并下载 ZIP”时,系统还会把新地址同步进 additional_audiences 和 allowed_origins;本手册仅展示参数,未下载或修改配置。

12.3.3 第三方后端怎样签断言并换 Token

断言是 HS256 签名的 JWT。每条断言必须短有效期且只能使用一次;以下示例从环境变量读取 Secret,完整演示 payload、签名、换 Token 和 iframe URL 生成。

展开 Python 服务端完整示例
import base64
import hashlib
import hmac
import json
import os
import time
import uuid
import requests

ISSUER_ID = "demo_erp"
ISSUER_SECRET = os.environ["ISSUER_SECRET"]
COWAGENT_BASE_URL = "http://127.0.0.1:9899"

def b64url(data):
    return base64.urlsafe_b64encode(data).decode("utf-8").rstrip("=")

def make_assertion(external_user, external_tenant):
    now = int(time.time())
    header = {"alg": "HS256", "typ": "JWT"}
    payload = {
        "iss": ISSUER_ID,
        "sub": external_user,                 # 本例:alice
        "tid": external_tenant,               # 本例:acme-corp
        "aud": COWAGENT_BASE_URL,
        "iat": now,
        "exp": now + 60,                     # 不超过发行方允许的 TTL
        "jti": uuid.uuid4().hex,              # 每次必须不同,防重放
        "name": "Alice",
        "email": "alice@example.com",
        "roles": ["tenant:user"]
    }
    h = b64url(json.dumps(header, separators=(",", ":")).encode())
    p = b64url(json.dumps(payload, separators=(",", ":"), ensure_ascii=False).encode())
    signature = b64url(hmac.new(
        ISSUER_SECRET.encode("utf-8"),
        (h + "." + p).encode("utf-8"),
        hashlib.sha256
    ).digest())
    return h + "." + p + "." + signature

response = requests.post(
    COWAGENT_BASE_URL + "/api/v1/sso/token",
    json={"assertion": make_assertion("alice", "acme-corp")},
    timeout=15
)
response.raise_for_status()
data = response.json()
embed_url = COWAGENT_BASE_URL + "/embed/aip-talk?token=" + data["token"]
print(embed_url)  # 交由当前用户的页面使用,不写入公开日志
JWT 字段本例值校验/用途
issdemo_erp必须等于 issuer_id。
subalice外部用户唯一 ID,用于 user_mapping 或 JIT。
tidacme-corp外部组织 ID,用于 tenant_mapping 或自动建租户。
audhttp://127.0.0.1:9899必须匹配 audience 或 additional_audiences。
iat / exp当前 Unix 秒 / 当前时间 + 60 秒服务器会检查签发时间、过期时间和最大 TTL;双方时钟应同步。
jti每次随机生成同一断言或 jti 不能重复使用。
name / emailAlice / alice@example.com开启属性同步时更新显示资料。
roles["tenant:user"]缺省仅自动建号时作为角色来源;发行方开启「同步角色」后,每次登录按 role_mapping 覆盖式同步该用户的 SSO 来源角色(手工授予的角色不受影响)。
attrs{"workshops": ["一车间"]}可选。用户数据属性(行级权限取值来源),值为字符串数组;发行方开启「同步用户属性」且键在 attribute_mapping 中才会写入身份层,其余键被丢弃。
sub、tid 和 roles 必须由第三方后端根据已认证会话确定。不要让浏览器直接提交这三个值给签发接口,否则恶意用户可能冒用他人身份、切换租户或在 JIT 场景申请更高角色。换得的 v2 token 同样是登录凭据,不要硬编码、公开分享或写入日志。

12.3.4 前端怎样嵌入

第三方后端换到 token 后,为当前登录用户生成 iframe 地址。下面的 SERVER_EXCHANGED_V2_TOKEN 表示由服务端刚换得并安全传给本页的动态值,不是固定 Token:

<iframe
  id="aip-talk-frame"
  src="http://127.0.0.1:9899/embed/aip-talk?token=SERVER_EXCHANGED_V2_TOKEN"
  width="100%" height="600"
  style="border: none"
  allow="microphone"
  sandbox="allow-scripts allow-same-origin allow-forms allow-popups allow-popups-to-escape-sandbox allow-downloads">
</iframe>
sandbox 中的 allow-popups / allow-popups-to-escape-sandbox / allow-downloads 三个旗标必须保留:对话内的交互页面与 PPT/Excel/PDF 附件链接均以新标签打开(经 ?token= 参数鉴权),缺少时浏览器会静默拦截,表现为「点击链接无反应」。不要追加 allow-top-navigation——控件不应改写宿主页面地址。

也可以使用浏览器表单把 assertion POST 到 /auth/sso,成功后通过 Cookie 跳转站内 AIP TALK;iframe 场景则使用上面的服务端换 Token 方式。Token 过期或用户切换时,应重新签发一条新 assertion 并换取新 Token,不要重放旧断言。

12.3.5 生产环境推荐:显式映射 + 严格模式

自动开通适合联调,但生产环境通常需要先建租户、用户、数据源权限和角色,再允许 SSO。假设外部组织 acme-corp 对应本地租户 default,外部用户 alice 对应本地用户 usr_zhangmin,可以填写:

tenant_mapping:
{
  "acme-corp": "default"
}

user_mapping:
{
  "alice": "usr_zhangmin"
}

然后关闭“自动创建未映射用户”和“自动创建未映射租户”,分别点击“保存映射”和“保存开通策略”。这样,未登记的组织和用户会被拒绝,不会仅凭持有合法 issuer Secret 就自动获得一个全新的可用账户。

映射必须成对核对:usr_zhangmin 必须真实存在,并且属于 default 租户。如果 user_mapping 指向其他租户的用户,该映射不会生效;严格模式下最终表现为用户登录被拒绝。示例 ID 应替换为本环境用户管理中的真实 user_id。

12.3.6 联调报错怎么定位

现象优先检查处理方法
Invalid assertion signature第三方与 SebAgent 的 Secret、HS256 签名输入是否一致。重新安全分发 Secret;不要通过减少签名验证来绕过。
Assertion audience mismatchJWT aud 是否等于当前实际访问的 SebAgent 基础地址。修正 aud,或把该地址加入 additional_audiences;不要误加到 allowed_origins。
Assertion expired / lifetime exceeds TTL双方时钟、iat、exp 和断言有效期。同步时钟,每次即时签发,默认把有效期控制在 60 秒以内。
Assertion has already been used是否重复使用同一 assertion 或 jti。每次登录生成新的 jti 和新断言。
Tenant/User not found,严格模式拒绝tenant_mapping、user_mapping、本地 ID 和用户所属租户。补齐映射;或只在明确需要自动开通时开启对应 JIT。
嵌入页 403 或被浏览器拒绝显示父页面完整 origin、HTTPS 混合内容和反向代理。把父页面 origin 精确加入 allowed_origins;HTTPS 父页面不要嵌入 HTTP 地址。
能打开页面但发消息 404 / 一直等待代理是否只转发了页面,没有转发 API 与 SSE。检查 /message、/stream、/api/v1/sso/token 等路径及 SSE 缓冲配置。

12.3.7 权限同步:让第三方的角色与数据属性随登录生效

以上小节解决“人能登录”。权限同步进一步解决“权限两边一致”:第三方系统里调整了用户的角色或数据授权(例如把张三从车间一调到车间二),不需要管理员再到 SebAgent 手工改——用户下次登录时自动同步。颗粒度可以到库表的行级:配合 5.12 的行级权限策略,能做到“同一个用户只能看到特定生产车间的数据行”。

角色同步

发行方开启「同步角色」并配置 role_mapping 后,断言 roles 经映射翻译,每次登录覆盖式同步:新增补授、消失回收。只回收同步来源的角色(系统记录 sso_synced_roles),管理员在控制台手工授予的角色不受影响;同步失败不阻断登录,失败原因写入审计。

数据属性同步

发行方开启「同步用户属性」并配置 attribute_mapping 后,断言 attrs 写入用户数据属性,成为行级权限策略的取值来源。第三方改授权 → 用户重新登录 → 数据范围立即变化,无需重启服务、无需重建会话。

  1. 管理员配置绑定(一次)在「行级权限」页签把业务表的过滤列绑定到属性键(如 prod_records.workshop_id ← workshops),见 5.12。
  2. 发行方开启同步(一次)在发行方卡片「权限同步」区勾选同步开关并填写映射 JSON,保存即时生效。
  3. 第三方每次登录声明断言中携带 roles 与 attrs,SebAgent 自动完成同步与行过滤。
  4. 用回执和试算验收换 Token 响应中的 synced 字段即本次同步的落地明细(applied/revoked/unmapped/attrs);上线前可用 POST /api/v1/sso/assertion/verify 只验签预览、不产生任何写入;管理员还可在「行级权限」页签用「权限试算」查看任意用户的最终过滤条件与可见行数。
时序示例:张三首次登录断言 roles=["ws_admin"]、attrs={"workshops": ["一车间"]} → 获得映射角色且只能看一车间。一周后第三方把张三调整为 roles=["ws_operator"]、attrs={"workshops": ["二车间"]} → 张三重新登录后,旧映射角色被回收、新映射角色生效,问数结果立即只剩二车间的行;期间管理员手工授予的“数据管理员”角色原样保留。

断言字段逐个定义、三种语言(Python/Node/Java)签名示例、synced 回执逐字段说明和 dry-run 探针用法,见《AIP-TALK 客户端开发指南》(/aip-talk/client-development-guide)第 7 章「数据权限:角色同步与行级数据权限」。

12.3.8 OIDC 单点登录:企业 IdP 直连(Entra ID / Keycloak 等)

除断言式 SSO 外,系统还支持标准 OpenID Connect 授权码流:用户点击登录页的「使用企业账号登录」,跳转到企业 IdP(Microsoft Entra ID、Keycloak 或任何 OIDC 提供方)完成认证后回跳,系统按标准 claims 建/更新本地用户(JIT)。适合没有自研断言签发能力、希望直接复用企业 IdP 的租户;与断言式 SSO 并存,按租户各配各的。

配置项它回答的问题填写要点
Issuer / Discovery令牌由谁签发、去哪里验签?IdP 的 issuer 地址(如 https://login.microsoftonline.com/<租户ID>/v2.0);系统经 discovery 自动获取 JWKS 验签,支持 kid 轮换强制刷新。
Client ID / SecretSebAgent 以什么身份换令牌?IdP 侧应用注册的客户端凭据;Secret 加密存储、页面打码,配置可用 env: 变量引用,禁止明文外发。
JIT 建号与角色映射首登要不要自动建号、IdP 组映成什么角色?开启 JIT 后首次登录自动建号;group_role_map 把 IdP 组(如 SG-SebAgent-Admins)映射为内置角色,每次登录覆盖式同步——只回收同步来源的角色,手工授予的角色不受影响(语义同 12.3.7)。
登录入口与回调用户从哪里发起、IdP 回跳到哪里?入口为 /sso/oidc/<提供方ID>/login(登录页按钮自动生成);回调 /sso/oidc/<提供方ID>/callback 必须在 IdP 应用里注册,协议与主机要与站点一致。
详细配置与排障(含 Entra 应用注册、声明映射、本地 Keycloak 替身联调)见 docs/sso-oidc-login-setup.md。

12.3.9 Microsoft Teams 标签页:把问数嵌入协同现场

系统可打包为 Teams 应用(个人标签 + 团队/群聊标签):成员在 Teams 里打开「SebAgent 问数」标签,前端经 Teams SDK 换取 AAD 令牌、后端验签后自动建立会话(静默 SSO,免二次登录,复用 12.3.8 的 OIDC 验签与 JIT 链路);SSO 不可用时自动回退浏览器会话模式,不会黑屏。界面语言与主题沿用站内偏好,并跟随 Teams 深浅色切换。

  1. 注册 Entra 应用「公开 API」保持 api://<应用ID> 并添加 access_as_user 范围,预授权两个 Teams 客户端 ID(Web:1fec8e78-e543-404b-9819-b8dfff4bd51a;桌面/移动:5e3ce6c0-2b1f-4285-8d4b-75ee78787346)。
  2. 配置提供方与应用 ID新增以 teams 开头的 OIDC 提供方(issuer 指向 Entra 租户 v2.0 端点),并把 teams_app_id 设为该应用 ID(清单的 webApplicationInfo 用它)。
  3. 下载清单并侧载访问 /teams/manifest.zip 下载应用包(清单 + 图标),在 Teams「应用 → 管理你的应用 → 上传自定义应用」侧载;可加入团队或群聊标签。
  4. 验收静默登录打开标签应直接进入问数界面且身份正确;若显示浏览器模式提示,按 13.2 FAQ 与 docs/teams-tab-setup.md 排障表处理。
部署要求:Teams 只加载 HTTPS 页面;/teams/* 页面已下发 CSP frame-ancestors 白名单且不发送 X-Frame-Options——自定义反代若统一注入 X-Frame-Options,需对 /teams/* 例外,否则 Teams 内无法嵌框。

12.4 AIP TALK 全局设置

“显示数据来源”控制站内和嵌入页的合并来源块。对外分享、审计和高风险业务场景建议保持开启;关闭后新回答不再展示相应来源信息,不利于复核。

图 68 · AIP TALK 设置。全局开关同时影响站内与第三方嵌入页面,修改后应使用新回答验证。

12.5 部署运维(仅系统管理员)

「部署运维」页把服务器运行状态、使用热度与工作区磁盘占用集中到一个页面,数据实时读取、不落历史。入口为 系统管理 → 部署运维,仅系统管理员可见,租户管理员与普通用户均无此菜单。

服务器性能与运行状态

顶部展示服务器规格(CPU、内存、磁盘)以及应用自身的内存占用、线程数与运行时长;点击「刷新」重新采集,用于判断资源是否成为瓶颈。

活跃用户与并发

按请求级口径统计近 5 分钟活跃用户/会话与今日去重用户/消息——用户在控制台的任何操作都计为活跃,不发消息也算;「AIP TALK 并发执行」展示执行池的在途与排队数,触发保护性熔断时显示熔断徽章。

文件存储分布

按目录(对话记录、知识库、上传文件等)聚合文件数量与体积,帮助发现异常膨胀的目录,作为清理决策依据。

历史对话文件清理

按时间范围(清理早于近 7/30/90/180/365 天的文件)两段式操作:先点「预览」做 dry-run,列出将删除的目录、文件数、体积与最旧文件时间,此时不删除任何内容;核对无误后再点「执行清理」。

定期自动清理

设置保留天数、执行间隔与清理目标,保存后热生效、无需重启;后台调度到点自动执行与手工清理完全相同的逻辑,适合常态化的磁盘卫生。

外部系统同步监控

「外部系统同步」区一屏展示五条通道健康度:M365 身份(OIDC 提供方)、SharePoint 同步单元、Business Central、Salesforce 与 SAP 数据源。判定口径:ok(正常)/ stale(超过 2×同步间隔 + 5 分钟未刷新)/ degraded(部分失败或计数对账不符)/ error(失败)/ unknown(从未同步)/ unconfigured(未配置)/ disabled(已停用,不参与最差聚合)。监控只读探活、绝不触发建连;明细接口为 GET /api/v1/admin/sync/status。

  1. 先看运行与存储打开页面刷新一次,确认活跃用户数、并发与磁盘占用,判断是否需要清理。
  2. 先预览(dry-run)选择时间范围后点击「预览」,逐项核对列出的目录、文件数、体积与最旧文件时间,确认不会误删近期仍在使用的数据。
  3. 执行并留证点击「执行清理」,完成后记录释放空间;如需周期性执行,改用「定期自动清理」,保存配置即时生效。
清理不可恢复。被删除的历史对话文件无法从回收站找回,执行前务必先预览核对范围,生产环境建议先备份工作区。定期自动清理与手工清理共用同一逻辑,保存自动清理配置前,建议先用手工预览验证保留天数符合预期。

12.6 用量计量与费用估算

「用量计量」逐次记录每一次大模型调用的 Token 消耗(提示、补全与缓存命中 Token),并带来源场景(AIP TALK、NL2SQL、控制台聊天、知识库、系统任务)、模型、提供商与接入端点,按租户与用户聚合,让 AIP TALK 等场景各租户、各用户的消耗一目了然。计量默认开启,数据保存在独立的计量库中,默认保留 400 天,到期自动清理。

可见范围:系统管理员查看全部租户并可按租户筛选;租户管理员只看到本租户数据(服务端强制收窄,无法通过参数绕过)。计量设置、单价维护与联网刷新价格仅限系统管理员操作,且全部写入审计日志。

报表与筛选

时间范围支持本周 / 本月 / 本季 / 今年与自定义起止日期;可按场景过滤(选 AIP TALK 会一并涵盖其 NL2SQL 子调用),并按租户、用户、模型、场景、提供商或端点分组。

汇总与趋势

六张汇总卡给出总 Token、提示 / 补全 Token、调用次数、缓存命中率与估算费用;趋势图的时间粒度(时 / 日 / 周 / 月)随所选范围自适应,用于观察用量走势与突增。

分组与下钻

分组表按所选维度聚合用量;「按租户」视图下点击某个租户行,可一键下钻到该租户的「按用户」视图,快速定位消耗大头。

CSV 导出

「导出 CSV」按当前筛选条件输出逐条调用明细(UTF-8 编码,可用 Excel 直接打开),用于对账、分摊或接入自有报表。

计量设置

可开启 / 关闭计量、调整数据保留天数(到期自动清理)、设置美元折算汇率;「流式 usage 补采」默认开启,若私有化端点不支持流式返回用量可关闭。保存后即时生效,无需重启。

单价与费用估算

费用 = Token 量 × 单价。单价解析顺序:手工维护 > 联网刷新(抓取官方定价页并由系统自身的大模型抽取结构化价格)> 内置参考价(仅 DeepSeek)。每次调用在写入时定格价格快照,历史报表不随后续调价漂移;私有化部署或无价格数据的端点,费用列显示「—」。

  1. 选范围在筛选栏选择时间范围(默认本月);需要指定区间时切到「自定义」并选择起止日期。
  2. 看结构先看汇总卡与趋势图,再把分组表切到「按用户 / 按模型」定位消耗主体;系统管理员可先「按租户」分组再点击行下钻到用户。
  3. 导出与维护点「导出 CSV」留档;厂商价格变化时点「联网刷新价格」或手工维护单价,之后的新调用即按新价格快照计量。
费用是估算值。它用于横向比较与预算参考,不等同于厂商账单,请以官网账单为准。关闭计量开关后新调用不再记录,历史数据仍然保留;联网刷新失败(例如内网无外网访问)不影响计量本身,单价自动回落到手工维护或内置口径。

12.7 系统上限配置:上传、行数与并发阈值

「系统上限配置」页(系统管理菜单组)把分散在各模块的 19 项系统上限集中成一张注册表,按「上传与文件 / 查询与导出行数 / 并发与防护 / 爬站采集」四组展示与调节——例如知识库上传大小、导出行数、LLM 出向并发、单数据源并发查询、爬站页数等。全部修改保存后即时生效(热生效),无需重启服务,且全部写入审计日志。

可见范围:系统管理员可读写全局值并维护任意租户的覆盖;租户管理员只读全局值,仅可在「租户级覆盖」区维护本租户的导出行数(服务端强制钉在本租户,无法通过参数绕过)。普通用户看不到本页。
判定层级系统行为你该怎么处理
允许区间内正常保存,即时生效。按需调整即可。
超出建议阈值(标红)输入框标红并显示针对性建议;保存时逐条列出建议,确认后才写入(未确认不写入任何值)。阅读建议后自行判断「继续」或「取消」。
超出允许区间整批拒绝(400),不落半截配置。回到允许区间内再保存。

租户级覆盖:「导出行数上限」支持按租户覆盖——在页面底部「租户级覆盖」区为指定租户设置独立值,未设置的租户回退全局值;留空保存即删除覆盖。适合个别租户确有全量导出诉求的场景,不必为此放宽全局口径。生效顺序恒为租户覆盖 > 全局值 > 出厂缺省。

常见场景调整哪个参数注意点
导出经常超过 1 万行被拦导出行数上限(全局或租户级覆盖)导出在内存中拼装,建议先引导筛选/聚合。
知识库要上传超大文件知识库上传大小上限超过 1024MB 必须同步调大 nginx(见下方提示)。
更换或扩容大模型套餐LLM 出向并发闸须与供应商 TPM/QPS 配额配套,压测定容值为 32。
生产库反映查询压力大单数据源并发查询 / 用户查询速率 / 查询超时防护闸调低更稳;调高前先确认库侧余量。
外部 Agent 经 MCP 取数MCP 查询行数上限结果直接进外部模型的上下文,不宜调大。
nginx 联动提示:知识库上传上限超过 1024MB 时,页面顶部会出现琥珀色常驻横幅——反向代理 nginx 的 client_max_body_size(deploy/maintenance/nginx-9899-front.conf,当前 1024m)必须同步调大并 reload,否则请求在网关层就被 413 拦截,本设置不生效。

12.8 个人中心与会话安全

  • 通过右上角头像进入个人资料、个人 Skill、会话和活动记录;按需更新本人信息和密码。
  • 共享电脑或演示结束后退出登录;发现异常会话时及时撤销并联系管理员。
  • 代运维/切换租户后,先核对身份徽章和当前租户再提问或修改配置;结束后切回本人身份。

12.9 自动化:事件驱动的通知与任务

「自动化」页(管理菜单组)把“当 X 发生 → 自动做 Y”配置成规则,不再只靠人发消息或定时任务触发。事件源三类:外部 Webhook(第三方系统推送,HMAC-SHA256 签名校验)、数据源刷新完成、推理完成;动作三类(安全白名单):IM 通道通知、投递问数任务与页面刷新(事件驱动的已发布交互页重建)。

  1. 新建规则点「新建规则」:命名、选事件源(Webhook / 数据源刷新 / 推理完成)、填事件过滤(JSON 键值子集匹配,如 {"source_id":"erp"} 只响应该源,留空响应全部)、选动作——IM 通知(通道+接收人+消息模板)、问数任务(问题交给 AIP TALK,答案推送目标通道)、页面刷新(填页面 ID 与所有者用户 ID,可在「我的发布」查)。消息模板与问句支持 {字段} 占位符引用事件负载,如「数据源 {source_id} 已刷新,共 {table_count} 张表」。
  2. Webhook 对接「Webhook 密钥」弹层提供密钥查看/轮换与现成的 curl 示例,外部系统按 X-Automation-Tenant + X-Automation-Signature 头签名推送即可。
  3. 人工确认(可选)规则勾选“需要人工确认”后,每次触发先进入确认队列,在运行记录里逐条放行或拒绝后才真正执行——高风险动作建议开启。
  4. 运行记录每条规则保留最近 500 次触发历史,含事件内容、执行状态与结果;失败记录悬停可看错误原因。注意:卡片上的「测试」用合成事件真实执行一次(负载带 _test 标记,通知会真实投递)——先用测试群验证再上线。
  5. 功能引导页面头部的「功能引导」按钮可重放六步导览(能力总览 → 建规则 → Webhook 密钥 → 卡片操作 → 运行记录),首次进入页面自动播放一次。
图 69 · 自动化控制台。规则卡片显示事件源与动作;运行记录逐条列出触发时间、事件类型与执行状态。
安全边界:动作仅限白名单三类(IM 通知、问数任务、页面刷新),不开放任意代码执行;Webhook 入口只接受 webhook 类型事件,无法伪造内部事件;规则按租户隔离,非系统管理员只能管理本租户规则。内部事件(数据源刷新 / 推理完成)按数据源归属租户匹配规则——无归属信息的存量源归入默认租户,租户规则请用归属本租户的源验证。

12.10 评测平台:用基准集守住问数质量

「评测平台」页(系统管理菜单组)把“这题问数答得对不对”沉淀为可回放的基准:套件(Suite)包含一组用例(问题 + 期望结果),一键回放逐题核对。判定口径为 diff=0——结果行集合与期望完全一致(顺序无关、数值归一化);不设期望的用例作为冒烟用例,能跑通即过。

  1. 导入基准集点「导入基准集」,一键导入内置冻结 golden 集(如商用车队 10 题、园区 30 题、救援 10 题),幂等不重复;也可手工新建套件与用例。
  2. 选模型再回放套件详情页的「模型 A / 模型 B」下拉与「管理 · 模型配置」同源,列出所有已连通厂商的模型——命名自定义端点的条目带「自定义 · 端点名」徽章。A 默认当前主模型,选好模型后点「回放 A」或「回放 B」逐题真实执行问数,显示通过率与逐题 diff;回放以你的身份执行,敏感表、行级权限等闸门照常生效。
  3. 一键双跑并对比选好 A、B 后点「一键双跑并对比」,串行跑完两次自动生成同题集 × 双模型逐题对账。评测按「厂商 + 模型」组合钉住真实端点与凭据,与全局主模型互不干扰——跨厂商、甚至跨自定义端点的同名模型也能公平对比。运行记录带「模型 · 厂商」徽章,也可手动勾选任意两次历史运行点「对比所选」。
图 70 · 评测平台套件详情。顶部为模型 A/B 选择器与回放/双跑按钮(B 下拉中「自定义 · 端点名」条目来自模型配置里的命名自定义端点),下方为用例列表与回放记录。
适用场景:升级模型、调整 NL2SQL 链路开关、修改语义层(字典/本体)之后,用同一基准集回归一遍,通过率不掉再放行。

12.11 数据脱敏:管住发给云端大模型的每一行

采用公有云大模型时,客户最关心的往往是「我的客户名、手机号会不会原样发给模型厂商」。「数据脱敏」页(系统管理菜单组,系统管理员与租户管理员可见,仅本租户)给出确定答案:出境前由服务端「出境网关」统一处理——企业/客户/人员等主体信息替换为确定性代号(如 CUST#K7XQ2M),手机号、邮箱、证件号、银行卡号等联系方式与证件类字段不出境,金额等需要运算的数值保持原文可计算。查询在本地始终以真实值执行,界面显示也始终是真实值——脱敏只作用于「发给大模型的内容」,不改变任何结果。

  1. 打开总开关「启用本租户数据脱敏」默认关闭;打开后下方列出本租户全部数据源(未配置的数据源行为完全不变)。
  2. 逐数据源扫描对每个数据源点「扫描字段」,智能体在本地根据列名、注释、样本值识别候选敏感字段(主体标识/联系方式/金融证件号/金额数值四类),零出境。
  3. 逐一确认候选扫描候选默认按「抑制」保守处理(确认前就不会出境);管理员逐个「确认」或「打回」,候选较多时点「全部接受」一键确认全部扫描候选、再单独打回误报,也可以改动作(假名化/抑制/精度降级)或手动添加字段。
  4. 确认方案成立至少确认一个字段后点「确认方案成立」,该数据源脱敏即刻生效;也可以选择整个数据源不启用脱敏。
  5. 确认后仍可编辑随时回到字段面板增删脱敏主体、调整动作;多轮对话里出现的代号(如「只看 CUST#K7XQ2M 的明细」)会在本地执行时自动还原为真实值,不影响追问。
一致性保障:发布前系统对同一数据源以固定题集(聚合/明细/排名/WHERE 实体过滤/多轮追问代号等 30+ 题)做「脱敏开/关」双跑比对,答案(还原后)必须语义一致,且抓包断言出境内容对敏感值零明文——任一不一致即阻断发布。你在界面上看到的永远是真实值;大模型只看到代号与数值。
合规口径:假名化属于《个人信息保护法》意义上的「去标识化」而非「匿名化」——映射表保存在你自己的服务端(加密落盘),与云厂商的数据处理协议(DPA)仍需按既有流程签署。脱敏是叠加在访问控制(敏感表 Guard、行列权限)与显示脱敏之上的第三道平面,三者互不替代。
13

安全注意事项与 FAQ

先排查身份、租户、权限和数据状态,再判断是否为系统故障。

13.1 日常安全清单

账号与集成

  • 不共享管理员账号。
  • 不在文档中保存明文密码、Token、Cookie 或密钥。
  • 第三方嵌入只开放必要域名和权限。

数据与内容

  • 生产库使用只读账号。
  • 对外截图先检查用户、租户、连接和业务数据。
  • 重要结论核对来源和实时性。

13.2 常见问题

登录提示“用户名或密码错误”怎么办?
先确认用户名、密码和输入法是正确状态。若同名账号属于多个租户,完成租户选择;仍失败时由管理员检查账户状态、密码重置要求和目标租户,不要连续尝试他人账号。
为什么看不到配置、模型或系统管理菜单?
这些入口按角色门控。请核对当前租户和头像身份,确认是否处于代运维状态;需要权限时走管理员授权流程,而不是直接使用他人账户。
同租户仍看不到某个数据源,或历史问答说数据源不存在?
检查数据源是否被删除、共享范围是否包含当前租户/角色,以及当前身份是否发生切换。数据源所有者可在数据源条目上打开共享设置;已删除的数据源需要重新接入并验证历史语义映射。
驾驶舱卡片显示“无权访问数据源”怎么办?
这不是指标数值。记录卡片对应的数据源,联系所有者或租户管理员授权,并检查驾驶舱 Pack 的数据源绑定是否指向已存在且可见的源。授权后点击刷新。
回答提示“本轮未实时取数”或引用已删除数据源?
不要把该回答作为最新经营事实。新建会话或明确要求重新实时查询,确认工具实际执行并出现新的来源依据;引用已删数据源时先恢复/替换数据源和相关映射。
AIP TALK 长时间停留在思考中或发送失败?
先等待当前轮结束,避免重复提交;再检查网络、登录是否过期和模型服务状态。部署在反向代理后时,管理员还需确认 /message、/stream 路由和 SSE 未被缓冲或拦截。
知识库上传后能打开文档,但问答检索不到?
检查文件是否仍在索引、图注或深度 OCR 是否未完成、目标分类是否正确,以及提问账户是否属于同一租户。等处理状态结束后,用文档中的明确标题或独特短句做检索验证。
OCR 开关不可用或大文件立即上传失败?
OCR 不可用通常表示当前运行环境缺少对应运行时或资源不满足准入条件。大文件“秒败”还应检查反向代理请求体大小限制和错误页内容;不要只反复重试。
图表中文显示为方框,或图片/文件在嵌入页无法打开?
由管理员检查运行环境的中文字体配置、嵌入认证令牌和静态资产路由。若浏览器与登录控制台共用身份,也应排查 SSO 是否覆盖了原有会话身份。
怎样使用这份离线手册?
直接用现代浏览器打开 HTML。按 / 聚焦搜索,点击截图可放大,按 Esc 关闭;移动端使用左上角目录按钮。打印或导出 PDF 时使用浏览器打印功能,打印样式会自动隐藏目录和交互控件。
本体编排页没有出现「苏格拉底式本体工程访谈」提示?
访谈提示只在本体成熟度低于 50% 时出现,且点过“暂不”后同一会话内不再弹出。先确认所选数据源已生成本体且成熟度低于 50%;若曾点“暂不”,新开浏览器标签或清除会话存储后重新进入即可再次看到提示。
批量上传中途断了,要全部重新传吗?
不用。断点续传按文件粒度生效:重新打开上传弹窗会看到未完成批次的提示,重新选择同一批文件或文件夹后,已完成项按“文件名+大小”匹配自动跳过(服务端同时做存在性去重),只重传未完成项。注意续传记录与目标分类、入库方式绑定,换了目标分类或入库方式会按全新批次上传。
批量上传结束后提示部分文件失败,怎么办?
弹窗底部会单独列出失败文件及各自原因(如解析失败、类型不支持)。点“重试失败项”只重传这些失败文件,已完成项自动跳过、不会重复入库;点“不重试,退出”关闭弹窗并清除本批续传记录,之后可整理好问题文件再发起新批次。
为什么租户管理员能看到「用量计量」,却看不到「部署运维」?
两个页面的角色门槛不同:「用量计量」对系统管理员(全部租户)和租户管理员(仅本租户,服务端强制收窄)开放;「部署运维」涉及服务器规格、进程状态与磁盘文件清理,仅系统管理员可见。同理,租户管理、第三方集成设置和 AIP TALK 设置也仅限系统管理员。完整的菜单-角色对照见 12.1 的可见性矩阵;确有职责需要时应由系统管理员调整角色,不要共享高权限账号。
Teams 标签页打开后黑屏,或反复要求登录?
先确认站点为 HTTPS(Teams 只加载安全页面);若使用反向代理,确认没有对 /teams/* 注入 X-Frame-Options(页面已用 CSP frame-ancestors 声明允许的嵌框来源)。静默 SSO 失败时页面会自动回退浏览器会话模式并给出提示,不会黑屏;仍失败时检查 Entra 应用「公开 API」是否配置了 api://<应用ID> 与 access_as_user 范围、两个 Teams 客户端 ID 是否已预授权,并查看 /api/teams/sso 的返回信息。完整排障表见 docs/teams-tab-setup.md。
SharePoint 同步的文件在源端被删除或改名,知识库会怎么处理?
源端删除:下一轮增量同步按 tombstone 机制移除知识库对应文档。改名:删除旧标题文档并以新标题重新入库,保证两侧一致。内容未变的纯元数据改动只刷新同步映射、不重复入库;同字节内容已在库时直接挂映射(统计记为 unchanged 而非 added)——这是幂等设计,不是同步失败。行为对照表见 9.7。
调大了知识库上传上限,为什么大文件还是一上传就 413 失败?
请求在到达应用前先经过反向代理 nginx,其 client_max_body_size(当前 1024m)是更靠前的一道闸。知识库上传上限超过 1024MB 时,必须同步调大 deploy/maintenance/nginx-9899-front.conf 中的该值并 reload nginx;「系统上限配置」页在该参数超过 1024MB 期间会常驻琥珀色横幅提醒。两者都调好后仍失败,再检查上传链路中间是否还有其他代理层。
@ 智能体后收到「绑定的数据源已失效」的答复,是故障吗?
不是故障,是保护性引导。该智能体在编排页绑定的数据源已全部被删除(文件源重传会换新 ID),为避免查到错误数据,委派在入口处直接返回引导答复、不调用 LLM,并在审计中如实记为未达成。处理:租户管理员到「智能体编排」编辑该智能体,在「绑定数据源」多选中改绑到新源(卡片徽章由红点恢复绿点)后重试;若不再需要限定范围,清空勾选即恢复为通用智能体。
把「我的仪表盘」共享给同事后,他看到的数据和我一样吗?
组件取数始终以观看者自己的权限执行:共享板不会放大任何人的数据权限。行级过滤、敏感表 Guard 与角色数据范围在「我的仪表盘」的组件执行链路上原样生效——你能看到的行他不一定能看到;反之他没有权限访问的数据源组件会明确报权限错误,而不是降级成别人的口径。发布时的可见性(仅自己 / 全租户 / 指定用户)只决定「谁能打开这块板」,与数据权限是两道独立的闸。
为什么答案里不会出现真名,大模型却还能给出正确结论?
开启数据脱敏后,发给大模型的内容里,客户/企业/人员等主体被替换为确定性代号(如 CUST#K7XQ2M),同一实体的代号在同一租户内恒定,因此分组、计数、比较、排名等推理完全不受影响;金额等数值保持原文。查询在本地始终以真实值执行,回答在显示前再把代号还原为真名——你看到的答案与未脱敏时一致。手机号、邮箱、证件号等字段默认「不出境」,大模型从头到尾收不到它们。
如何增删脱敏字段,或对某个数据源不做脱敏?
在「系统管理 → 数据脱敏」中:字段面板随时可确认新候选、打回误报、删除已确认字段或手动添加字段,改动即刻生效;数据源列表里可对任一源「停用」脱敏(该源出境恢复原文)或保持从未启用。全部操作仅影响「发给大模型的内容」,本地查询与界面显示不受影响,且全部写入审计日志。
对话里出现的 CUST#XXXXXX 代号是什么,能直接用吗?
这是脱敏开启后大模型侧的实体代号。你在界面上看到的是还原后的真名;如果你想按某个实体追问(如「只看这个客户的明细」),直接用自然语言说真名即可,系统会在本地完成匹配——无需也无法手工输入代号。代号到真名的映射表只保存在你的服务端并加密落盘,不会发给模型厂商。
自动化规则建好了却从没触发,怎么排查?
按四步排查:① 确认规则开关处于启用态;② 点卡片上的「测试」发一次合成事件——能命中说明过滤与租户归属都正确(注意:测试会真实执行动作,先用测试群验证);③ 核对事件过滤:JSON 键值必须与事件负载逐一相等(子集匹配),多写一个键就可能全部不中;④ 核对租户归属:内部事件(数据源刷新 / 推理完成)按数据源归属租户匹配,规则只命中本租户事件(系统管理员的 * 通配规则除外);Webhook 推送还要确认 X-Automation-Tenant 头与签名密钥属于同一租户。每次命中的状态与错误原因都在「运行记录」里。
海外通道按指引配置完毕,为什么还是收不到消息?
按序排查:① Webhook 必须公网可达——Teams / WhatsApp / Messenger / Instagram / Google Chat 都是平台方主动回调,从外网浏览器访问 https://<域名>:<端口>/webhook(Teams 为 /api/messages)应返回 OK 文本;内网演练可用 ngrok / cloudflared 隧道临时暴露。② Meta 系(WhatsApp / Messenger / Instagram)先过 GET 订阅验证,磁贴里的 Verify Token 必须与平台后台完全一致。③ 看通道日志的验签记录:401 是平台签发的 JWT 校验失败(Teams / Google Chat),403 是 Verify Token 不符,伪造请求不会进入消息处理。④ 群聊、频道与空间里默认要 @机器人 才响应,私聊无需 @。
多源同步中心接入的文档,能被统一搜索到吗?会有 RAG 增强吗?
可以,且与手工上传的文档完全同权。所有源走同一条入库管道:抽取正文与图片 → 落为带来源脚注的知识库文档 → 立即建立向量与全文双索引。此后:① 管理面全文检索与 AIP TALK 问答都覆盖同一库(统一搜索);② 知识类提问先查库再答,相关图片随答案图文混排(RAG 增强);③ 答案末尾自动附「知识库」出处,文档脚注带源系统深链可跳回原文(统一输出)。唯一时序差异:图片图注异步生成,大文档同步后需稍候才参与图片召回。
A

附录 A · 行业扩展包(Pack Center)

把「行业语义 + 指标 + 驾驶舱 + 验收套件 + 专家团」打包成可安装、可订阅、可验收的扩展包,一次安装即可让一个真实数据源具备行业级问数能力。

A.1 扩展包是什么

一个扩展包是 config/packs/<包名>/ 下的七个 YAML 文件:pack.yml(元数据与语义契约)、ontology.yml(业务类与派生指标)、terminology.yml(术语)、functions.yml(分析函数)、dashboard.yml(驾驶舱)、governance.yml(治理规则)、scenarios.yml(验收套件)。包内所有查询都引用逻辑源(如 main_db)而非物理数据源,安装时才绑定到真实库——同一个包可以装到不同租户、不同数据库上。

语义契约(Contract)

pack.yml 声明该包需要哪些表和列(required_tables / required_columns)。安装前系统逐表校验目标数据源,缺表会明确指出;校验结果同时决定 SKU 服务项是「可用」还是「降级」。

五层引用

包可以顺带挂载技能(skills)、MOE 专家团(moe.json)与知识库种子分类(knowledge),安装后 AIP TALK 与驾驶舱立即获得行业化的问答与研判能力。

A.2 安装与异构映射

入口:左侧导航「扩展包中心」→ 选择包 → 「安装」。选择目标数据源后点「校验契约」,系统逐表给出 ✅/❌ 结果;全部通过后「确认安装」会依次完成:应用本体与术语到目标源 → 租户绑定 → 逻辑源映射。

异构映射(表名不一致时):契约校验缺表不一定是「不能装」——如果目标库里存在同义不同名的表(如包要 t_asset_room、库里叫 asset_room),缺表行右侧会出现物理表下拉框,选择对应表后点「保存映射并重验」。映射会写入包的 mappings 覆盖层,此后的校验、本体应用、驾驶舱与问数全部自动按物理表名执行,包文件中的逻辑名保持不变。

契约未通过也可以继续安装(SKU 降级):缺少的表对应的服务项会标记为「降级」,其余服务项正常可用;补齐映射或表结构后可重新校验恢复。

A.3 包工作台

点卡片进入包工作台:「概览」看包内容与绑定状态;「驾驶舱」直接渲染包内定义的指标卡与图表(执行时自动把逻辑源解析到绑定数据源);「语义」查看类/指标/函数;「验收」一键运行验收套件,逐题给出通过/失败与依据;「治理」运行治理规则;「订阅」管理 SKU 服务项。

A.4 零代码新建扩展包(Pack Builder)

租户管理员可在扩展包中心点「新建扩展包」,四步生成一个可安装的行业包:① 选源——选择目标数据源、行业方向与包名;② AI 生成——系统把库表画像交给大模型推断业务类、指标、函数与驾驶舱组件(表数超过 60 时先让模型选 12–20 张核心表,再对选中表给全列,保证大库不丢重点);③ 校订——所有生成项都经过白名单守卫(引用了不存在的表/列会被丢弃并列入警告),你可以逐项试算指标公式、删除条目、改名称与公式,也可以在顶部用自然语言让 AI 局部修订(如「把出租率改成按楼栋统计」),修订后版本号自动递增;④ 保存——落盘到租户级包目录、绑定租户与逻辑源、自动把本体应用到目标源并给出契约复核报告。

试算与批量试算

每个指标旁的「试算」会真实执行一次只读聚合查询并显示结果值;「全部试算」一次跑完所有指标,失败的项单独标红、互不影响。

覆盖保存与备份

同名包保存时会要求确认覆盖;系统自动把旧目录整体备份为 <包名>.bak-时间戳 并在结果页报告新旧版本号,保存失败会自动还原旧版本。

生成的包放在哪里:新建包落盘到工作区 packs/custom/(租户级目录,不随版本制品升级被覆盖);与内置包同名时以内置包为准。生成后可像内置包一样安装、订阅与验收。

A.5 订阅与用量配额

包工作台的「订阅」TAB 按 SKU 服务项勾选订阅范围,可为每个服务项设置月度 Token 配额;弹窗底部实时显示本租户「本月已用 / 配额合计」,帮助企业控制大模型消耗。配额是展示与自管理口径,超限不硬阻断。

A.6 内置包速览

离散制造 AI 服务包(mfg_yunshu)

17 个业务类、9 个受控指标、12 个分析函数、30 道验收题;附带设备运维/生产决策/能碳三组技能与五位 MOE 专家(设备医生、排产参谋、能碳顾问、大野耐一、戴明)。

智慧园区包(smart_park)

16 个业务类(资产/合同/欠费/能耗/工单/产业链等)、12 个分析函数、8 个驾驶舱组件、30 道验收题;附带招商/物业/能耗三组技能与四位 MOE 专家(招商参谋、运营管家、物业医生、园区能碳顾问)。

A.7 模板市场:扩展包的导出、预览与导入

包中心头部的「模板市场」把配置好的扩展包沉淀为可交付的 .cowpack.zip 便携包:已安装的包可一键导出;收到便携包后先预览校验(不安装),确认内容再导入——伙伴交付物由此可跨环境复用。

  1. 导出「交付物货架」列出当前环境全部已安装包,点「导出」即下载 <包名>.cowpack.zip(仅含 yml/json/md/txt 等声明式文件)。
  2. 预览在「导入便携包」卡片选择 zip 后先点「预览」:弹窗给出术语、语义类、指标、函数、驾驶舱、验收题等分节计数与样例,并标注冲突(内置包同 id 红色禁止、自定义包同 id 黄色升级提示);预览不落盘。
  3. 导入确认后点「确认导入」:包装入本工作区自定义根目录(packs/custom/),可绑定当前租户;内置包同 id 一律拒绝,不会覆盖官方包。
图 71 · 模板市场。左侧导入卡片先预览后导入;右侧货架对任一已安装包提供预览与导出。
图 72 · 包内容预览。分节计数 + 样例条目帮助你在安装前判断包的质量与适用性;底部冲突提示会阻止误覆盖内置包。
安全闸:便携包限 5MB、200 个条目;路径穿越、绝对路径与非白名单后缀一律拒绝;导入入口仅租户管理员及以上可用。