文档中心

数据智能体 DataAgent（私有化）

切片管理

获取 Chunk 列表

调用本接口按知识库或文档获取 Chunk 列表，支持关键词、可用状态和排序条件。返回结果包含 Chunk 基础内容、启用状态、额外信息等元数据。

接口说明

接口名称：list_chunk_chunk_list_post
接口地址：/chunk/list
请求方式：POST

请求参数

查询 Chunk 列表请求。建议同时传入知识库ID和文档ID，以便准确定位目标文档；若仅传其中一个字段，部分场景下可能返回空结果。

参数名	类型	是否必传	描述
kb_id	Number	否	知识库ID。建议与文档ID同时传入；仅传知识库ID时，部分场景下默认结果可能为空。
doc_id	Number	否	文档ID。建议与知识库ID同时传入；仅传文档ID时，部分场景下默认结果可能为空。
page	Number	否	页码
size	Number	否	每页 Chunk 数量
keywords	String	否	关键词

响应参数

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

data

参数名	类型	是否必传	描述
total	Number	是	Chunk 总数
chunks	Array	是	Chunk 列表，详情请参见下文 chunks 表
doc	Object	是	文档，详情请参见下文 doc 表

chunks

参数名	类型	是否必传	描述
chunk_id	String	是	Chunk 标识
question	String	否	问答型 Chunk 的问题
content_with_weight	String	是	带权重的 Chunk 内容
doc_id	Number	是	文档ID
important_kwd	Array	是	重要关键词
image_id	String	是	图片ID
available_int	Number	是	可用状态
is_enabled	Boolean	否	是否启用
status	Number	否	状态码
extra	Object	否	额外数据
imageInfoList	Array	否	图片信息列表，详情请参见下文 imageInfoList 表
imageInfoListSize	Number	否	图片信息数量
update_time	String	否	更新时间
update_by	String	否	更新人
title	Array	否	从标题结构中提取的 Chunk 标题
tableHeaderList	Array	否	表头列表
character_count	Number	否	当前切片的字符数
duration	String	否	切片时长或定位信息
kb_id	Number	否	知识库Id

imageInfoList

参数名	类型	是否必传	描述
imageText	String	是	llm_summary
imageUrl	String	是	url

doc

参数名	类型	是否必传	描述
create_time	Number	否	创建时间戳
create_date	String	否	创建时间
update_time	Number	否	更新时间戳
update_date	String	否	更新时间
id	Number	是	文档ID
thumbnail	String	否	缩略图 Base64 字符串
kb_id	Number	是	知识库ID
parser_id	String	是	默认解析器ID
parser_config	Object	否	解析配置
source_type	String	是	文档来源
type	String	是	文件扩展名
created_by	String	是	创建人
name	String	是	文件名
display_name	String	否	文档展示名称
location	String	否	文件存储位置
size	Number	否	大小
token_num	Number	是	Token 数量
chunk_num	Number	是	切片数量
character_count	Number	否	文档总字符数
avg_character_count	Number	否	分段平均字符数
progress	Number	是	进度
progress_msg	String	否	处理消息
task_progress_raw	String	否	Sophon 原始 taskProgress 聚合 JSON 字符串
process_begin_at	String	否	处理开始时间
process_duation	Number	是	处理耗时
run	String	否	运行状态：1 运行，2 取消
status	String	否	文档状态：0 废弃，1 有效
valid_date	String	否	有效日期
auto_delete_on_expire	Boolean	否	过期后是否自动删除
labels	Array	否	标签信息，详情请参见下文 labels 表
category	String	否	分类
sha256	String	否	SHA256 摘要
retrieval_count	Number	否	检索次数
versions	Array	否	版本列表
folder_id	Number	否	文件夹ID
url	String	否	文件 URL
downloadable	Boolean	否	是否可下载
content_category	Array	否	内容分类名称列表，详情请参见下文 content_category 表
quality_result	Number	否	质量检测结果
spell_check_count	Number	否	错别字检测数量
completeness_check_count	Number	否	完整度检测数量
sensitive_word_check_count	Number	否	敏感词检测数量
is_enabled	Boolean	否	是否启用
prep_task_id	Number	否	预处理任务ID
chunk_settings_type	String	否	当前文档使用的转换切片配置类别
prep_file_path	String	否	Prep 文件路径
actions	Array	否	当前用户对文档的有效权限

labels

参数名	类型	是否必传	描述
create_time	Number	否	创建时间戳
create_date	String	否	创建时间
update_time	Number	否	更新时间戳
update_date	String	否	更新时间
label_id	Number	是	标签ID
label_name	String	否	标签名称
label_type	String	是	文档标签类型 multiple_value_text single_value_text
label_values	Array	否	标签值列表，详情请参见下文 label_values 表
label_value_builder	String	否	标签值构建器 manual chat_model
prompt_version	String	否	提示词版本
label_usage	Number	否	标签使用次数

label_values

参数名	类型	是否必传	描述
id	Number	是	标签值ID
value	String	否	标签值
value_usage	Number	否	标签值使用次数
label_value_builder	String	否	标签值构建器 manual chat_model

content_category

参数名	类型	是否必传	描述
id	Number	是	分类ID
name	String	否	分类名称

最近更新时间：2026.07.27 21:58:47

这个页面对您有帮助吗？

有用

无用

数据智能体 DataAgent（私有化）

data #

chunks #

imageInfoList #

doc #

labels #

label_values #