模块总览

模块是 Nexus 的能力单元。每个模块接一类企业系统,把它整理成智能体能用、并受授权约束的能力。

每个模块是一个独立服务,按需安装,只在内部网络里被 Nexus Core 调用,没有自己的登录和对外端口。人在控制台的模块面板里维护连接和配置,智能体通过核心签发的 Key 和授权来使用它们。

下面按模块概括:它接什么,能做什么,接入前要准备什么,以及目前的边界。每个模块另有一篇详细的使用说明,讲怎么一步步配置和使用。

数脉:数据库与问数

数脉接企业的关系型数据库和数据仓库,把表结构、表间关系和指标口径整理给智能体,让业务人员用自然语言只读查数。

怎么配置和使用,见数脉的详细使用说明。

能做什么

  • 用只读账户采集表、视图、字段、类型、主键、外键和注释。不扫描业务行。
  • 读取说明文档(TXT、Markdown、CSV、JSON、PDF、DOCX),作为表和字段含义的业务依据。
  • AI 推断出的表间关系一律标为待定,由人确认后才用于关联查询。
  • 自然语言问数:先给出查询方案,包括口径、用到的表、关联和时间范围。提问的人确认后,才只读执行受限的 SELECT 子集。模型只提出查询,自己不能执行。
  • 结果可以切换为柱状图、折线图或饼图,也可以导出 CSV 或 Excel。
  • 资产目录:指标口径、确认过的样例和常用查询由人确认后复用,问数时先匹配现成的资产。

需要准备什么

  • 一个只读的采集账户。启用问数时,再准备一个独立的只读执行账户,两者不能是同一个账户。
  • 数据库在内网时,由部署管理员在服务端放行它的地址。出站默认拒绝私网地址。
  • 说明文档:表和字段的业务含义、统计口径。每个文件至多 2 MiB,扫描版 PDF 需要先提供可提取的文字。
  • 在控制台「模型设置」里配置好的模型,关系推断和问数都要用到。
  • 决定哪些表和字段给哪个 Agent:授权可以精确到表和字段,并可附加固定条件。

目前的边界

  • 只读,只执行受限的 SELECT 子集,不做写入,也不做跨库 SQL。一次多库问数最多选 5 个库,各库分别查询,只在明确的键上做结果关联。
  • 超过 80 张表或 1000 个字段的库,不做整库的自动关系推断,可以分范围维护关联。每次问数选的表不超过 80 张。
  • 已有 24 种数据库的目录采集适配,包括达梦、KingbaseES、openGauss、GaussDB、OceanBase。各库的验收范围不同:有的在真实服务或本机夹具上验证过,有的只通过模拟测试,控制台选择产品时会标注「待现场联调」。
  • 默认的检索是中文词项检索,没有验收过向量语义检索。

知汇:企业文档

知汇接企业已有的文件和文库系统,只读同步文字内容,给智能体提供带版本和位置的引用。

怎么配置和使用,见知汇的详细使用说明。

能做什么

  • 只读同步 9 种来源:本地文库、飞书知识库、飞书云盘、钉钉文档、腾讯文档、Confluence Server / Data Center、WebDAV、S3 兼容对象存储和 WeKnora。NAS 共享先只读挂载,再作为本地文库登记。
  • 提取 TXT、Markdown、CSV、TSV、JSON、HTML、PDF、DOCX、XLSX、PPTX 和 OFD 的文字。旧版 DOC、XLS、PPT 由镜像内置的 LibreOffice 转换后提取,图片在启用 OCR 后提取。
  • 引用精确到页、工作表、幻灯片或章节,并带文档版本号。回答前可以核验引用仍是当前版本、调用者仍可读。
  • 默认只检索现行文档。文档的状态和生效日期按来源字段,或文件名和正文里的规则识别;查历史版本要指定日期。新文件写明废止旧文件时,列为待确认的废止,由管理员确认。
  • 文档里的表格按行读取:DOCX 和 PDF 中的表格、XLSX 与 CSV 的工作表,可以按表头选列、按值筛选。合并单元格等抽不准的表格,标为「未结构化」并写明原因。
  • 术语表与标准答案:管理员维护同义词和审核过的标准答案。检索按同义词扩展;标准答案引用的文档有新版本时,转为需复核。

需要准备什么

  • 来源系统里的只读凭据,例如飞书或钉钉的应用凭据、Confluence 的个人访问令牌、对象存储只授予列举和读取权限的密钥。不要授予写权限。
  • 明确的同步范围,例如飞书知识空间或文件夹、钉钉知识库、Confluence 空间、存储桶和前缀。知汇不会发现企业的全部文库。
  • WebDAV、S3、Confluence 和 WeKnora 的内网地址,由部署管理员放行出站,默认要求 HTTPS。
  • 本地目录或 NAS:由部署管理员以只读方式挂载到知汇容器。
  • 决定谁能读哪些文件:授权可以给单个文件,也可以给文件夹,文件夹里后续同步进来的文件自动继承。

