文档中心

数据智能体

结构化知识库查询

查询结构化数据行

查询结构化数据行

调用本接口按关键词、排序和分页条件查询结构化数据行。

调用方：开放平台应用、外部 Agent 或集成服务。
前置条件：调用者拥有知识库查看权限且资产索引已就绪。

接口说明

接口名称：list_rows_structured_knowledge_v1_kbs__kb_id__assets__asset_id__rows_get
接口地址：/structured_knowledge/v1/kbs/{kb_id}/assets/{asset_id}/rows
请求方式：GET

请求参数

Path

参数名	类型	是否必传	描述
kb_id	String	是	结构化知识库 ID，由创建知识库或查询知识库列表接口返回
asset_id	String	是	结构化数据资产 ID，由创建资产或查询资产列表接口返回

Query

参数名	类型	是否必传	描述
keyword	String	否	跨可检索文本字段的关键词，最多 200 个字符
page	Number	否	页码，从 1 开始
page_size	Number	否	每页数量，范围 1 到 100
sort_field	String	否	排序使用的逻辑字段名；不传时使用 OpenSearch 默认顺序
sort_order	String	否	排序方向：asc 升序，desc 降序
cursor	String	否	上一页返回的 next_cursor；深分页时必须使用

响应参数

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

data

参数名	类型	是否必传	描述
items	Array	否	当前页的数据行。详情请参见下文 items 表
total	Number	否	符合查询条件的数据行总数
page	Number	否	当前页码，从 1 开始
page_size	Number	否	每页返回数量
next_cursor	String	否	下一页游标；继续查询时原样传入 cursor
has_more	Boolean	否	是否还有下一页
status	String	是	状态 DRAFT READY_PENDING_IMPORT READY DISABLED DELETED CREATE_FAILED IMPORTING IMPORT_FAILED DELETING DELETE_FAILED

items

参数名	类型	是否必传	描述
row_key	String	是	数据行稳定唯一标识
values	Object	否	按逻辑字段名组织的数据行内容

最近更新时间：2026.09.17 19:26:42

这个页面对您有帮助吗？

有用

有用

无用

无用