批量创建知识库应用发布 | 大装置帮助中心
跳到主要内容

批量创建知识库应用发布

接口调用说明: 接口支持一个知识库应用发布多个平台(目前只支持发布Sensecore网页), 不支持多个知识库应用发布多个平台

POST /studio/rag/data/v1/applications/{application_id}/releases:batchCreate

请求头(Request Header)

Authorization 可以使用如下两种Header

-H "X-Date: $xdate" \
-H "Authorization: $auth"
  • 直接提供完整的 Authorization Header,可以通过浏览器的开发者工具DevTools查看并复制接口调用的完整信息
-H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6InB...'

请求参数(Request Parameters)

名称类型必须描述
application_idstring应用程序的ID.

请求体(Request Body)

名称类型必须描述
requestsarray[object]应用发布请求的列表.

其中,requests的参数如下

名称类型必须描述
application_idstring应用程序的ID.
application_releaseobject创建应用发布的参数.

其中,requests.application_release的参数如下

名称类型必须描述
application_idstring应用程序的ID.
platforminteger($enum)第三方平台类型.

其中,application_release.platform有如下情况

枚举值数值含义
THIRD_PARTY_PLATFORM_UNSPECIFIED0默认值,不会发布任何平台
THIRD_PARTY_PLATFORM_WEB1Sensecore 网页
THIRD_PARTY_PLATFORM_WECOM2企业微信,暂未支持

请求示例(Request Example)

curl 'https://aidmp.cn-sh-01.sensecoreapi.cn/studio/rag/data/v1/applications/2d459faded7a4f9b8fcab55409ac26b9/releases:batchCreate' \
-H "X-Date: $xdate" \
-H "Authorization: $auth" \
-X POST \
--data-raw '{
"application_id":"2d459faded7a4f9b8fcab55409ac26b9",
"requests":[{
"application_release":{
"application_id":"2d459faded7a4f9b8fcab55409ac26b9",
"platform":1
}
}]
}'

响应(Response)

名称类型描述
application_releasesarray[object]应用发布列表.

其中,application_releases 的参数如下

名称类型描述
application_idstring应用程序的ID.
release_idstring应用发布的ID.
platforminteger($enum)第三方平台.
configobject应用程序配置.
stateinteger($enum)应用发布状态.
creatorstring创建者.
last_editorstring最后编辑者.
create_timestring创建时间.
update_timestring更新时间.
release_keystring发布密钥.

其中,application_releases.config的参数如下

名称类型描述
model_configobject模型配置.
promptstring知识库提示,改写用户问题,增加知识库检索到的知识信息.
sys_promptstring人设提示,大模型所需要扮演的人设信息.
modelstring模型名称.
search_configobject搜索知识配置.
question_hintsarray[string]会话开始前显示的问题提示.
conversation_openerstring对话的开场白.
conversation_question_prompt_enabledbool是否提供用户可能想问的三个问题.

其中,config.model_config的参数如下

名称类型描述
frequency_penaltyfloat重复惩罚系数.
max_tokensint32在聊天补全中生成的最大token数,默认值为102.
nint32为每条输入消息生成的聊天补全选择数量.
temperaturefloat使用的采样温度,范围在0到2之间.
top_pfloat采样温度的替代方案,称为核采样.

其中,config.search_config的参数如下

名称类型描述
dataset_listarray[object]要搜索的知识库列表.
top_kint32返回结果的Top K值.
confidencefloat置信度.
weightfloat权重:表示两种方法之间的比例.
open_windowbool是否在提示中包含检索段的前后片段.

其中,search_config.dataset_list的参数如下

名称类型描述
idstring知识库ID.
display_namestring知识库显示名称.

其中,application_releases.state有如下情况

枚举值数值含义
RELEASE_STATE_UNSPECIFIED0默认开始状态
RELEASE_STATE_RELEASED1应用已发布
RELEASE_STATE_DELETED2应用发布已删除

响应示例(Response Example)

{
"application_releases": [
{
"name": "",
"application_id": "2d459faded7a4f9b8fcab55409ac26b9",
"release_id": "2c7065f424964ec380a7ac234e0addf4",
"platform": 1,
"config": {
"model_config": {
"frequency_penalty": 1.05,
"max_tokens": 1024,
"n": 0,
"temperature": 0.8,
"top_p": 0.7
},
"prompt": "使用如下知识的内容作为你的**知识库数据**。\n 知识:\n {{ .Knowledge }}\n\n 回答时请遵循以下规则:\n - 尽量使用**知识库数据**的内容来回答。\n - 如果**知识库数据**中未提及,就用自身知识回答并且告诉用户该信息不是来自知识库。\n - 如果不确定时,请求用户澄清问题。\n\n 请回答问题: \n {{ .Question }}",
"sys_prompt": "#角色设定\n 作为一个智能问答助手,你的任务是为用户提供专业、准确的建议。 \n #组件能力\n 你能够理解和分析用户输入,提供相关且有用的答案。\n 你具备丰富的领域知识,可以回答广泛的问题。 \n #要求与限制\n 1.输出内容的风格要求:保持友好和专业的语气。\n 2.输出内容的字数限制:尽量控制在200字以内,除非问题需要更详细的解释。\n 3. 语言处理:根据用户问题的语言进行回答。",
"model": "SenseChat",
"search_config": {
"dataset_list": [
{
"id": "1431194b72344e88a4df1af91a710ca1",
"display_name": "test06141431"
}
],
"top_k": 3,
"confidence": 0.5,
"weight": 0.5,
"open_window": false
},
"question_hints": [],
"conversation_opener": "",
"conversation_question_prompt_enabled": true
},
"state": 1,
"creator": "644f2cb8-49e9-42b0-8cd9-c62eb46cb5d8",
"last_editor": "644f2cb8-49e9-42b0-8cd9-c62eb46cb5d8",
"create_time": "2024-09-24T10:17:18.531187241Z",
"update_time": "2024-09-24T10:17:18.531200650Z",
"release_key": "****"
}
]
}