目前的边界

  • 对来源系统只读:不修改、不删除原文件,也不提供原件下载。索引保存提取的文字和元数据,是最近一次成功同步的快照,不是来源系统的实时视图。
  • 不支持 Confluence Cloud,也不接 Notion、Google Drive、SharePoint 这类境外 SaaS 来源。
  • 9 种来源里,WeKnora 只通过模拟接口测试,没有对真实实例验证。其余 8 种用真实账号或服务验证过,但范围有限:WebDAV 只测了 Apache 的实现,S3 兼容只测了 MinIO,Confluence 只测了 9.2 版。
  • OCR 默认关闭,需要在镜像里另装 Tesseract。不启用时,图片和扫描版 PDF 只保存原文件并说明原因。OFD 只取文字,不还原版式。
  • 没有框线的 PDF 表格和扫描件不抽取表格,内容仍可检索和读取。已有文档要等文件变化后重新同步,才会补抽表格。
  • 默认是关键词检索,向量与混合检索需要单独启用。

运枢:服务运维

运枢接已登记的 Linux 服务器和 Kubernetes 集群上的服务,让智能体查看状态和日志,生成变更计划,由人批准后再提交。

怎么配置和使用,见运枢的详细使用说明。

能做什么

  • 查看已登记服务的状态和状态变化。按时间窗口(不超过 24 小时)和字面关键词,跨资源检索已脱敏的日志。
  • 只读巡检与预警:用巡检模板和监控规则发现异常,在站内给出预警。智能体可以读取授权范围内还没恢复的事项。
  • 变更走计划与批准:智能体用 change.plan 冻结计划,有权的人在审批页按计划指纹批准,原发起的智能体再用 change.submit 提交。智能体不能批准。批准人账号停用后,原批准失效。
  • 变更治理:可以按全局或资源组设置冻结窗口、维护窗口和变更规模上限。生成计划、提交和每次派发前都会检查,被拒绝时用中文说明原因。
  • 运行手册:管理员维护有版本的多步变更,每一步是已有的变更类型,不能执行命令。智能体生成一个计划,由人整体批准,执行时逐步验证,失败即停。
  • 诊断时间线:把状态变化、预警、变更和巡检发现合并成一条证据时间线。

需要准备什么

  • 要管理的服务器或集群,登记为连接。凭据加密保存,只写不读。
  • 按业务和资源组整理资源。授权按资源和动作配置,新资源不会自动继承已有授权。
  • 每类资源由谁批准变更:本人确认或他人审批,按资源配置。
  • 在审批页有批准权的人员。

目前的边界

  • 变更动作有四类:重启、扩缩容、回滚和重载。扩缩容和回滚只支持 Kubernetes 的 Deployment,重载只支持 Linux 的 systemd 服务和 Docker 容器。每一类都要在资源上单独允许,每次都要经过人批准,不会自动执行。
  • Windows Server 只有协议模拟,没有在实机上验证。Linux 和 Kubernetes 的验收在实验环境完成:Docker 里的受限节点和本地 kind 集群。
  • 不做终端或脚本执行,不做数据库内的操作,例如 SQL、账户和备份恢复。
  • 不做通用流程引擎、自动发现、主机 CPU 和内存等新指标的采集,也不做外部通知推送。

联枢:接口与工具

联枢登记企业已有的 HTTP JSON API、GraphQL 接口和 MCP 工具,让智能体在授权、审批和限额的约束下调用。

怎么配置和使用,见联枢的详细使用说明。

能做什么

  • 登记 HTTP JSON API,可以从 OpenAPI 3.x 文档批量导入。也可以登记固定文档的 GraphQL,以及 MCP 工具:远程的 Streamable HTTP,或运维在服务端登记的本地 stdio 服务。
  • 上游凭据加密保存,只写不读。认证方式包括 Bearer、API Key、Basic、自定义请求头、OAuth2 客户端凭据、令牌换取、钉钉和飞书机器人签名、账号登录换会话,并可叠加双向 TLS。
  • 按工具授权。每个工具可以设置调用限额(每分钟、每日、并发、写操作日预算)和结果脱敏:指定字段,另可自动识别手机号、身份证号、银行卡号和邮箱。
  • 审批分三档:授权后直接调用、本人确认、他人审批。需要审批的调用会冻结参数,由有权的人在审批页决定,管理员只能撤销,不能批准。
  • 组合工作流:管理员把工具编排成固定步骤,参数按 JSON Pointer 路径绑定,不执行代码。工作流按各步骤工具中最高的审批档位办理,可以带等待步骤、执行条件,并支持一次最多 200 条的批量办理。
  • 调用模板预置部分参数,不授予权限。定时任务按 5 分钟到 7 天的间隔,只运行只读模板或只读工作流。

