获取 Session - 千问AI平台

GET

/api/v1/agentstudio/sessions/{session_id}

cURL

curl --request GET \
  --url 'https://dashscope.aliyuncs.com/api/v1/agentstudio/sessions/{session_id}' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'

{
  "id": "sesn_xxx",
  "type": "session",
  "status": "idle",
  "stop_reason": {
    "type": "requires_action",
    "pending_batch_id": "response_xxx:9f2c...",
    "pending_call_ids": [
      "call_xxx"
    ]
  },
  "agent": {
    "id": "agent_xxx",
    "type": "agent",
    "version": 1,
    "name": "data-analyst",
    "description": null,
    "model": {
      "id": "qwen3-max"
    },
    "system": "你是数据分析专家，使用 pandas 处理 CSV 文件。",
    "tools": []
  },
  "environment_id": "env_xxx",
  "title": "Q3 销售数据分析",
  "metadata": {
    "biz_ticket_id": "1234"
  },
  "archived_at": null,
  "created_at": "2026-05-28T08:23:11Z",
  "updated_at": "2026-05-28T08:23:25Z",
  "request_id": "xxx",
  "environment_variables": {
    "API_BASE_URL": "https://api.example.com",
    "LOG_LEVEL": "info"
  }
}

stop_reason 取值

会话回到 idle 的原因，是一个判别联合。stop_reason 仅在 idle 时用于判断交互状态；running 时为 null；terminated 是终态，接口可能保留此前值，不应依赖或解释。

type	说明	附加字段
`null`	running，或 idle 刚创建、尚未产生结束原因	—
`end_turn`	模型主动结束	—
`retries_exhausted`	重试耗尽	—
`requires_action`	等待工具审批	`pending_batch_id`、`pending_call_ids`（均非空）

requires_action 时用 pending_batch_id + pending_call_ids 定位当前待裁决调用，再经事件 API 拉取对应的 tool_approval_request。全部审批批次/调用 ID 均非空。畸形对象校验失败，以下均非法：

示例	原因
`{}`	缺 `type`
`{"type":"requires_action"}`	缺 `pending_batch_id` / `pending_call_ids`
`{"type":"requires_action","pending_call_ids":[]}`	`pending_call_ids` 为空
`{"type":"requires_action","pending_batch_id":"","pending_call_ids":["call_xxx"]}`	空批次 ID
`{"type":"requires_action","pending_batch_id":"b","pending_call_ids":[""]}`	`pending_call_ids` 含空 item
`{"type":"end_turn","pending_batch_id":"b","pending_call_ids":["c"]}`	终态夹带 pending 字段

requires_action 必须同时含非空 pending_batch_id 与非空 pending_call_ids；其余 type 不夹带 pending 字段。

鉴权

string

header

必填

DashScope API Key

路径参数

string

必填

响应

200-application/json

string

会话 ID，格式 sesn_<ULID>

string

固定为 session

enum<string>

会话状态：idle / running / terminated

可选值：idle,running,terminated

end_turn / retries_exhausted

会话回到 idle 的原因（判别联合）。详见 stop_reason 取值。仅 requires_action 携带 pending_batch_id 与非空 pending_call_ids

显示子属性

enum<string>

必填

end_turn（模型主动结束）/ retries_exhausted（重试耗尽）

可选值：end_turn,retries_exhausted

object

智能体配置完整快照（创建时锁定），含 id/version/name/model/system/tools 等

显示子属性

string

integer

string

string | null

object

模型配置

显示子属性

string

模型 ID，如 qwen3-max

boolean

是否启用思考模式

integer

最大生成长度

number

温度参数，控制随机性

integer

思考预算长度

string

object[]

显示子属性

enum<string>

工具包类型

可选值：builtin_toolkit,mcp_toolkit

object

工具包默认配置，作为该工具包下所有工具的默认开关

显示子属性

boolean

是否默认启用该工具包下的工具

object | null

审批策略：控制该工具被调用前是否需要人工确认。省略时默认 always_allow

显示子属性

enum<string>

必填

always_allow（直接执行）| always_ask（每次调用前暂停等待人工确认）。工具审批仅支持主智能体，不支持在子智能体中使用

可选值：always_allow,always_ask

object[]

当前工具包中单个工具的启用和审批策略配置；逐工具配置覆盖 default_config

显示子属性

string

当前工具包内的工具名称（内置工具如 bash / read / write；MCP 工具使用其工具名称）

boolean

是否启用该工具

object | null

审批策略：控制该工具被调用前是否需要人工确认。省略时默认 always_allow

显示子属性

enum<string>

必填

always_allow（直接执行）| always_ask（每次调用前暂停等待人工确认）。工具审批仅支持主智能体，不支持在子智能体中使用

可选值：always_allow,always_ask

string

mcp_toolkit 类型对应的 MCP Server 名称

string

绑定的运行环境 ID

string

会话标题

object

业务自定义元数据

string | null

归档时间，未归档时为 null

string

创建时间，ISO 8601

string

最近更新时间，ISO 8601

string

本次请求的唯一标识

object

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

​stop_reason 取值

鉴权

路径参数

响应

stop_reason 取值