Skip to main content
委派任务

发起会话

会话承载智能体的一次运行实例,全部消息、工具调用与状态变更以事件形式实时记录。

会话(Session)

会话是智能体的一次运行实例,承载多轮消息、工具调用与状态变更。控制台新建会话用于调试;生产环境通过 API 创建与驱动,详见 Session API

新建会话

在智能体详情页点击新建会话,绑定运行环境(必选)后进入会话页面。创建时服务端快照当时的智能体配置,后续编辑智能体不影响已有会话。 通过 API 创建会话时,需绑定智能体与运行环境,服务端自动快照当前智能体配置。完整参数与响应字段详见 创建 Session API
curl -X POST "https://{workspace_id}.cn-beijing.maas.aliyuncs.com/api/v1/agentstudio/sessions" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent": "agent_xxx",
    "environment_id": "env_xxx",
    "title": "Q3 销售数据分析",
    "resources": [
      {"type": "file", "file_id": "file_xxx", "mount_path": "/workspace/data.csv"}
    ]
  }'

会话页面布局

  • 事件面板:实时展示当轮的处理过程。左上角下拉框可按类型筛选事件(All events / User / Agent / Tool / Tool_output / Error / Model / System)。
  • 右侧标签页智能体环境凭证三个标签页,分别查看当前会话快照的配置。
  • 输入区:底部输入框输入消息,点击发送提交;处理中可点击中断停止当前轮。

挂载文件

在会话页面的资源区上传或挂载已有文件,智能体在工具调用中按 mount_path 读写。详见 文件上传与挂载

归档与删除

会话支持归档和删除两种操作:
  • 归档:状态变为 terminated(终态),事件历史保留可查。适用于已完成的会话。
  • 删除:硬删除,会话元数据、事件历史、内部拷贝的资源全部清除,不可恢复。如需保留事件历史请改用归档。

下一步