Agent làm gì
Trợ lý AI của console đọc ticket, ca báo cáo và tài khoản qua tool, làm qua nhiều bước rồi trả lời có dẫn nguồn. Moderator xem, quyết định và tự bấm.
Moderator mở một ticket, một ca báo cáo hay một tài khoản trong console rồi hỏi agent bằng lời thường. Agent tự chọn tool để đọc dữ liệu, chia việc thành các bước có tên, rồi trả lời bằng chữ, số liệu, bảng hoặc biểu đồ. Mỗi ý trong câu trả lời gắn một số như 1, trỏ về bản ghi mà ý đó lấy ra.
Agent làm được
- Đọc ticket, ca báo cáo, tài khoản, đơn, tin đăng và nhật ký console
- Đếm, tóm tắt, so giá với các tin cùng loại
- Viết tài liệu có phiên bản ngay trong cuộc chat
- Hỏi lại moderator khi câu hỏi chưa rõ
Ngoài phạm vi của agent
- Khoá tài khoản, ẩn tin, gửi tin nhắn: moderator tự bấm trong console
- Làm theo chữ người dùng viết trong tin nhắn, ghi chú hay mô tả tin
- Nhận request từ ngoài: chỉ server gọi được agent, qua mạng nội bộ
- Lưu dữ liệu: server lưu mọi cuộc chat, lượt chạy và lần gọi tool
Quy tắc chỉ đọc là BR-MOD-03. Agent không có tool nào sửa dữ liệu, nên một prompt injection giấu trong tin nhắn của người dùng nhiều nhất chỉ làm ra một đề xuất sai, và moderator là người duyệt đề xuất đó.
Bốn phần của hệ thống
Console chỉ gọi server. Server mở từng đoạn chạy trên agent. Agent gọi model qua LiteLLM và đọc dữ liệu qua MCP server mà server mở trên một cổng riêng. Mọi việc agent làm chảy về server thành từng dòng; server lưu lại rồi phát cho console.
- 1 Gửi câu hỏiConsole → Server
POST …/turnstrả 202 ngay - 2 Mở một đoạn chạyServer → Agent
POST /runskèm cấu hình agent - 3 Gọi modelAgent → LiteLLM
userlà id của moderator - 4 Đọc dữ liệu qua MCPAgent → Serverchỉ tool đọc, kiểm moderator mỗi lần gọi
- 5 Trả từng dòng NDJSONAgent → Serverevent, tool call, checkpoint, dòng
end - 6 Phát event qua SSEServer → Consoleđóng tab không dừng lượt chạy
Agent là service NestJS riêng trong repo shopnexus/agent, chạy vòng lặp Strands trên model mà LiteLLM chọn. Quyết định tách agent ra và cho nó đọc qua MCP của server là ADR-0003.
Màn hình của moderator
Lượt chạy hiện ra trong lúc nó diễn ra: từng bước kèm một dòng tóm tắt, từng tool kèm thời gian, rồi câu trả lời và danh sách nguồn. Trong lúc chạy, moderator bấm Pause (hoặc phím Esc), hoặc gõ thêm một dòng để chỉnh hướng agent.
Cuộc chat theo bản ghi
Mỗi ticket, ca báo cáo hay tài khoản có một cuộc chat chung cho mọi moderator mở nó, nên ca sau thấy ca trước đã hỏi gì, và mỗi câu hỏi ghi tên người hỏi. Cuộc chat không gắn bản ghi nào là của riêng moderator mở nó. Ca sử dụng: UC-MOD-06, UC-MOD-07, UC-MOD-08.