接口參考

事件

事件歷史與事件串流。

事件的欄位見事件參考；流的幀格式、續傳與增量處理見串流接口詳解。

GET/v1/sessions/{session_id}/events

事件歷史

權限: sessions:read
成功: 200

按發生順序（從舊到新）返回會話所有輪次的事件，包括進行中的一輪已經產生的部分。只在事件串流中出現的增量事件（*.delta）不會出現在歷史中。

查詢參數

limitinteger

每頁條數，1–100，預設 20。

cursorstring

上一頁回應中的 meta.next_cursor。

錯誤

狀態碼	type	原因
404	`session_not_found`	會話不存在、已刪除或屬於其他項目。
422	`invalid_cursor`	游標格式錯誤。

請求

curl -s "$AXON_API/sessions/$SESSION/events?limit=100" -H "Authorization: Bearer $AXON_KEY"

回應

{
  "items": [
    {"id": "evt_5b16…", "type": "user.message", "turn_id": "turn_3f2a…", "created_at": "…", "content": "…"},
    {"id": "evt_9a03…", "type": "agent.tool_use", "turn_id": "turn_3f2a…", "created_at": "…",
     "tool_use_id": "toolu_01JB…", "name": "web_search", "input": {"query": "…"}}
  ],
  "meta": {"next_cursor": "WzQ4XQ"}
}

GET/v1/sessions/{session_id}/events/stream

事件串流

權限: sessions:read
成功: 200，text/event-stream

以 Server-Sent Events 即時推送會話當前一輪的事件：如果有正在執行的一輪就是這一輪，否則是最近的一輪。連接先補發本輪已發生的事件，再持續推送新事件，直到本輪的終止事件，然後關閉。

請求頭

Last-Event-IDstring

可選。斷線重連時帶上收到的最後一個 SSE id，從它之後繼續推送。見斷線續傳。

錯誤

狀態碼	type	原因
404	`session_not_found`	會話不存在、已刪除或屬於其他項目。

請求

curl -sN "$AXON_API/sessions/$SESSION/events/stream" \
  -H "Authorization: Bearer $AXON_KEY" \
  -H "Last-Event-ID: $LAST_ID"      # 重連時才需要

回應

id: turn_3f2a9c1e5b7d4e6f8a0b2c4d6e8f0a1b:1791190158370-0
event: user.message
data: {"id":"evt_5b16…","type":"user.message","turn_id":"turn_3f2a…","created_at":"…","content":"…","files":[],"skills":[]}

: ping

id: turn_3f2a9c1e5b7d4e6f8a0b2c4d6e8f0a1b:1791190176110-0
event: agent.message.delta
data: {"type":"agent.message.delta","turn_id":"turn_3f2a…","content":"Python 當前的穩定版本是 "}

id: turn_3f2a9c1e5b7d4e6f8a0b2c4d6e8f0a1b:1791190176160-0
event: agent.message.delta
data: {"type":"agent.message.delta","turn_id":"turn_3f2a…","content":"3.14.0。"}

id: turn_3f2a9c1e5b7d4e6f8a0b2c4d6e8f0a1b:1791190176203-0
event: agent.message
data: {"id":"evt_…","type":"agent.message",…,"content":"Python 當前的穩定版本是 3.14.0。"}

id: turn_3f2a9c1e5b7d4e6f8a0b2c4d6e8f0a1b:1791190176361-0
event: turn.completed
data: {"id":"evt_…","type":"turn.completed",…,"usage":{"input_tokens":2026,"output_tokens":120}}