Skip to main content
委派任务

管理会话

会话创建后,可通过状态机、工具调用审批和中断机制控制执行流程,并在任务完成后归档或删除。

状态机

会话状态显示在页面顶部。下表给出每个状态的触发条件、下一状态与可执行的操作:
状态触发条件下一状态可执行操作
idle会话创建完成,或一轮处理结束收到消息 → running;归档或删除 → terminated发送消息、挂载文件、归档、删除
running收到消息,智能体开始处理完成 → idle;不可恢复错误 → terminated中断、审批工具调用
terminated归档、删除,或不可恢复错误终态,不可恢复查看事件历史;新建会话继续
会话回到 idle 时,session_status 事件携带 stop_reason 说明原因:end_turn 表示模型主动结束;requires_action 表示需要客户端介入,同时返回 event_ids 指出待处理的事件;retries_exhausted 表示重试耗尽。

工具调用

智能体根据系统提示词和当前消息自主决定何时调用哪个工具。全部工具(内置、MCP、技能)均在会话绑定的运行环境中执行,调用过程通过事件面板实时可见。

调用流程

  1. 智能体决策:模型输出工具调用指令,事件面板显示工具调用事件,含工具名与参数。
  2. 执行:在沙箱中运行工具,输出回传给模型。
  3. 回复或继续:模型基于工具输出决定回复或发起下一次工具调用。

归档与删除

会话支持归档和删除两种操作:
  • 归档:状态变为 terminated(终态),事件历史保留可查。适用于已完成的会话。
  • 删除:硬删除,会话元数据、事件历史、内部拷贝的资源全部清除,不可恢复。如需保留事件历史请改用归档。
通过 API 归档会话,详见 Session API
curl -X POST "https://{workspace_id}.cn-beijing.maas.aliyuncs.com/api/v1/agentstudio/sessions/sesn_xxx/archive" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"
通过 API 删除会话:
curl -X DELETE "https://{workspace_id}.cn-beijing.maas.aliyuncs.com/api/v1/agentstudio/sessions/sesn_xxx" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

下一步