You need to enable JavaScript to run this app.
文档中心
火山方舟

火山方舟

复制全文
下载 pdf
Sessions
查询会话详情
复制全文
下载 pdf
查询会话详情
GET https://ark.cn-beijing.volces.com/api/v3/sessions/{session_id}​
查询指定会话的详细信息,包括智能体、会话运行环境、资源、状态、累计用量、时长统计和标签等。​
鉴权​
本接口支持鉴权方式如下,详情请参见 Base URL 及鉴权。​
  • API Key 鉴权,请在 API Key 管理 页面,获取长效 API Key。​
​​
请求参数​
Path 参数​
session_id string 必选 | 会话 ID​
​
​
响应参数​
agent object | 智能体信息​
​
created_at string | 创建时间​
​
environment_id string | 环境 ID​
​
id string | 会话 ID​
​
stats object | 时长统计​
​
status string | 会话状态​
​
type string | 对象类型​
​
updated_at string | 更新时间​
​
archived_at string | 归档时间​
​
environment object | 环境信息​
​
resources object[] | 资源列表​
​
scene string | 会话场景​
​
tags object[] | 标签列表​
​
title string | 会话标题​
​
usage object | 用量统计​
​
vault_ids string[] / null | 保管库 ID 列表​
​
​

Request

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

Response

{
  "id": "<SESSION_ID>",
  "type": "session",
  "agent": {
    "id": "<AGENT_ID>",
    "type": "agent",
    "name": "<AGENT_NAME>",
    "version": 1,
    "created_at": "2026-07-15T08:00:00Z",
    "updated_at": "2026-07-15T08:00:00Z"
  },
  "environment_id": "<ENVIRONMENT_ID>",
  "title": "Q3 规划头脑风暴",
  "vault_ids": [],
  "resources": [],
  "status": "idle",
  "created_at": "2026-07-15T08:30:12.000Z",
  "updated_at": "2026-07-15T09:00:00.000Z",
  "usage": {
    "active_seconds": 147.661,
    "cache_creation": {
      "ephemeral_5m_input_tokens": 109781
    },
    "cache_read_input_tokens": 271227,
    "input_tokens": 34,
    "output_tokens": 7774,
    "server_tool_use": {
      "web_fetch_requests": 0,
      "web_search_requests": 2,
      "general_search_requests": 1,
      "visual_search_requests": 1
    }
  },
  "stats": {
    "active_seconds": 147.661,
    "duration_seconds": 1788.0
  },
  "tags": [
    {"key": "team", "value": "agent-infra"}
  ]
}
最近更新时间:2026.10.30 21:22:47
这个页面对您有帮助吗?
有用
有用
无用
无用