Lịch sử phiên & lượng dùng
Liệt kê, xem lại, đổi tên, xoá phiên của người dùng cuối và đọc hạn mức gói.
Các endpoint dưới đây dùng cùng API key (agent:process) và luôn lọc theo đúng người dùng (user = ref bạn gửi khi chat).
Khoá không gắn App ⇒ thêm app_id.
| Phương thức | Đường dẫn | Mô tả |
|---|---|---|
GET | /agent/sessions?user=kh001&limit=20 | Danh sách phiên (mới nhất trước), phân trang bằng cursor |
GET | /agent/sessions/{id}/messages?user=kh001 | Xem lại tin nhắn của một phiên |
PATCH | /agent/sessions/{id}?user=kh001 | Đổi tiêu đề { "title": "Đơn sữa tháng 10" } |
DELETE | /agent/sessions/{id} | Kết thúc phiên (vẫn mở lại được từ lịch sử) |
DELETE | /agent/sessions/{id}/history?user=kh001 | Người dùng xoá phiên khỏi lịch sử của mình |
GET | /agent/usage?user=kh001 | Gói, hạn mức và bộ đếm lượt/token của người dùng |
POST | /agent/turns/{id}/feedback | Đánh giá 👍/👎 { "value": 1 } hoặc { "value": -1 } |
Ví dụ
curl "https://api.aivigo.tech/api/v1/agent/sessions?user=kh001&limit=20" \
-H "Authorization: Bearer $AIVIGO_API_KEY"{
"data": [
{ "id": "0199…", "title": "tôi muốn đặt 2 hộp sữa tươi", "preview": "Đơn hàng DH-1024 đã được tạo…",
"status": "ended", "turn_count": 4, "created_at": "2026-10-18T02:10:00Z", "last_active_at": "2026-10-18T02:12:30Z" }
],
"page": { "has_more": false }
}Tiếp tục một phiên cũ
Gửi session_id của phiên đó ở /agent/process với cùng user.ref. Phiên đã kết thúc/hết hạn được mở lại (cùng id),
trợ lý nạp lại ngữ cảnh từ các lượt đã lưu; quy trình đang làm dở (vd. đang đặt đơn) sẽ bắt đầu lại.