新增机器人
更新时间:2025-09-15
概述
调用接口,可新增外呼机器人
URL
https://aiob-open.baidu.com/api/v1/robot/manage/create
HTTP Method
POST
请求参数
HEADER
| 参数名称 | 是否必须 | 说明 | 示例 |
|---|---|---|---|
| Authorization | 是 | 参考「生成认证Token」文档 | cc-api-auth-v1/5b050c050f5a4e74b8c20bf512e39c1d/2021-04-13T08:05:43Z/1800000/host;x-bce-date/746ed9ad706c379f31bafc292e3c720797e39bb7f08ce5f641d657e14e42dd33 |
PARAM
| 参数名称 | 是否必须 | 参数类型 | 说明 | 示例 |
|---|---|---|---|---|
| robotName | 否 | String | 机器人名称,不能重复。若不传,则为随机名称。 | “机器人名称” |
| robotDescribe | 否 | String | 机器人描述。 | "产品满意度调查场景,了解用户对产品的满意程度以及期望改2进的部分。" |
| templateId | 否 | Long | 模版ID。1:满意度调查;2:客户探需;3:小额保险营销推广;4:招聘初筛;5:面试邀约 | 1 |
| createUserId | 否 | Long | 创建者ID | 无 |
响应参数
| 字段名称 | 数据类型 | 说明 |
|---|---|---|
| id | long | 机器人主键ID |
| robotId | string | Robot UUID |
| version | int | 机器人版本(线下/线上) |
| tenantId | string | 租户ID |
| robotName | string | 机器人名称 |
| callType | int | 机器人呼叫类型 |
| robotIndustry | int | 机器人行业 |
| robotType | int | 机器人类型 |
| industryId | string | 机器人行业ID |
| publishState | int | 发布状态(1-未发布,2-发布中,3-成功,4-失败) |
| nluType | int | 机器人能力类型(1 平台,2 自有,3 其他) |
| nluUrl | string | NLP 服务地址 |
| nluToken | string | NLP Token |
| asrModelId | long | ASR 模型ID |
| asrModelName | string | ASR 模型名称 |
| ttsVoiceId | long | TTS 语音ID |
| ttsVoiceName | string | TTS 语音名称 |
| botId | string | 机器人 Bot ID |
| botToken | string | 机器人 Bot Token |
| botName | string | 机器人 Bot 名称 |
| asrArgs | object(AsrParam) | ASR 参数(识别模式、降噪等) |
| ttsArgs | object(TtsParam) | TTS 参数(语速、语调、音量、模式) |
| nluArgs | object(NluParam) | NLU 参数(授权、是否获取欢迎语) |
| otherArgs | object(OtherParam) | 其他参数(断句、智能打断等) |
| robotDescribe | string | 机器人描述 |
| robotScene | int | 机器人场景 |
| modelSwitch | boolean | 是否开启大模型接管 |
| supportInterrupt | boolean | 是否支持打断 |
| modelTagExtract | boolean | 是否开启大模型标签抽取 |
| robotPromptText | string | 机器人提示文本 |
| modelSwitchDialogue | boolean | 大模型接管后任务对话 |
| openLLMPrePlay | boolean | 是否开启LLM预播放 |
| prePlayWaitTime | int | 预播放等待时长(毫秒) |
| llmPrePlay | string | LLM 预播放文本 |
| llmPrePlayFilterList | string | LLM 禁止预播放文本 |
| prePlayType | int | 预播放类型(0 自定义,1 大模型) |
| maxSilenceCount | int | 最大静默次数 |
| maxCallRounds | int | 最大通话回合数 |
| silentHangUp | string | 静默挂断语 |
| containsKeywordsHangUp | string | 包含关键词挂断语 |
| delayHangUp | int | 延迟挂断时间(毫秒) |
| icon | string | 机器人图标 |
| updateTime | date | 更新时间 |
| lastUpdateTime | date | 最后更新时间 |
| lastUpdateUserName | string | 最后更新人用户名 |
| createTime | date | 创建时间 |
| createUserId | long | 创建人ID |
| createUserName | string | 创建人用户名 |
| robotSource | int | 创建来源(0 外呼平台;1 数字员工) |
| modelUrl | string | 大模型地址 |
| llmVendorsId | long | 大模型厂商(1:百度;2:阿里) |
| llmIdentification | string | 大模型标识 |
| apiKey | array(string) | API Key 集合 |
asrArgs
| 字段名称 | 数据类型 | 说明 |
|---|---|---|
| identifyMode | int | 识别模式 |
| asrDenoise | double | 降噪参数(仅阿里支持) |
ttsArgs
| 字段名称 | 数据类型 | 说明 |
|---|---|---|
| ttsSpeed | double | 语速 |
| ttsTone | double | 语调 |
| ttsVolume | double | 音量 |
| synthesisMode | int | 合成模式 |
nluArgs
| 字段名称 | 数据类型 | 说明 |
|---|---|---|
| authorization | string | 授权信息 |
| getWelcome | int | 是否获取欢迎语 |
otherArgs
| 字段名称 | 数据类型 | 说明 |
|---|---|---|
| pausingIdentify | int | 断句识别(毫秒) |
| silentIdentify | int | 静默识别(秒) |
| deferInterrupt | int | 延迟打断 |
| intelligenceInterrupt | array(int) | 智能打断配置(数字列表) |
| intelligenceConfig | string | 智能打断配置JSON |
| voiceTactics | boolean | TTS 策略 |
| numOfWords2Stop | int | 全双工时,客户说多少字后停止播报 |
| isVadOpen | boolean | 是否开启VAD全双工 |
请求示例
Javascript
1https://aiob-open.baidu.com/api/v1/robot/manage/create
Javascript
1{
2 "robotName": "满意度调查",
3 "robotDescribe": "产品满意度调查场景,了解用户对产品的满意程度以及期望改2进的部分。",
4 "templateId": 1,
5 "createUserId" : 123456789
6}
返回示例
Javascript
1 {
2 "requestId": "1212c090-7406-11f0-99c5-a3b3bc9e66df",
3 "time": 1754623098726,
4 "code": 200,
5 "msg": "OK",
6 "data": {
7 "id": 4871858446958592,
8 "robotId": "0f969941-db89-4502-bf1e-a06b54ee948e",
9 "version": 1,
10 "tenantId": null,
11 "robotName": "快捷场景_293d81df4c",
12 "callType": 3,
13 "robotIndustry": -1,
14 "robotType": 2,
15 "industryId": "4f7aaba5-8e39-498a-8d50-3d996c4ab0e2",
16 "publishState": 1,
17 "nluType": 3,
18 "nluUrl": "http://10.147.89.95:8743/core/v5/block/query",
19 "nluToken": "4eba8d11-5c06-4ce8-8702-71728c4aa1f9",
20 "asrModelId": 2408650643603456,
21 "asrModelName": "基本测试",
22 "ttsVoiceId": 2408631718903808,
23 "ttsVoiceName": "度常盈",
24 "botId": "e0c99e93-e2d0-4b34-88a4-04d346c760d7",
25 "botToken": "4eba8d11-5c06-4ce8-8702-71728c4aa1f9",
26 "botName": "快捷场景_293d81df4c",
27 "asrArgs": {
28 "identifyMode": 1,
29 "asrDenoise": 0.0
30 },
31 "ttsArgs": {
32 "ttsSpeed": 5.0,
33 "ttsTone": 5.0,
34 "ttsVolume": 5.0,
35 "synthesisMode": 2
36 },
37 "nluArgs": {
38 "authorization": null,
39 "getWelcome": null
40 },
41 "otherArgs": {
42 "pausingIdentify": 700,
43 "silentIdentify": 10,
44 "deferInterrupt": 0,
45 "intelligenceInterrupt": [],
46 "intelligenceConfig": null,
47 "voiceTactics": null,
48 "numOfWords2Stop": 2,
49 "isVadOpen": false
50 },
51 "robotDescribe": "",
52 "robotScene": 5,
53 "modelSwitch": true,
54 "supportInterrupt": false,
55 "modelTagExtract": false,
56 "robotPromptText": null,
57 "modelSwitchDialogue": true,
58 "openLLMPrePlay": true,
59 "prePlayWaitTime": 400,
60 "llmPrePlay": "是这样的,这个是这样的",
61 "llmPrePlayFilterList": "你听我说,我跟你说",
62 "prePlayType": 1,
63 "maxSilenceCount": 2,
64 "maxCallRounds": 20,
65 "silentHangUp": "抱歉,听不到您的声音,感谢接听,再见",
66 "containsKeywordsHangUp": "再见,生活愉快,随时联系,不见不散,那您先忙,到时候见,拜拜,待会见",
67 "delayHangUp": 0,
68 "icon": null,
69 "updateTime": "2025-08-08 11:18:16",
70 "lastUpdateTime": "2025-08-08 11:18:16",
71 "lastUpdateUserName": "aiobTest01",
72 "createTime": "2025-08-08 11:18:16",
73 "createUserId": 3808251032371202,
74 "createUserName": "aiobTest01"
75 }
76}
