# 机器人简单问答 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"
}