Skip to main content

​
对话管理

对话管理接口用于创建和管理对话。所有接口都需要开发者权限。

​
获取对话列表

​
/dev/conv/list
获取对话列表。

​
请求参数

参数名类型必选说明
pageinteger否页码，默认1
sizeinteger否每页数量
GET /dev/conv/list?page=1&size=10
Content-Type: application/json
Authorization: Bearer YOUR_TOKEN

​
获取对话详情

​
/dev/conv/:id
获取指定对话的详细信息。

​
请求参数

参数名类型必选说明
idstring是对话ID
GET /dev/conv/conv_123
Content-Type: application/json
Authorization: Bearer YOUR_TOKEN

​
创建对话

​
/dev/conv
创建新的对话。

​
请求参数

参数名类型必选说明
titlestring是对话标题
descriptionstring否对话描述
configobject否对话配置
POST /dev/conv
Content-Type: application/json
Authorization: Bearer YOUR_TOKEN

{
  "title": "新对话",
  "description": "这是一个新对话",
  "config": {
    "type": "customer_service",
    "model": "gpt-4"
  }
}

​
更新对话

​
/dev/conv/:id
更新指定对话的信息。

​
请求参数

参数名类型必选说明
idstring是对话ID
titlestring否对话标题
descriptionstring否对话描述
configobject否对话配置
PUT /dev/conv/conv_124
Content-Type: application/json
Authorization: Bearer YOUR_TOKEN

{
  "title": "更新后的对话",
  "description": "这是更新后的对话描述"
}

​
删除对话

​
/dev/conv/:id
删除指定的对话。

​
请求参数

参数名类型必选说明
idstring是对话ID
DELETE /dev/conv/conv_124
Content-Type: application/json
Authorization: Bearer YOUR_TOKEN

​
错误码说明

错误码说明

错误码说明
400请求参数错误
401未授权或令牌无效
403权限不足（需要开发者权限）
404对话不存在
422请求参数验证失败
500服务器错误