Runs and Run Steps

Afarensis 助手：运行和运行步骤管理

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

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

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 密钥访问，并考虑为不同应用创建独立账户/组织以隔离数据。