# 机器人简单问答 Json 导入
# 功能说明
从 Json 批量导入机器人的所有简单问答技能配置。接口会返回 task_id,可通过调用 异步任务查询 接口查询导入结果。
# 请求 uri
/v2/bot/import/json
# 请求类型
POST
# 请求参数
# params
| 字段名 | 类型 | 含义 |
|---|---|---|
mode | int | 0:导入+覆盖(已存在的) 1:覆盖(先删除原来所有,再导入) |
data | array | 技能意图列表 |
data.skill | string | 技能名称,分类 |
data.intent | string | 意图名称(标准问法) |
data.disable | bool | 是否关闭(禁用) |
data.questions | string array | 问题 |
data.answers | string array | 回答 |
补充说明
data是一个数组,支持在一次请求中批量导入多条意图。建议单次请求不要传入过多意图,避免请求体过大导致超时或失败,可分多次调用完成导入。- 同一个技能(
skill)下可以包含多条不同的意图(intent),只需在data数组中添加多个相同skill但不同intent的条目即可。 questions即相似问法列表,作用是扩展该意图的匹配范围——当用户的提问与其中任一相似问法语义接近时,都会命中该意图。answers支持配置多个回答,命中该意图时默认会从中随机选取一个进行回复。
# 返回参数
| 字段名 | 类型 | 含义 |
|---|---|---|
task_id | string | 异步任务 ID |
# 示例
- 请求示例
curl -X POST \
https://openaiapi.weixin.qq.com/v2/bot/import/json \
-H 'content-type: application/json' \
-H 'X-OPENAI-TOKEN:brhziaX+cXoNHY2rRBUlQgC2YA4oPCJk65fbdb589723' \
-H 'request_id:255i0ug8-l9q4-3801-44ft-w7csjn9e5142' \
-H 'timestamp:1711001766' \
-H 'nonce:abc' \
-H 'sign:通过sign=md5(Token+str(unix_timestamp)+nonce+md5(body))生成' \
-d '{
"mode": 0,
"data": [
{
"skill": "售前咨询",
"intent": "查询营业时间",
"disable": false,
"questions": [
"你们几点开门",
"营业时间是什么时候",
"什么时候上班"
],
"answers": [
"我们的营业时间是周一至周五 9:00-18:00",
"您好,工作日 9:00-18:00 为您服务"
]
},
{
"skill": "售前咨询",
"intent": "查询联系方式",
"disable": false,
"questions": [
"怎么联系你们",
"客服电话是多少"
],
"answers": [
"您可以拨打客服热线 400-xxx-xxxx 联系我们"
]
},
{
"skill": "售后服务",
"intent": "申请退款",
"disable": false,
"questions": [
"我要退款",
"怎么申请退款",
"退款流程是什么"
],
"answers": [
"请提供您的订单号,我们将为您处理退款申请"
]
}
]
}'
- 正确返回示例
{
"code": 0,
"data": {
"task_id": "179ba14fae5f4028b7c00a180cf709e3"
},
"msg": "",
"request_id": "255i0ug8-l9q4-3801-44ft-w7csjn9e5142"
}