文档

CreateIndex - 创建索引

更新时间:
一键部署

该接口将已经文档解析之后的数据按照设置的索引创建流程添加到百炼系统中,形成索引信息,后续可以提供查询索引的能力。

接口说明

  1. 使用此接口前,用户需要确保调用"添加文档(AddFile)"接口,文件已成功上传至百炼数据中心,并已成功获得相关的 FileId。
  2. 创建索引接口只负责初始化索引构建流程,需要继续调用"提交索引执行任务(SubmitIndexJob)"接口,完成索引任务的执行。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求语法

POST /{WorkspaceId}/index/create

请求参数

名称类型必填描述示例值
WorkspaceIdstring

业务空间 id,请登录百炼后,在左上角业务空间详情中获取。

ws_3Nt27MYcoK191ISp
Namestring

索引名称

示例:企业帮助文档库
StructureTypestring

数据源结构类型

枚举值:
  • unstructured非结构化
  • structured结构化(暂不支持)
unstructured
EmbeddingModelNamestring

向量模型名称

枚举值:
  • text-embedding-v2text-embedding-v2
text-embedding-v2
RerankModelNamestring

排序模型名称

枚举值:
  • gte-rerank-hybrid官方推荐
  • gte-rerankgte-rerank
gte-rerank-hybrid
RerankMinScoredouble

相似度阈值:设定最低分数标准,只有超过这个阈值的检索结果才会被考虑用于后续的生成过程

0.20
ChunkSizeinteger

分段预估长度:取值范围[1-2048]

128
OverlapSizeinteger

分段重叠长度:当前分片与上一个分片重叠的文本长度;取值范围[0-1024]

16
Separatorstring

分句标识符

,
SourceTypestring

数据中心数据类型

枚举值:
  • DATA_CENTER_CATEGORY类目类型
  • DATA_CENTER_FILE文档类型
DATA_CENTER_FILE
DocumentIdsarray

文档 id 列表

string

添加文档接口返回的 FileId

file_9a65732555b54d5ea10796ca5742ba22_XXXXXXXX
CategoryIdsarray

类目 ID 列表

string

数据中心的类目 Id

ca_hiu2383nf934j
SinkTypestring

索引存储类型

枚举值:
  • DEFAULT托管
  • ADBadb数据库
DEFAULT
SinkInstanceIdstring

索引实例 ID(仅在索引存储类型是 ADB 时传入)

gp-bp321093j84
SinkRegionstring

索引实例地域(仅在索引存储类型是 ADB 时传入)

cn-hangzhou
Columnsarray<object>

结构化索引设置信息(依赖数据中心结构化,暂不开放)

object

结构化索引设置

Columnstring

数据中心英文列名

clomn_1
Namestring

数据中心实际列名

学校
Typestring

索引类型

枚举值:
  • string文本
string
IsSearchboolean

是否参与检索:开启后表示在此列数据中进行搜索

true
IsRecallboolean

是否参与模型回复:开启后表示被搜索到的数据行对应的本列数据提取出来给到大模型进行生成

true
Descriptionstring

索引描述

这是索引的描述信息。

返回参数

名称类型描述示例值
object

Schema of Response

RequestIdstring

Id of the request

17204B98-7734-4F9A-8464-2446A84821CA
Dataobject

接口业务数据字段。

Idstring

索引信息主键 id

jkurxhju6b
Statusstring

接口返回的状态码

200
Successboolean

调用是否成功。

true
Messagestring

错误信息

Invalid input, variable name is missing
Codestring

错误状态码

Index.Forbidden

示例

正常返回示例

JSON格式

{
  "RequestId": "17204B98-7734-4F9A-8464-2446A84821CA",
  "Data": {
    "Id": "jkurxhju6b"
  },
  "Status": "200",
  "Success": true,
  "Message": "Invalid input, variable name is missing",
  "Code": "Index.Forbidden"
}

错误码

访问错误中心查看更多错误码。