对话机器人
新建对话机器人
新建对话机器人
鉴权方式
AppKey + Sign 是应用密钥鉴权，由管理员创建，用于以应用管理员身份访问应用数据。
版本
请求地址
Header 参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
HAP-Appkey | string | 是 | HAP应用密钥 |
HAP-Sign | string | 是 | HAP签名 |
Body 参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
appId | string | 是 | 应用 ID |
name | string | 是 | AI 助手名称 |
sectionId | string | 否 | 导航分组 ID |
description | string | 否 | 用途说明 |
remark | string | 否 | 备注说明 |
icon | string | 否 | 图标名称，如 17_6_reddit |
prompt | string | 是 | 机器人系统提示词 |
welcomeMessage | string | 是 | 欢迎语 |
presetQuestions | string[] | 是 | 预设问题列表，至少 1 个、最多 5 个；空列表和超出数量限制时接口会报错。 |
响应参数
200成功创建对话机器人| 名称 | 类型 | 描述 |
|---|---|---|
success | boolean | 是否调用成功 |
error_code | integer | 错误代码 |
error_msg | string | 错误消息 |
data | object | — |
data.chatbotId | string | 对话机器人 ID |
data.name | string | 对话机器人名称 |
data.sectionId | string | 导航分组 ID |
curl -X POST "https://example.com/v3/app/chatbots" \ -H "HAP-Appkey: {{HAP-Appkey}}" \ -H "HAP-Sign: {{HAP-Sign}}" \ -H "Content-Type: application/json" \ -d '{ "appId": "app_id", "name": "合同智能顾问", "remark": "法务部专用 AI 助手测试版", "prompt": "你是合同智能顾问。", "welcomeMessage": "您好，请描述需要解答的问题。", "presetQuestions": [ "这是什么机器人？" ] }'{ "data": { "chatbotId": "chatbot_id", "name": "Test chatbot", "sectionId": "section_id" }, "success": true, "error_code": 1}