MINARA

列出聊天會話

GET /v1/sessions:列出用戶聊天會話及最後活動時間戳和輪次計數。

GET /v1/sessions

列出用戶聊天會話及最後活動時間戳和輪次計數,供 Web UI 會話側欄使用。

方法GET
路徑/v1/sessions
認證設置 GATEWAY_AUTH_TOKEN 時需要 Authorization: Bearer <token>
類別sessions

響應體

{ "sessions": [ { "id": "chat_abc", "title": "BTC analysis", "origin": "web", "kind": "chat", "created_at_ms": 1747000000000, "updated_at_ms": 1747000500000, "message_count": 6, "has_unseen_completion": true, "completion_settled_at_ms": 1747000500000 } ] }

說明

當一次非主動中斷的 Agent 任務完成或失敗後,has_unseen_completion 為 true;調用 POST /v1/sessions/:id/completion/read 確認已查看後恢復為 false。completion_settled_at_ms 是該結果的穩定游標,客戶端可用它避免舊列表快照恢復已確認的狀態。

group_id 在分頁前篩選會話。省略時傳回所有分組,空值表示未分組,也可以指定分組 ID。傳回的會話包含可為 null 的 group_id。分組儲存在本機 Agent。

本頁目錄