读取任务内知识证据

读取任务内知识证据。

POST https://api.moi.matrixorigin.cn/v5/semantic-models/runtime/read-evidence

调用前准备

仅在当前任务执行环境使用注入的服务地址、技术凭据、工作区和短期授权;保留授权头原值。普通 PAT 不能替代任务身份或建立授权。示例使用 jq;变量、对象与状态见公共说明。

请求体

curl -X POST "${MOI_ENDPOINT%/}/semantic-models/runtime/read-evidence" \
  -H "X-API-Key: $MOI_API_KEY" \
  -H "X-Workspace-ID: $MOI_WORKSPACE_ID" \
  -H "X-MOI-Runtime-Authorization: $MOI_RUNTIME_AUTHORIZATION" \
  -H 'Content-Type: application/json' \
  --data-binary "$(jq -n --arg REQUEST_ID "$REQUEST_ID" --arg ARTIFACT_ID "$ARTIFACT_ID" --arg CHUNK_ID "$CHUNK_ID" --arg FILE_ID "$FILE_ID" --argjson SEMANTIC_MODEL_ID "$SEMANTIC_MODEL_ID" '
{
  "request_id": $REQUEST_ID,
  "artifact_id": $ARTIFACT_ID,
  "chunk_id": $CHUNK_ID,
  "file_id": $FILE_ID,
  "semantic_model_id": $SEMANTIC_MODEL_ID,
  "cursor": 0,
  "limit_chars": 4000
}
')"

按原标识读取。单段用 has_more/next_cursor;证据列表使用对象游标并以 complete=true 判断完成;part_index 使用 part_count 选择下一分片,不能混用这些模式。本地摘要需要原始完整内容,仅修改或预览内容不成立。

字段

类型

是否必填

说明

request_id

string

是

本次操作的唯一 ID,1–256 字节,无首尾空白,不以 audit: 开头;重放同一输入时保留原值。

artifact_id

string

条件必填

同一任务先前返回的产物 ID;批量本地读取模式不在顶层提交。

chunk_id

string

否

单段模式选择原分段。

file_id

string

否

原文件 ID,必要时消除重名歧义。

semantic_model_id

integer

否

原模型 ID,必要时消除跨模型重名歧义。

cursor

integer 或 object

否

单段为字符偏移,证据列表为 item_index/content_offset 对象。

limit_chars

integer

否

字符窗口;单段省略/0 使用 2000,有效范围 1–8000。

part_index

integer

否

读取产物分片,须非负;只与 artifact_id 配合。

local_content_sha256

string

否

已在本地完整读取原段落时提供摘要,不与分页组合。

local_reads

object(对象数组)

否

原子登记多段本地完整读取,不与单段/分页顶层字段组合。

成功响应

{
  "code": "OK",
  "msg": "OK",
  "data": {
    "call_id": "request_example",
    "output": {
      "artifact_id": "artifact_example",
      "semantic_model_id": 7,
      "chunk_id": "chunk_example",
      "file_id": "file_example",
      "content": "示例原文",
      "content_chars": 4,
      "cursor": 0,
      "next_cursor": 4,
      "has_more": false
    }
  }
}

字段

类型

说明

code

string

成功时为 OK。

msg

string

响应说明。

data.call_id

string

对应原 request_id。

data.failed

boolean

true 表示业务失败;false 时可省略。

data.output

object

当前操作结果。

data.artifacts

object(对象数组)

同一任务的原始产物与证据。

data.metadata

object

操作元数据,存在时返回。

data.output.artifact_id

string

当前操作返回的原始值,按公共对象说明保留。

data.output.semantic_model_id

integer

当前操作返回的原始值,按公共对象说明保留。

data.output.chunk_id

string

当前操作返回的原始值,按公共对象说明保留。

data.output.file_id

string

当前操作返回的原始值,按公共对象说明保留。

data.output.content

string

当前窗口原文。

data.output.content_chars

integer

当前操作返回的原始值,按公共对象说明保留。

data.output.cursor

integer

当前操作返回的原始值,按公共对象说明保留。

data.output.next_cursor

integer

按当前读取模式继续;Markdown 为 0 时结束。

data.output.has_more

boolean

单段证据是否还有后续字符。

错误响应

按 HTTP 状态、业务结果和错误字段处理,见错误与环境。来源与版本冲突时读取当前状态,不替换身份、资源或请求 ID 自动重试。

最后更新于