文档中心

数据智能体 DataAgent（私有化）

结构化知识库导入

查询结构化任务

查询结构化任务

调用本接口使用统一 task_ref 查询本地文件导入、Prep 数据集导入或异步删除任务状态。

调用方：开放平台应用、外部 Agent 或集成服务。
前置条件：调用者对任务关联知识库拥有查看权限。

接口说明

接口名称：get_structured_task_structured_knowledge_v1_tasks__task_ref__get
接口地址：/structured_knowledge/v1/tasks/{task_ref}
请求方式：GET

请求参数

Path

参数名	类型	是否必传	描述
task_ref	String	是	统一任务引用；使用发起导入或删除接口返回的 local: 或 prep:<asset_id>

响应参数

参数名	类型	是否必传	描述
code	Number	是	响应码：0=成功，非0=失败
msg	String	否	Code非0时，返回错误信息
message	String	否	错误信息
data	Object	是	数据。详情请参见下文 data 表

data

参数名	类型	是否必传	描述
task_ref	String	是	统一任务引用，与发起导入或删除接口返回值一致
status	String	是	状态 PENDING RUNNING SUCCEEDED PARTIAL_FAILED FAILED
task_type	String	是	任务类型，例如 STRUCTURED_IMPORT
asset_id	String	否	任务关联的数据资产 ID
progress	Number	否	任务进度，范围 0 到 1
create_time	String	否	任务创建时间
start_time	String	否	任务开始执行时间
update_time	String	否	任务最近更新时间
end_time	String	否	任务结束时间
error_code	String	否	标准化失败错误码；未失败时为空
error_message	String	否	失败原因；未失败时为空

最近更新时间：2026.09.11 14:59:46

这个页面对您有帮助吗？

有用

有用

无用

无用