创建对话
功能介绍
创建对话。
URI
POST /v1/{project_id}/chats
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
参数解释: 项目ID,您可以从获取项目ID中获取。 约束限制: 不涉及 取值范围: 仅支持字母、数字、中划线和下划线,长度为[1-128]个字符。 默认取值: 不涉及 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Chat-Route-Id |
是 |
String |
参数解释: 对话路由ID。 约束限制: 不涉及 取值范围: 仅支持字母、数字、中划线和下划线,长度为[1-64]个字符。 默认取值: 不涉及 |
|
X-Auth-Token |
是 |
String |
参数解释: 用户Token。 Token认证就是在调用API的时候将Token加到请求消息头,从而通过身份认证,获得操作API的权限,获取Token接口响应消息头中X-Subject-Token的值即为Token。 约束限制: 不涉及 取值范围: 长度为[1-32768]个字符。 默认取值: 不涉及 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
id |
否 |
String |
参数解释: 对话ID。 约束限制: 不填值表示新建对话的首次问答,填值表示在原有对话下新增问答。 取值范围: 仅支持字母、数字、中划线和下划线,长度为[0-128]个字符。 默认取值: 不涉及 |
|
message |
是 |
String |
参数解释: 对话消息。 约束限制: 不涉及 取值范围: 取值范围为[1-16384]个字符。 默认取值: 不涉及 |
|
agent_type |
是 |
String |
参数解释: 助手类型。 约束限制: 不涉及 取值范围:
默认取值: 不涉及 |
|
agent_role |
否 |
String |
参数解释: 助手角色。 约束限制: 不涉及 取值范围:
默认取值: Common |
|
enable_deepresearch |
否 |
Boolean |
参数解释: 是否开启深度探究。 约束限制: 不涉及 取值范围:
默认取值: 不涉及 |
响应参数
状态码:200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
chat_id |
String |
参数解释: 对话ID。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
|
id |
String |
参数解释: 问答ID。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
|
create_time |
String |
参数解释: 问答创建时间。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
|
type |
String |
参数解释: 问答类型。 约束限制: 不涉及 取值范围:
默认取值: 不涉及 |
|
message |
ChatMessage object |
参数解释: 对话内容。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
content |
String |
参数解释: 对话内容。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
|
reasoning_content |
String |
参数解释: 深度搜索思维链内容。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
|
tool_calls |
Array of ToolCall objects |
参数解释: 工具调用列表。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
type |
String |
参数解释: 工具类型。 约束限制: 不涉及 取值范围:
默认取值: 不涉及 |
|
name |
String |
参数解释: 工具名称。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
|
operation |
String |
参数解释: 工具操作。 约束限制: 不涉及 取值范围:
默认取值: 不涉及 |
|
parameters |
Map<String,Object> |
参数解释: 工具调用所需参数列表。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
请求示例
创建对话,通用类型助手,助手角色为对话助手。
https://{endpoint}/v1/{project_id}/chats
{
"message" : "This is a question.",
"agent_type" : "auto",
"agent_role" : "Common"
}
响应示例
状态码:200
OK
成功创建对话。
{
"chat_id" : "7275cb0f-e35d-48a6-9ecc-2d0a3398f3c8",
"id" : "8b843dc9-8ecc-4a48-8ee4-95185d066c17",
"create_time" : "2025-09-11T06:32:41Z",
"type" : "chat_call",
"message" : {
"content" : "This is a answer",
"tool_calls" : [ ]
}
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
OK |
错误码
请参见错误码。