文档中心

火山方舟

会话线程

查询线程列表

GET https://ark.cn-beijing.volces.com/api/v3/sessions/{session_id}/threads

分页查询指定会话下的主线程和子线程。会话开始执行后形成主线程；智能体委派子任务时形成子线程。

主线程排在最前，子线程按创建时间正序返回。

说明

新建会话在尚未开始处理任何事件时，线程列表可能为空。本接口仅支持 limit 和 page 分页，不支持按状态、智能体或父线程筛选，也不支持反转排序。单次最多返回 1000 条。

鉴权

本接口支持鉴权方式如下，详情请参见 Base URL 及鉴权。

API Key 鉴权，请在 API Key 管理页面，获取长效 API Key。

请求参数

Path 参数

session_id string 必选 | 会话 ID

Query 参数

在 URL Query String 中传入。

limit integer 默认值 1000 | 每页线程数

page string | 下一页标识

响应参数

data object[] | 线程列表

next_page string | 下一页标识

查询线程列表

发起调试等同于请求真实调用，可能产生云产品费用，请谨慎操作！

Request

curl -sS --fail-with-body "https://ark.cn-beijing.volces.com/api/v3/sessions/<SESSION_ID>/threads?limit=100" \
  -H "Authorization: Bearer $ARK_API_KEY"

Response

{
  "data": [
    {
      "id": "sthr-01hx3z9r0w8n3p5q6s7t8v9x0z",
      "session_id": "<SESSION_ID>",
      "type": "session_thread",
      "status": "idle",
      "agent_name": "<AGENT_NAME>",
      "parent_thread_id": null,
      "created_at": "2026-07-15T08:30:14.900Z",
      "updated_at": "2026-07-15T08:30:19.220Z"
    },
    {
      "id": "sthr-01hx3z9r0w8n3p5q6s7t8v9x22",
      "session_id": "<SESSION_ID>",
      "type": "session_thread",
      "status": "running",
      "agent_name": "<AGENT_NAME>-sub",
      "parent_thread_id": "sthr-01hx3z9r0w8n3p5q6s7t8v9x0z",
      "created_at": "2026-07-15T08:31:04.000Z",
      "updated_at": "2026-07-15T08:31:04.000Z"
    }
  ]
}

最近更新时间：2026.10.09 19:08:07

这个页面对您有帮助吗？

有用

无用