更新时间:2025-09-25 GMT+08:00
分享

创建对话

功能介绍

创建对话。

URI

POST /v1/{project_id}/chats

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

项目ID,您可以从获取项目ID中获取。

约束限制

不涉及

取值范围

仅支持字母、数字、中划线和下划线,长度为[1-128]个字符。

默认取值

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Chat-Route-Id

String

参数解释

对话路由ID。

约束限制

不涉及

取值范围

仅支持字母、数字、中划线和下划线,长度为[1-64]个字符。

默认取值

不涉及

X-Auth-Token

String

参数解释

用户Token。

Token认证就是在调用API的时候将Token加到请求消息头,从而通过身份认证,获得操作API的权限,获取Token接口响应消息头中X-Subject-Token的值即为Token。

约束限制

不涉及

取值范围

长度为[1-32768]个字符。

默认取值

不涉及

表3 请求Body参数

参数

是否必选

参数类型

描述

id

String

参数解释

对话ID。

约束限制

不填值表示新建对话的首次问答,填值表示在原有对话下新增问答。

取值范围

仅支持字母、数字、中划线和下划线,长度为[0-128]个字符。

默认取值

不涉及

message

String

参数解释

对话消息。

约束限制

不涉及

取值范围

取值范围为[1-16384]个字符。

默认取值

不涉及

agent_type

String

参数解释

助手类型。

约束限制

不涉及

取值范围

  • auto:通用助手

  • drug:药物助手

  • gene:基因助手

默认取值

不涉及

agent_role

String

参数解释

助手角色。

约束限制

不涉及

取值范围

  • Common:对话助手角色

  • Biomed:作业助手角色

默认取值

Common

enable_deepresearch

Boolean

参数解释

是否开启深度探究。

约束限制

不涉及

取值范围

  • true:开启深度探究

  • false:关闭深度探究

默认取值

不涉及

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

chat_id

String

参数解释

对话ID。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

id

String

参数解释

问答ID。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

create_time

String

参数解释

问答创建时间。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

type

String

参数解释

问答类型。

约束限制

不涉及

取值范围

  • chat_call:普通问答

  • tool_call:实验问答

  • deepresearch_call:深度探究

默认取值

不涉及

message

ChatMessage object

参数解释

对话内容。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

表5 ChatMessage

参数

参数类型

描述

content

String

参数解释

对话内容。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

reasoning_content

String

参数解释

深度搜索思维链内容。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

tool_calls

Array of ToolCall objects

参数解释

工具调用列表。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

表6 ToolCall

参数

参数类型

描述

type

String

参数解释

工具类型。

约束限制

不涉及

取值范围

  • drug_job:药物作业

  • workflow:流程作业

默认取值

不涉及

name

String

参数解释

工具名称。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

operation

String

参数解释

工具操作。

约束限制

不涉及

取值范围

  • create:新增

  • delete:删除

  • update:修改

  • query:查询

默认取值

不涉及

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

错误码

请参见错误码

相关文档