创建线程并运行
开发中POST
/v1/threads/runs创建一个线程并在一个请求中运行它。
一个运行对象。
请求参数
Body 参数application/json
assistant_id
string
必需
用于执行此运行的助手的 ID 。
thread
object
必需
messages
array [object {4}]
可选
用于启动线程的消息列表。
metadata
object
可选
一组可附加到对象的 16 个键值对。这对于以结构化格式存储有关对象的附加信息非常有用。键的最大长度为 64 个字符,值的最大长度为 512 个字符。
model
string
可选
用于执行此运行的模型的 ID 。如果此处提供了值,它将覆盖与助手关联的模型。如果没有,将使用与助手关联的模型。
instructions
string
可选
覆盖助手的默认系统消息。这对于修改每次运行的行为非常有用。
tools
array[string]
可选
覆盖助手可用于此运行的工具。这对于修改每次运行的行为非常有用。
metadata
string
可选
一组可附加到对象的 16 个键值对。这对于以结构化格式存储有关对象的附加信息非常有用。键的最大长度为 64 个字符,值的最大长度为 512 个字符。
示例
{
"assistant_id": "asst_IgmpQTah3ZfPHCVZjTqAY8Kv",
"thread": {
"messages": [
{
"role": "user",
"content": "Explain deep learning to a 5 year old."
}
]
}
}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
id
string
必需
object
string
必需
created_at
integer
必需
assistant_id
string
必需
thread_id
string
必需
status
string
必需
started_at
null
必需
expires_at
integer
必需
cancelled_at
null
必需
failed_at
null
必需
completed_at
null
必需
last_error
null
必需
model
string
必需
instructions
string
必需
tools
array[string]
必需
file_ids
array[string]
必需
metadata
object
必需
示例
{
"id": "run_3Qudf05GGhCleEg9ggwfJQih",
"object": "thread.run",
"created_at": 1699076792,
"assistant_id": "asst_IgmpQTah3ZfPHCVZjTqAY8Kv",
"thread_id": "thread_Ec3eKZcWI00WDZRC7FZci8hP",
"status": "queued",
"started_at": null,
"expires_at": 1699077392,
"cancelled_at": null,
"failed_at": null,
"completed_at": null,
"last_error": null,
"model": "gpt-4",
"instructions": "You are a helpful assistant.",
"tools": [],
"file_ids": [],
"metadata": {}
}
修改于 9 个月前