Skip to main content
POST
创建线程

授权

Authorization
string
header
必填

服务端 API Key,不要暴露到浏览器代码中。

请求体

application/json
thread_id
string<uuid>

可选 UUID,省略时自动生成。

assistant_id
string

接口协议允许省略。调用智能体时,应在创建阶段传入目标已发布智能体的 ID,后续运行使用同一个 ID。TypeScript SDK 对应参数为 assistantId。省略时按当前请求身份创建未绑定智能体的线程;后续运行若使用不同的执行身份,可能返回 403。绑定不会授予额外的对话访问权限。

if_exists
enum<string>
可用选项:
raise,
do_nothing
metadata
object

响应

请求成功。

thread_id
string
必填
status
string
必填
created_at
string<date-time>
updated_at
string<date-time>
metadata
object
values
object