需要准备什么

  • 上游系统的服务端凭据。登记时必须写明「凭据权限说明」,也就是这把凭据在上游能做什么。没有写明的连接,不能启用工具,也不能授权调用。
  • 部署管理员把上游地址列入允许来源。默认要求 HTTPS,内网地址还需要放行出站。
  • 逐个审核工具。新发现或契约变化的 MCP 工具默认停用,并按写操作、他人审批登记,管理员审核后才启用。
  • 为每个工具选好审批档位,并确定在审批页有批准权的人员。
  • 需要本地 stdio 的 MCP 服务时,由运维在服务端登记。管理界面里没有填写命令的地方。

目前的边界

  • HTTP 只支持 JSON 请求和响应,文件上传和下载保存除外。参数用的是有限的 JSON Schema 子集,不支持 $ref、pattern、format。
  • MCP 支持工具的发现与调用。不支持旧的独立 SSE 入口,也不支持 resources、prompts 和采样。
  • 不提供需要用户交互的 OAuth 授权码流程。生产 SSO 和多租户账户不在范围内。
  • 本地 stdio 的子进程不受出站策略约束,运维要自行做好隔离。
  • 工作流不执行代码。含等待步骤的工作流不能设为定时任务。写操作的结果未知时,不自动重发,要先到原系统核实。
  • 真实上游的验收用的是本地协议实验服务和公开的只读服务(DeepWiki 的 MCP、GitHub REST)。企业私有认证和生产写接口,需要按目标服务另行验收。

研枢:研发交付

研枢接代码托管、需求缺陷和 CI 系统,给开发者本机已有的 AI 编程工具提供研发上下文,并把工具交回的结果独立验证后交给人处理。

怎么配置和使用,见研枢的详细使用说明。

能做什么

  • 通过 MCP 服务 nexus-engineering 提供需求、缺陷、迭代进度、合并请求、CI 状态和失败作业的日志尾部。知汇已安装时,可以按项目绑定的范围检索相关文档。
  • 在 Nexus 助手里指挥开发者本机的 AI 编程工具,通过 ACP 或命令行无界面模式调用。可以同时发起多个任务,各有独立的工作区和分支。
  • 工具结束后,客户端在本机收集 git 变更并运行验证命令,给出初步判定:通过、未通过或需要人看。验证命令按仓库里的文件识别,可以修改。
  • 由人决定采纳(创建合并请求,并在需求或缺陷上评论摘要)、退回重做、换工具重做或自己接手。采纳前可以做冲突预检,也可以换另一个工具交叉评审。
  • 读回合并请求的结局,已采纳的任务显示待合入、已合入或已关闭未合入。
  • 项目注意事项:同一项目里问题任务累计 3 个时,提示整理一次。整理是一个普通的代码变更任务,只修改仓库里的 AGENTS.md 或 CLAUDE.md,照常验证、评审、合入。

需要准备什么

  • 研发系统的服务账号令牌。代码托管和研发平台包括 GitLab、GitHub、Gitee、禅道、Jenkins 和云效(Codeup、Projex、Flow)。
  • 在控制台建研发项目,把仓库、需求缺陷系统中的项目和 CI 流水线绑在一起。授权只到研发项目一级,动作是读和写。
  • 开发者本机装好并登录 AI 编程工具。工具的账号、模型和计费由工具自己管理。本机要能构建和运行测试,推送代码用开发者自己的 git 凭据。
  • 让研发系统的 Webhook 指向核心的入站事件入口。收不到 Webhook 时,改为定时轮询。

目前的边界

  • 执行只在开发者本机,研枢没有服务器端的执行集群,也不做多 Agent 编排。完整的差异和过程记录只留在本机,不上传。
  • 已用真实模型完成过任务的工具有 Claude Code、Codex 和 Qwen Code。Cursor CLI、TRAE CLI、Qoder 和 CodeBuddy 只验证过发现和启动。Gemini、Copilot、Kimi、OpenCode 等没有验收记录,只能说可以通过 ACP 或命令行接入。
  • 已在真实系统上验证的有 GitLab、禅道、Jenkins、GitHub、Gitee 和云效中心版。GitHub Enterprise Server 可以配置地址,没有实例验证过;Gitee 企业版和云效专有云不支持。
  • 研枢只管到创建合并请求。评审和合入按上游的规则,采纳满 30 天仍未合入的,不再跟踪结局。
  • 不做细粒度审批、管理统计和代码出域控制。工具的权限请求由开发者本人回答,研枢不自动应答。

怎么选

按要接的系统选,不必都装。同一个智能体用同一把 Key,哪些模块、哪些资源可用,由授权决定。

想让智能体做的事模块它接触什么
用自然语言查业务库里的数数脉数据库的表和字段,只读
回答制度、手册类的问题,并给出出处知汇只读同步的文档,引用带版本和位置
看服务状态和日志,处理重启运枢已登记的服务,重启经人批准
调用企业已有的 API,或把几次调用串成固定流程联枢已登记的 HTTP、GraphQL 和 MCP 工具
读需求和缺陷,让 AI 编程工具改代码并验证结果研枢代码托管、需求缺陷和 CI 系统,采纳后创建合并请求

进一步交流

带一件正在做的事来聊

告诉我们你想让智能体接哪一类系统。我们在演示环境里把这件事走一遍,再一起判断合不合适。