创建对话
功能介绍
创建对话。
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 |
错误码
请参见错误码。