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 格式。