跳转到主要内容
POST
导出会话记录

限制说明

使用说明

  • 个人会话仅创建者可导出;团队会话同一账户内的任何成员都可导出。分享链接不授予导出权限。会话不存在或已删除时返回 ResourceNotFound。
  • 响应为 application/x-ndjson,请逐行解析并写入文件,不要把整个响应体读进内存。
  • 第一行始终是 session_meta 对象。之后每行的 type 为 user_message、system_reminder、agent_text、tool_call、subagent_dispatch、llm_call、final_answer 或 session_fork 之一。
  • include_subagents=true 时,每条 subagent_dispatch 行之后紧跟对应子会话的事件流,以子会话自己的 session_meta 开头。
  • 请求 60 秒超时;非常大的会话可能无法在此时间内导出完毕。
  • 若开始输出后导出失败,响应体以一行 {"type":"error","content":"..."} 结束,而不是错误信封——检查最后一行即可判断是否被截断。

授权

app_key
string
query
必填

在 Flashduty 控制台 我的 → APP Key 中创建的 APP Key。可通过 query 参数 app_key 或请求头 Fd-App-Key 传入。实际可访问范围是该 APP Key 的权限范围与创建者当前角色权限的交集,请妥善保管。

请求体

application/json

以流式 NDJSON 导出单个会话的完整事件记录。

session_id
string
必填

目标会话 ID,取自 POST /safari/session/list 返回的列表。

include_subagents
boolean

为 true 时,每条 subagent_dispatch 行后会跟随子会话的完整事件流,并以其自身的 session_meta 包裹。默认 false。

响应

流式 NDJSON(application/x-ndjson)。每行一个 JSON 对象,以换行结束。第一行始终为 session_meta 信封,其后为会话事件。

换行分隔的 JSON 流。请逐行解析,切勿缓冲整个响应体。