> For the complete documentation index, see [llms.txt](https://doc.afarensis.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.afarensis.com/google-zhu-li-de-gong-zuo-yuan-li/runs-and-run-steps.md).

# Runs and Run Steps

在您从用户的线索中获取所需的所有上下文信息后，您可以选择一个助手来执行线索。

创建并执行运行 基本运行创建：

run = client.beta.threads.runs.create( thread\_id=thread.id, assistant\_id=assistant.id ) 默认情况下，运行会使用助手对象中指定的模型(model)和工具(tools)配置。

自定义运行：

您可以在创建运行时覆盖默认配置以获得更多灵活性：

run = client.beta.threads.runs.create( thread\_id=thread.id, assistant\_id=assistant.id, model="gpt-4-turbo-preview", instructions="New instructions that override the Assistant instructions", tools=\[{"type": "code\_interpreter"}, {"type": "retrieval"}] ) 注意：与助手关联的文件ID (file\_ids) 在创建运行期间不能被覆盖。要修改这些，您需要使用修改助手的端点。

运行生命周期和状态 状态定义：

queued：初始状态，运行创建后或完成所需操作后进入此状态，应该几乎立即转换到 in\_progress 状态。 in\_progress：助手正在使用模型和工具执行步骤，您可以通过检查运行步骤来监控进度。 completed：运行成功完成，您可以查看助手添加到线索的所有消息，以及运行采取的所有步骤。 requires\_action：当使用函数调用工具且模型确定需要调用的函数及其参数时，运行将进入此状态。 expired：如果函数调用的输出未在设定时间内提交，运行将过期。 cancelling：您可以尝试取消正在进行的运行，成功后状态变为 cancelled。 cancelled：运行已成功取消。 failed：运行失败，失败原因可以通过查看运行中的 last\_error 对象来确定。 轮询更新：

为了保持运行状态的最新，需要定期检索运行对象，并根据运行的状态决定下一步行动。

线索锁定 当运行处于 in\_progress 状态且不是终止状态时，线索将被锁定，这意味着无法向线索添加新消息，也无法在线索上创建新的运行。

运行步骤 步骤状态：

运行步骤的状态与运行状态含义相同。

步骤类型：

message\_creation：助手在线索上创建消息时创建。 tool\_calls：助手调用工具时创建。 数据访问指南 鉴于通过 API 创建的助手、线索、消息和文件对整个组织可见，建议实施授权措施、限制 API 密钥访问，并考虑为不同应用创建独立账户/组织以隔离数据。