面向 AI 助手:本页的 Markdown 版本位于 https://ark.volcengine.com/region:cn-beijing/docs/get-thread-api.md,全部文档索引见 https://ark.volcengine.com/llms.txt。

查询线程详情

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

查询指定线程的当前状态、关联智能体和主子关系。已知 thread_id 时使用本接口。

查看全部线程请使用 查询线程列表;排查执行过程请使用 获取线程事件列表。

鉴权#

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

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

请求参数#

Path 参数#

session_id string 必选  |  会话 ID

会话 ID,形如 sesn-...

thread_id string 必选  |  线程 ID

线程 ID,形如 sthr-...

响应参数#

agent_name string  |  智能体名称

线程关联的智能体名称

created_at string  |  创建时间

首次观察到该线程的时间,采用 RFC 3339 格式。

id string  |  线程 ID

线程唯一标识符,形如 sthr-...

parent_thread_id string / null  |  父线程 ID

子线程的父线程 ID;主线程返回 null。

session_id string  |  会话 ID

所属会话 ID,形如 sesn-...

status string  |  线程状态

线程状态:

  • running 智能体正在处理
  • idle 空闲(等待用户输入或工具结果)
  • rescheduling 调度中
  • terminated 已终止
type string  |  对象类型

对象类型,固定为 session_thread

updated_at string  |  更新时间

最近一次线程状态变化的时间,采用 RFC 3339 格式。