---
myst:
  html_meta:
    "moi:status": "paper-verified"
---

# 给 AI 代理的产品要点

本页面向 AI 代理：把散布在各页的权威事实集中为一页，便于一次读取。人类读者从[开始使用](../start/index.md)进入更合适。每条事实的完整语境在括注的页面。

## 对象模型

工作区 → 目录 → 数据库 → 表 / 文件卷 → 文件。表的数据在 MatrixOne 数据引擎中；文件内容在对象存储中，文件卷登记名称、位置与状态。（[数据目录](../data/organize.md)）

## 不变量与限制

- 工作流数据中不传递文件内容，只传递文件引用；需要内容的算子凭引用读取。（[数据加工](../data/processing.md)）
- 工作流状态（state）单个值上限 1 MB，超限自动转存为文件并保留引用。（[数据加工](../data/processing.md)）
- 引擎只调度与传递数据，不校验任务语义；定义中的错误会被原样执行。（[数据加工](../data/processing.md)）
- 节点引用未注册的算子时持续等待，无报错信息。（[数据加工](../data/processing.md)）
- 子工作流仅在同一工作流定义内展开；工作流之间不共享状态、不存在数据通道。（[数据加工](../data/processing.md)）
- SQL 算子只接受 SQL 语句本身，不支持自然语言转 SQL。（[数据加工](../data/processing.md)）
- 知识库范围之外的数据不出现在检索结果中；回答基于检索结果并附引用，检索为空时如实说明。（[知识库](../ai/knowledge-base.md)）
- 答案沿数据血缘可回溯到源文件；血缘在加工完成时登记。（[数据目录](../data/organize.md)）
- 绕过平台直接修改 MatrixOne 库表后，目录登记与实际状态可能不一致；元数据同步用于对齐。（[数据目录](../data/organize.md)）
- MatrixOne 兼容 MySQL 8.0 协议，但内核并非 MySQL；运维操作以 MatrixOne 文档为准。（[MOI 是什么](../start/what-is-moi.md)）
- 可用算子及其输入输出约定，以 `GET /workspaces/:id/workitems` 的实时返回为准；静态列表可能滞后。（[参考](index.md)）

## 排查的第一个问题

工作流失败先分类：**定义问题**（节点选错、顺序错、参数绑定错误）——修改工作流定义；**执行问题**（定义正确，算子对合法输入处理失败）——查看该节点运行记录中的输入与日志。（[数据加工](../data/processing.md)）

## 名词

术语定义与国内外产品名称的对照见[名词对照](glossary.md)；正文用词与该页不一致时，以该页为准。

> 面向 AI 代理的说明：本页事实摘自括注页面；本页与括注页面不一致即为缺陷，以括注页面与实时接口为准。