Bỏ qua đến nội dung
ShopNexus Docs
Trên trang này Bốn phần của hệ thống 1/4

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.

Console Moderator hỏi và xem từng bước
Server Kiểm phiên, lưu lượt, phát event
Agent Vòng lặp model, không có database
LiteLLM Chọn model, tính ngân sách
  1. 1 Gửi câu hỏi
    Console → Server
    POST …/turns trả 202 ngay
  2. 2 Mở một đoạn chạy
    Server → Agent
    POST /runs kèm cấu hình agent
  3. 3 Gọi model
    Agent → LiteLLM
    user là id của moderator
  4. 4 Đọc dữ liệu qua MCP
    Agent → Server
    chỉ tool đọc, kiểm moderator mỗi lần gọi
  5. 5 Trả từng dòng NDJSON
    Agent → Server
    event, tool call, checkpoint, dòng end
  6. 6 Phát event qua SSE
    Server → Console
    đóng tab không dừng lượt chạy
Một câu hỏi đi qua bốn phần. Mũi tên nét đứt là dữ liệu chảy về.

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.

Một lượt chạy đã xong trên ca báo cáo. Dữ liệu là ví dụ.

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.

Các trang trong mục

ShopNexus Docs
EN VI