获取知识详情

GET /studio/rag/data/v1/datasets/{dataset_id}/documents/{document_id}

请求头（Request Header）

Authorization 可以使用如下两种Header

• 动态生成 Authorization Header, 参考认证（authentication）

-H "X-Date: $xdate" \
-H "Authorization: $auth" 

• 直接提供完整的 Authorization Header,可以通过浏览器的开发者工具DevTools查看并复制接口调用的完整信息

-H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6InB...'

请求参数（Request Parameters）

名称	类型	必须	描述
dataset_id	string	是	知识库的ID.
document_id	string	是	知识文档的ID.

请求示例（Request Example）

curl --location --request GET 'https://aidmp.cn-sh-01.sensecoreapi.cn/studio/rag/data/v1/datasets/rag_6838d91b6d8b4696be0f497d0868c10e/documents/321a43816c034381a16dae25c266dc4b' \
  -H "X-Date: $xdate" \
  -H "Authorization: $auth" \
  -X GET

响应（Response）

名称	类型	描述
document_id	string	知识文档的ID.
display_name	string	知识文档的名称.
type	integer($enum)	知识文档的类型.
document_size	int64	知识文档的大小.
token_count	int64	知识文档的令牌计数.
segment_count	int64	知识文档的段落计数.
dataset_id	string	知识文档所属知识库的ID.
dataset_display	string	知识文档所属知识库的显示名称.
p_id	string	父知识文档的ID.
data_source_type	integer($enum)	知识文档的数据源类型.
creator	string	知识文档的创建者.
create_time	string($date-time)	知识文档的创建时间.
update_time	string($date-time)	知识文档的更新时间.
segments	array[object]	知识文档的段落详细信息列表.
uri	string	知识文档在OSS中的预签名URI.

其中，type有如下情况

枚举值	数值	含义
DOCUMENT_TYPE_UNSPECIFIED	0	未指定
WEBPAGE	1	网页
FOLDER	2	文件夹
TXT	3	文本文件
PDF	4	PDF文件
HTML	5	HTML文件
XLSX	6	XLSX文件
XLS	7	XLS文件
DOCX	8	DOCX文件
CSV	9	CSV文件
PPTX	10	PPTX文件
PPT	11	PPT文件，暂不支持
XML	12	XML文件
MARKDOWN	13	Markdown文件
MD	14	MD文件
JSON	15	Json文件

其中，data_source_type有如下情况

枚举值	数值	含义
DATA_SOURCE_TYPE_UNSPECIFIED	0	开始，默认
LOCAL_FILE	1	本地知识
WEB	2	网络知识
NOTION	3	Notion知识

其中，segments的参数如下

名称	类型	描述
segment_id	string	段ID.
dataset_id	string	知识库ID
document_id	string	文档ID
content	string	段落内容
token_count	int32	词元数量
number	int32	段落编号
metadata	object	元数据
words	int32	单词数量
segment_type	integer($enum)	段落类型
table_content	string	表格内容
image_key	string	图片键值
image_uri	string	图片URI
display_type	integer($enum)	显示类型
image_keys	array[string]	图片键值列表
display_content	string	展示内容

其中，segments.metadata的参数如下

名称	类型	描述
key_words	array[string]	关键词
image_name_value	string	图片名称
image_size	int32	图片大小
table_name_value	string	表格名称
table_rows	int32	表格行数
table_columns	array[string]	表格列
score	float	分数

其中，segments.segment_type有如下情况

枚举值	数值	含义
SEGMENT_TYPE_UNSPECIFIED	0	未指定状态
SEGMENT_TYPE_TEXT	1	文字
SEGMENT_TYPE_IMAGE	2	图片
SEGMENT_TYPE_TABLE	3	表格
SEGMENT_TYPE_WEB_IMAGE	4	网页图片

其中，segments.display_type有如下情况

枚举值	数值	含义
DISPLAY_TYPE_UNSPECIFIED	0	未指定状态
DISPLAY_TYPE_TEXT	1	文字
DISPLAY_TYPE_MARKDOWN	2	Markdown

响应示例（Response Example）

{
  "document_id": "abc123",
  "display_name": "知识文档名称",
  "type": "ARTICLE",
  "document_size": 1024,
  "token_count": 5000,
  "segment_count": 10,
  "dataset_id": "b2dc6d90-6b68-46e2-a1d1-fd4b323eef40",
  "dataset_display": "知识库名称",
  "p_id": "parent_document_id",
  "data_source_type": "MANUAL",
  "creator": "创建者ID",
  "create_time": "2023-10-07T09:04:08.109Z",
  "update_time": "2023-10-07T09:04:08.109Z",
  "segments": [
    {
      "segment_id": "segment_id_1",
      "content": "段落内容1",
      "token_count": 200
    },
    {
      "segment_id": "segment_id_2",
      "content": "段落内容2",
      "token_count": 300
    }
  ],
  "uri": "https://oss.example.com/documents/document_id"
}