查看处理结果链路¶

读取一个工作流处理结果的完整处理链路，包括来源文件、工作流调用和处理拓扑。

GET https://moi.matrixorigin.cn/newmoi/lineage/artifacts/{artifact_id}/overview

调用前准备¶

先查看文件处理链路，从响应中的处理结果信息取得处理结果 ID。准备有目标工作区访问权限的个人访问令牌、目标工作区 ID 和处理结果 ID。

路径参数¶

输入示例

curl "https://moi.matrixorigin.cn/newmoi/lineage/artifacts/$ARTIFACT_ID/overview" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID"

参数说明

字段	类型	是否必填	说明
`artifact_id`	string	必填	工作流处理结果 ID，取自文件处理链路响应中的处理结果信息。

成功响应¶

data 返回处理结果、工作流调用和处理拓扑。拓扑包含关联节点，不表示每个节点都直接处理了该处理结果。

响应字段如下。

响应示例

{
  "code": "OK",
  "msg": "OK",
  "data": {
    "artifact": {
      "artifact_id": "art-001",
      "root_asset_id": "asset-001",
      "case_id": "case-001",
      "parsed_file_available": true
    },
    "workflow": {
      "workflow_id": "wf-001",
      "workflow_version_id": "ver-001"
    },
    "workflow_invocation": {
      "input": {},
      "vars": {}
    },
    "topology": {
      "nodes": [
        {
          "node_id": "node-001",
          "label": "解析文件",
          "status": "success"
        }
      ],
      "edges": [],
      "producer_node_id": "node-001"
    },
    "entry": {}
  }
}

字段说明

通用字段

字段	类型	是否必填	说明
`code`	string	否	成功时为 OK。
`msg`	string	否	成功时为 OK。

artifact

下面表格展开响应示例中 data 下的 artifact 对象；每一行是该对象的一个字段。

字段	类型	是否必填	说明
`artifact_id`	string	否	处理结果 ID。
`root_asset_id`	string	否	根数据资产 ID。
`case_id`	string	否	关联案例 ID。
`parsed_file_available`	boolean	否	解析后的文件是否可用。

workflow

下面表格展开响应示例中 data 下的 workflow 对象；每一行是该对象的一个字段。

字段	类型	是否必填	说明
`workflow_id`	string	否	工作流 ID；仅在有值时返回。
`workflow_version_id`	string	否	工作流版本 ID；仅在有值时返回。

workflow_invocation

下面表格展开响应示例中 data 下的 workflow_invocation 对象；每一行是该对象的一个字段。

字段	类型	是否必填	说明
`input`	object	否	工作流调用输入；仅在有值时返回。
`vars`	object	否	工作流调用变量；仅在有值时返回。

topology

下面表格展开响应示例中 data 下的 topology 对象；每一行是该对象的一个字段。

字段	类型	是否必填	说明
`nodes`	array	否	处理节点列表。
`edges`	array	否	拓扑边列表。
`producer_node_id`	string	否	生成当前处理结果的节点 ID；仅在有值时返回。

entry

下面表格展开响应示例中 data 下的 entry 对象；每一行是该对象的一个字段。

字段	类型	是否必填	说明
`catalog_file_id`	string	否	入口文件 ID；仅在有值时返回。
`volume_id`	string	否	Volume ID；仅在有值时返回。

错误响应¶

响应示例

{
  "code": "ErrNotFound",
  "msg": "资源不存在",
  "data": null
}

字段说明

通用字段

字段	类型	是否必填	说明
`code`	string	否	错误代码。
`msg`	string	否	可读错误信息。
`data`	null	否	错误响应中为 null。

后续操作¶

查看处理节点详情。

最后更新于 2026 年 9 月 3 日