给 AI 代理的产品要点¶
本页面向 AI 代理：把散布在各页的权威事实集中为一页，便于一次读取。人类读者从开始使用进入更合适。每条事实的完整语境在括注的页面。
对象模型¶
工作区 → 目录 → 数据库 → 表 / 文件卷 → 文件。表的数据在 MatrixOne 数据引擎中；文件内容在对象存储中，文件卷登记名称、位置与状态。（数据目录）
不变量与限制¶
工作流数据中不传递文件内容，只传递文件引用；需要内容的算子凭引用读取。（数据加工）
工作流状态（state）单个值上限 1 MB，超限自动转存为文件并保留引用。（数据加工）
引擎只调度与传递数据，不校验任务语义；定义中的错误会被原样执行。（数据加工）
节点引用未注册的算子时持续等待，无报错信息。（数据加工）
子工作流仅在同一工作流定义内展开；工作流之间不共享状态、不存在数据通道。（数据加工）
SQL 算子只接受 SQL 语句本身，不支持自然语言转 SQL。（数据加工）
知识库范围之外的数据不出现在检索结果中；回答基于检索结果并附引用，检索为空时如实说明。（知识库）
答案沿数据血缘可回溯到源文件；血缘在加工完成时登记。（数据目录）
绕过平台直接修改 MatrixOne 库表后，目录登记与实际状态可能不一致；元数据同步用于对齐。（数据目录）
MatrixOne 兼容 MySQL 8.0 协议，但内核并非 MySQL；运维操作以 MatrixOne 文档为准。（MOI 是什么）
可用算子及其输入输出约定，以
GET /workspaces/:id/workitems的实时返回为准；静态列表可能滞后。（参考）
排查的第一个问题¶
工作流失败先分类：定义问题（节点选错、顺序错、参数绑定错误）——修改工作流定义；执行问题（定义正确，算子对合法输入处理失败）——查看该节点运行记录中的输入与日志。（数据加工）
名词¶
术语定义与国内外产品名称的对照见名词对照；正文用词与该页不一致时，以该页为准。
面向 AI 代理的说明：本页事实摘自括注页面；本页与括注页面不一致即为缺陷，以括注页面与实时接口为准。