会话创建后,可通过状态机、工具调用审批和中断机制控制执行流程,并在任务完成后归档或删除。
状态机
会话状态显示在页面顶部。下表给出每个状态的触发条件、下一状态与可执行的操作:
| 状态 | 触发条件 | 下一状态 | 可执行操作 |
|---|---|---|---|
idle | 会话创建完成,或一轮处理结束 | 收到消息 → running;归档或删除 → terminated | 发送消息、挂载文件、归档、删除 |
running | 收到消息,智能体开始处理 | 完成 → idle;不可恢复错误 → terminated | 中断、审批工具调用 |
terminated | 归档、删除,或不可恢复错误 | 终态,不可恢复 | 查看事件历史;新建会话继续 |
idle 时,session_status 事件携带 stop_reason 说明原因:end_turn 表示模型主动结束;requires_action 表示需要客户端介入,同时返回 event_ids 指出待处理的事件;retries_exhausted 表示重试耗尽。
工具调用
智能体根据系统提示词和当前消息自主决定何时调用哪个工具。全部工具(内置、MCP、技能)均在会话绑定的运行环境中执行,调用过程通过事件面板实时可见。
调用流程
- 智能体决策:模型输出工具调用指令,事件面板显示工具调用事件,含工具名与参数。
- 执行:在沙箱中运行工具,输出回传给模型。
- 回复或继续:模型基于工具输出决定回复或发起下一次工具调用。
归档与删除
会话支持归档和删除两种操作:
- 归档:状态变为
terminated(终态),事件历史保留可查。适用于已完成的会话。 - 删除:硬删除,会话元数据、事件历史、内部拷贝的资源全部清除,不可恢复。如需保留事件历史请改用归档。
下一步
- 会话事件流(SSE):了解全部事件类型与 SSE 订阅。
- 定义 Agent:调整智能体的模型、提示词与工具集。
- 云端托管环境:配置工具调用的执行沙箱。