Skip to main content

​
机器人管理

所有机器人管理接口都需要有效的访问令牌。请确保在请求头中包含正确的Bearer令牌。

机器人功能概述

机器人管理接口提供了创建、查询、更新和删除机器人的功能。每个机器人都可以配置特定的AI模型和行为参数。

​
获取机器人列表

​
/bot
获取当前用户的机器人列表，支持分页查询。
GET /bot?page=1&limit=10
Authorization: Bearer YOUR_ACCESS_TOKEN

​
请求参数

参数名类型必选说明
pageinteger否页码
limitinteger否每页数量

​
创建机器人

​
/bot
创建新的机器人。
{
  "name": "客服助手",
  "conf": {
    "avatar": "https://example.com/avatar.jpg",
    "desc": "智能客服机器人",
    "modelId": "model123"
  }
}
创建机器人时，配置信息需要放在conf对象中，包括头像、描述和关联的AI模型ID。

​
获取机器人详情

​
/bot/{botId}
获取指定机器人的详细信息。
GET /bot/bot123
Authorization: Bearer YOUR_ACCESS_TOKEN

​
路径参数

参数名类型必选说明
botIdstring是机器人ID

错误码

错误码说明
404机器人不存在
500服务器错误

​
更新机器人

​
/bot/{botId}
更新指定机器人的信息。
{
  "name": "更新后的名称",
  "conf": {
    "avatar": "https://example.com/new-avatar.jpg",
    "desc": "更新后的描述",
    "modelId": "new-model-id"
  }
}

​
路径参数

参数名类型必选说明
botIdstring是机器人ID
更新操作会覆盖现有的配置信息，请确保提供完整的配置对象。

错误码

错误码说明
400请求参数错误
404机器人不存在
500服务器错误

​
删除机器人

​
/bot/{botId}
删除指定的机器人。
DELETE /bot/bot123
Authorization: Bearer YOUR_ACCESS_TOKEN

​
路径参数

参数名类型必选说明
botIdstring是机器人ID
删除操作不可恢复，请谨慎操作。删除机器人会同时删除与该机器人相关的所有对话记录。

错误码

错误码说明
404机器人不存在
500服务器错误