run 对象
试用版

表示在线程上运行的执行。source

标识符,可在 API 终端节点中引用。source

对象类型,始终为thread.run.source

创建运行时的 Unix 时间戳(以秒为单位)。source

作为此运行的一部分执行的线程的 ID。source

用于执行此运行的助手的 ID。source

运行的状态,可以是queued,in_progress,requires_action,cancelling,cancelled,failed,completed,incompleteexpired.source

有关继续运行所需作的详细信息。将是null如果不需要执行任何作。source

与此运行关联的最后一个错误。将是null如果没有错误。source

运行过期时间的 Unix 时间戳(以秒为单位)。source

运行启动时的 Unix 时间戳(以秒为单位)。source

取消运行时的 Unix 时间戳(以秒为单位)。source

运行失败时的 Unix 时间戳(以秒为单位)。source

运行完成时的 Unix 时间戳(以秒为单位)。source

有关运行未完成原因的详细信息。将是null如果运行不是未完成的。source

助手用于此运行的模型。source

助手用于此运行的说明。source

助手用于此运行的工具列表。source

一组 16 个可附加到对象的键值对。这对于以结构化格式存储有关对象的其他信息非常有用。键的长度最大为 64 个字符,值的长度最大为 512 个字符。source

与运行相关的使用情况统计信息。该值将为null如果运行未处于 TERMINAL 状态(即in_progress,queued等)。source

用于此运行的采样温度。如果未设置,则默认为 1。source

用于此运行的 nucleus 采样值。如果未设置,则默认为 1。source

指定为在运行过程中使用的提示令牌的最大数量。source

指定为在运行过程中使用的最大完成令牌数。source

控制线程在运行之前如何被截断。使用此选项可控制运行的初始上下文窗口。source

控制模型调用哪个 (如果有) 工具。none表示模型不会调用任何工具,而是生成一条消息。auto是默认值,这意味着模型可以在生成消息或调用一个或多个工具之间进行选择。required表示模型在响应用户之前必须调用一个或多个工具。 指定特定工具,如{"type": "file_search"}{"type": "function", "function": {"name": "my_function"}}强制模型调用该工具。source

是否在工具使用过程中启用并行函数调用source

指定模型必须输出的格式。兼容 GPT-4oGPT-4 Turbo 和所有 GPT-3.5 Turbo 型号gpt-3.5-turbo-1106.source

设置为{ "type": "json_schema", "json_schema": {...} }启用结构化输出,以确保模型与您提供的 JSON 架构匹配。在结构化输出指南中了解更多信息。source

设置为{ "type": "json_object" }启用 JSON 模式,以确保模型生成的消息是有效的 JSON。source

重要提示:使用 JSON 模式时,还必须通过系统或用户消息指示模型自行生成 JSON。否则,模型可能会生成无休止的空格流,直到生成达到令牌限制,从而导致长时间运行且似乎“卡住”的请求。另请注意,如果出现以下情况,消息内容可能会被部分截断finish_reason="length",这表示已超过代数max_tokens或对话超过了最大上下文长度。source

OBJECT run 对象
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
{
  "id": "run_abc123",
  "object": "thread.run",
  "created_at": 1698107661,
  "assistant_id": "asst_abc123",
  "thread_id": "thread_abc123",
  "status": "completed",
  "started_at": 1699073476,
  "expires_at": null,
  "cancelled_at": null,
  "failed_at": null,
  "completed_at": 1699073498,
  "last_error": null,
  "model": "gpt-4o",
  "instructions": null,
  "tools": [{"type": "file_search"}, {"type": "code_interpreter"}],
  "metadata": {},
  "incomplete_details": null,
  "usage": {
    "prompt_tokens": 123,
    "completion_tokens": 456,
    "total_tokens": 579
  },
  "temperature": 1.0,
  "top_p": 1.0,
  "max_prompt_tokens": 1000,
  "max_completion_tokens": 1000,
  "truncation_strategy": {
    "type": "auto",
    "last_messages": null
  },
  "response_format": "auto",
  "tool_choice": "auto",
  "parallel_tool_calls": true
}