接口详情

更新时间:

鉴权

字段

传参方式

类型

必传

描述

示例值

Authorization

header

String

API-Key

Bearer d1**2a

路由配置

备注:SDK已封装好路由关系,通过SDK调用接口,无需设置接口路由配置。

字段

传参方式

类型

必传

描述

示例值

x-fag-appcode

header

String

应用表示,固定为 aca

x-fag-servicename

header

String

请求路由标识,不同接口值不一样,映射管理参考

aca-character-create

x-fag-servicename 与接口映射关系

接口

路径

x-fag-appcode

创建知识库

/v2/api/knowledge_base/create

aca-kb-create

修改知识库

/v2/api/knowledge_base/update

aca-kb-update

查询知识库

/v2/api/knowledge_base/search

aca-kb-search

删除知识库

/v2/api/knowledge_base/delete

aca-kb-delete

知识库文件详情上传

/v2/api/knowledge_base/detail/upload

aca-kb-detail-upload

知识库文件详情修改

/v2/api/knowledge_base/detail/update

aca-kb-detail-update

知识库文件详情查询

/v2/api/knowledge_base/detail/delete

aca-kb-detail-delete

知识库文件详情删除

/v2/api/knowledge_base/detail/search

aca-kb-detail-search

知识库管理

知识库创建

接口

POST /v2/api/knowledge_base/create

入参

名称

类型

是否必传

说明

name

string

知识库名称

description

string

知识库描述

userProfile

object

用户信息

userProfile.userId

string

用户自定义userId

返回参数

名称

类型

说明

code

int

返回码,正常返回200,异常返回空

success

bool

正常返回 true,异常返回null

requestId

string

请求唯一标识

data

object

请求返回内容

data.knowledgeBaseId

string

知识库id

data.name

string

知识库名称

data.description

string

知识库描述

知识库修改

接口

POST /v2/api/knowledge_base/update

入参

名称

类型

是否必传

说明

knowledgeBaseId

string

知识库id

name

string

知识库名称

description

string

知识库描述

userProfile

object

用户信息

userProfile.userId

string

用户自定义userId

返回参数

名称

类型

说明

code

int

返回码,正常返回200,异常返回空

success

bool

正常返回 true,异常返回null

requestId

string

请求唯一标识

data

bool

是否修改成功

知识库查询

接口

POST /v2/api/knowledge_base/search

入参

名称

类型

是否必传

说明

pageNum

int

否(默认1)

分页页码

pageSize

ing

否(默认30)

分页大小

userProfile

object

用户信息

userProfile.userId

string

用户自定义userId

返回参数

名称

类型

说明

code

int

返回码,正常返回200,异常返回空

success

bool

正常返回 true,异常返回null

requestId

string

请求唯一标识

data

object

请求返回内容

data.page

int

分页页码

data.pageSize

int

分页大小

data.total

int

总数

data.list

array

数据

data.list[i].id

int

知识库主键id

data.list[i].knowledgeBaseId

string

知识库id

data.list[i].name

string

知识库名称

data.list[i].gmtCreate

int

知识库创建时间

data.list[i].gmtModified

int

知识库修改时间

data.list[i].description

string

知识库描述

data.list[i].count

int

知识库下文件详情数量

知识库删除

接口

POST /v2/api/knowledge_base/delete

入参

名称

类型

是否必传

说明

knowledgeBaseId

string

知识库id

userProfile

object

用户信息

userProfile.userId

string

用户自定义userId

返回参数

名称

类型

说明

code

int

返回码,正常返回200,异常返回空

success

bool

正常返回 true,异常返回null

requestId

string

请求唯一标识

data

bool

是否修改成功

知识库文件详情上传

接口

POST /v2/api/knowledge_base/detail/upload

入参

名称

类型

是否必传

说明

knowledgeBaseId

string

知识库id

type

string

文件类型:text,form和document

fileInfos

array

上传文件集合

fileInfos[i].filename

string

文件名称,以文件格式后缀结尾

fileInfos[i].fileUrl

string

公网可访问地址

userProfile

object

用户信息

userProfile.userId

string

用户自定义userId

返回参数

名称

类型

说明

code

int

返回码,正常返回200,异常返回空

success

bool

正常返回 true,异常返回null

requestId

string

请求唯一标识

data

bool

是否上传成功

知识库文件详情修改

接口

POST /v2/api/knowledge_base/detail/update

入参

名称

类型

是否必传

说明

knowledgeBaseId

string

知识库id

name

string

现在文件的名称

newName

string

修改的名称

userProfile

object

用户信息

userProfile.userId

string

用户自定义userId

返回参数

名称

类型

说明

code

int

返回码,正常返回200,异常返回空

success

bool

正常返回 true,异常返回null

requestId

string

请求唯一标识

data

bool

是否修改成功

知识库文件详情查询

接口

POST /v2/api/knowledge_base/detail/search

入参

名称

类型

是否必传

说明

knowledgeBaseId

string

知识库id

pageNum

int

否(默认1)

分页页码

pageSize

ing

否(默认30)

分页大小

userProfile

object

用户信息

userProfile.userId

string

用户自定义userId

返回参数

名称

类型

说明

code

int

返回码,正常返回200,异常返回空

success

bool

正常返回 true,异常返回null

requestId

string

请求唯一标识

data

object

请求返回内容

data.page

int

分页页码

data.pageSize

int

分页大小

data.total

int

总数

data.list

array

数据

data.list[i].id

int

知识库详情主键id

data.list[i].knowledgeBaseId

string

知识库id

data.list[i].name

string

知识库详情名称

data.list[i].gmtCreate

int

知识库详情创建时间

data.list[i].gmtModified

int

知识库详情修改时间

data.list[i].type

string

知识库详情类型

data.list[i].status

int

知识库详情数状态不

data.list[i].fileInfo

object

文件详情

data.list[i].fileInfo.filename

string

文件名

data.list[i].fileInfo.fileSavePath

string

oss路径

data.list[i].fileInfo.fileUrl

string

转存后的地址

知识库文件详情删除

接口

POST /v2/api/knowledge_base/detail/delete

入参

名称

类型

是否必传

说明

knowledgeBaseId

string

知识库id

name

string

知识库文件详情名称

userProfile

object

用户信息

userProfile.userId

string

用户自定义userId

返回参数

名称

类型

说明

code

int

返回码,正常返回200,异常返回空

success

bool

正常返回 true,异常返回null

requestId

string

请求唯一标识

data

bool

是否修改成功