跳转到主要内容
Session & Event

更新 Session

更新会话元数据

POST
/api/v1/agentstudio/sessions/{session_id}
cURL
curl --request POST \
  --url 'https://maas.qianwenaiapi.com/api/v1/agentstudio/sessions/{session_id}' \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "Q3 销售复盘",
  "metadata": {
    "biz_ticket_id": "1234",
    "status": "done"
  },
  "environment_variables": {
    "API_BASE_URL": "https://api.example.com",
    "LOG_LEVEL": "info"
  },
  "vault_ids": [
    "vlt_xxx"
  ],
  "agent": {
    "system": "你是本会话专用的项目分析助手。",
    "skills": []
  },
  "mcp_configs": [
    {
      "mcp_server_name": "weather",
      "headers": {
        "X-Tenant-Id": "tenant-demo"
      }
    }
  ]
}
'
{
  "id": "sesn_xxx",
  "type": "session",
  "status": "idle",
  "title": "Q3 销售复盘",
  "metadata": {
    "biz_ticket_id": "1234",
    "status": "done"
  },
  "updated_at": "2026-05-28T09:30:00Z",
  "request_id": "xxx",
  "environment_variables": {
    "API_BASE_URL": "https://api.example.com",
    "LOG_LEVEL": "info"
  },
  "agent": {
    "id": "agent_xxx",
    "type": "agent",
    "version": 1,
    "name": "data-analyst",
    "system": "你是本会话专用的项目分析助手。",
    "tools": [],
    "mcp_servers": [],
    "skills": []
  },
  "vault_ids": [
    "vlt_xxx"
  ],
  "mcp_configs": [
    {
      "mcp_server_name": "weather",
      "headers": {
        "X-Tenant-Id": "tenant-demo"
      }
    }
  ]
}

鉴权

string
header
必填

DashScope API Key

路径参数

string
必填

请求体

application/json
string

会话标题

object

业务自定义键值。整体替换元数据;省略保持原值,null 不执行更新。嵌套与数量限制同创建时

object

会话运行时注入的环境变量,字符串键值对,沙箱代码中可直接按名读取。整体替换;空对象清空,省略保持原值

string[]

整体替换 Vault 绑定;空数组清空,省略保持原值

object

会话级 Agent 配置 patch,只能携带 system / tools / mcp_servers / skills 四个覆盖字段,携带其他字段(如 type / id / version / model)返回 invalid_parameter。子字段语义:省略保留已有覆盖;null 删除该字段覆盖并重新继承智能体源配置;空数组明确覆盖为空;空字符串(仅 system)明确使用空提示词。更新仅影响本会话快照,不改动智能体本身

object[]

整体替换会话级 MCP 请求头;空数组清空,省略保持原值,null 非法

响应

200-application/json
string

会话 ID

string

固定为 session

enum<string>

当前会话状态(更新不改变状态)

idle,running,terminated
string

请求体覆盖后的新值

object

请求体覆盖后的新值

string

最近更新时间,ISO 8601

string

本次请求的唯一标识

object

会话运行时注入的环境变量

object

更新后的智能体配置快照,会话级覆盖已并入。结构与创建 Session 响应的 agent 一致

string[]

更新后的 Vault 绑定

object[]

更新后的会话级 MCP 请求头