助手能做什么与授权
知汇向助手开放的操作,在 Nexus 助手里怎样查资料,授权能细到什么程度。
AI 助手能做什么
知汇向 Agent 开放下面的操作。它们都读取已授权的索引快照,不会写入来源系统。每个操作要求的授权动作都是「检索」,没有哪一个需要本人确认或他人审批,授权后直接调用。
| 操作 | 做什么 | 需要的授权 | 确认或审批 |
|---|---|---|---|
collections.list | 列出获授权的文库、说明和文档数量 | 知识文件或知识文件夹的「检索」 | 不需要 |
documents.list | 列出获授权的资料,带内容说明(来自正文摘录,最多 600 字)、格式、真实目录和快照版本 | 同上 | 不需要 |
document.describe | 锁定一份文档的版本,返回元信息、生效状态、分块引用和短预览 | 同上 | 不需要 |
search | 检索文字快照,返回按相关度排序的片段、命中高亮和结构化引用;可按文档、标签、格式、目录、同步时间、来源类型、生效日期筛选 | 同上 | 不需要 |
docs.search | 供核心在另一个模块(如研枢的项目)绑定的文件夹或文件范围内检索,只在调用者可读的资料里进行 | 同上 | 不需要 |
document.read | 按详情或检索返回的版本和分块引用读取快照正文 | 同上 | 不需要 |
evidence.gather | 用 1 到 5 个子查询跨授权文库收集证据,按片段去重、按文档分组 | 同上 | 不需要 |
documents.compare | 把 2 到 5 份资料的指定版本按章节、工作表、幻灯片或页对齐,给出带引用的差异摘录 | 同上 | 不需要 |
documents.similar | 找出与某份资料相似的其他授权资料,标出近似重复、另一版本或主题相近 | 同上 | 不需要 |
table.read | 按行读取表格,可选列、等值筛选,注明工作表和行号 | 同上 | 不需要 |
answer.verify | 核验回答的引用是否都是当前、可读、哈希一致 | 同上 | 不需要 |
glossary.list | 读取全局和可读文库的术语、同义词和释义 | 同上 | 不需要 |
approved_answer.search | 查找已审核、且全部引用对调用者可读的标准答案,回答前优先使用 | 同上 | 不需要 |
approved_answer.propose | 用户明确要求时,提交标准答案提议。只写入待审核草稿,不改变其他 Agent 能看到的内容 | 同上 | 不需要审批;提议要管理员在知汇面板里审核 |
saved_search.list、saved_search.get | 读取调用者自己的常用检索 | 同上 | 不需要 |
saved_search.save、saved_search.delete | 用户明确要求时保存、修改或删除自己的常用检索(修改和删除要带版本号) | 同上 | 不需要;只改调用者自己的定义 |
saved_search.run | 按当前授权重新执行一条常用检索,并和上次结果比较 | 同上 | 不需要 |
qa.record、qa.list | 记录引用已核对的问答;读取时重新核对引用,标出过期或不可读的记录 | 同上 | 不需要;只写调用者自己的记录 |
analysis.submit、analysis.get、analysis.cancel | 把较慢的检索、证据汇集、比较、相似文档、表格读取和引用核验放到后台执行,并读取或取消任务 | 同上 | 不需要 |
Agent 的默认路径是先看授权的文库,再看资料和说明,再看文档详情,最后按需读正文,不用先猜关键词。目录类操作分页返回,Agent 要沿下一页的位置读完,不能把第一页当成全部。不可读的资料对 Agent 一律按不存在处理,计数里也不包含。
导出和标准答案的审核只在控制台,Agent 没有这些操作。
在 Nexus 助手里查资料
Nexus 助手用 Agent 自己的 Key 连接 Nexus,只能看到这把 Key 被授权的资料。有两种用法。
直接检索,不经过 AI
在 Nexus 助手的「Nexus 管理」页,打开「知汇」标签。「直接检索」按关键词检索授权的文库。检索范围的下拉只在关注(点 ☆)过文库后才出现,可以选全部文库或只检索关注的文库。命中词高亮,点结果直接看正文片段。「知识库拓扑」按文库、来源目录、资料逐层展开,来源目录可以多层嵌套,点一份资料看说明、元信息、内容分块和正文,有来源地址时可以在来源系统里打开。这个页面只读,不调用模型。页首的「关注」条可以给文库、资料和常用检索点 ☆;「常用检索」列表显示上次运行时间和命中份数,可复制运行命令;页尾有折叠的「授权与说明」。只有当前 Key 获授权使用知汇时,才会出现「知汇」标签。
在对话里提问
在对话里直接提业务问题,Agent 会调用知汇的操作,查到相关资料后基于它回答。例子:问「出差结束后多久内要报销」。回答里能看到:
- 从资料里摘出的原文依据,例如期限、所需材料、超过某个金额由谁审批。
- 一张「依据文档」表:文档名称、章节、状态(如
current,即现行)和快照同步时间(北京时间)。 - 「说明与边界」:原文没有写明的事项,例如期限是自然日还是工作日,应当标为无法确定,不由 Agent 猜测。
引用的样子,与上一节的字段一一对应:文档名称、位置(章节、页、工作表或幻灯片)、生效状态和快照同步时间。建议提问时要求列出依据文档和章节,并在引用的日期上核对:资料是否适用,要结合生效日期和业务问题判断。同步时间是来源快照的时间,不代表来源系统此刻的内容。
授权到多细
知汇的授权资源有两类,动作都只有一个「检索」:
| 资源 | 含义 | 约束 |
|---|---|---|
知识文件(knowledge.document) | 单个文档,按文档 ID 授权 | 每次检索最多返回的结果数,1 到 50,不设时默认 20 |
知识文件夹(knowledge.folder) | 来源系统里的一个文件夹,绑定来源、索引范围和真实文件夹 ID,覆盖它的子文件夹 | 同上 |
在「接入中心 › 授权管理」里选择授权的对象(单位、岗位角色、人员或 Agent),添加授权,选知汇的文件或文件夹,勾选「检索」,按需设置结果数上限。知汇面板右上角「更多」菜单里的「授权管理」也能直达这个页面。
- 授权按 ID 绑定。文档、文件夹、文库或来源改名,授权继续有效。
- 文件夹授权会自动覆盖其中同步进来的新文件和子文件夹。文件移出文件夹后,在下一次同步更新它的路径时失去继承来的权限;如果另有单文件授权,仍按单文件规则读取。
- 来源只用于浏览,不能单独授予整个来源。
- 同一个调用者有多条授权、各自设了结果数上限时,取最小值;只要有一条设了上限,没设的授权也按这个值。
- 资源被删除时,相关授权变成「资源不存在」,不会转移到别的资源,需要管理员重新授权。属于删除的情况有:删除文档或文库,同步发现来源已没有该文档,移除来源,修改来源的读取范围或凭据,以及文件夹里最后一份文档被撤回。
- 撤销或收窄授权,在下一次调用就生效。
- 授权只决定 Agent 能读哪些索引内容。来源账号能读什么,由来源系统里的账号权限决定,两边要分别配置、分别验证。
授权的对象、继承规则和审计,见授权、审批与审计。