Bỏ qua đến nội dung
ShopNexus Docs
Trên trang này Quyền ở mỗi lần gọi 1/4

Agent chỉ đọc dữ liệu qua MCP server của server. MCP server chạy Streamable HTTP ở /mcp, trên một cổng riêng (AGENT_MCP_ADDR), không nằm trên cổng :8080 và không đi qua ingress. Nó không giữ session: mỗi POST là một request riêng với lần kiểm quyền riêng.

Quyền ở mỗi lần gọi

  1. Kiểm token

    Mỗi lần gọi mang Authorization: Bearer <AGENT_MCP_TOKEN>, so trong thời gian hằng. Sai token là 401 trước khi MCP xử lý gì, và server ghi log security: agent MCP call refused không kèm token.

  2. Kiểm moderator

    Header X-Console-Member mang id của moderator đã hỏi. Server đọc lại moderator qua ActiveMember ở mỗi lần gọi, nên moderator bị vô hiệu giữa hai lần gọi tool thì lần sau không nhận được gì.

  3. Chạy tool

    Tool là một lớp mỏng trên Service của một module; không tool nào đọc bảng trực tiếp. Lỗi từ chối tới agent thành lỗi tool kèm mã; lỗi khác tới agent là internal error và được ghi log.

Phía agent, chỉ tool có readOnlyHint và nằm trong danh sách tools của agent mới được đưa cho model. Mỗi lần gọi có giới hạn thời gian (AGENT_TOOL_TIMEOUT_MS, mặc định 20 giây) và được thử lại tối đa AGENT_TOOL_ATTEMPTS lần khi hết giờ hoặc đứt kết nối.

Danh sách tool

Tool đọc danh sách nhận cursor và limit (1 tới 50, mặc định 20) và trả {items, next_cursor}.

ToolĐọc gìGhi lần đọc
countSố đếm theo trạng thái của tài khoản, tin, đơn, ticket hoặc ca báo cáo, từ một ngày hoặc từ trước tới naykhông
lookupMột id là bản ghi nào: tài khoản, ca báo cáo, đơn, tin hay ticket, kèm tool để đọc nókhông
ticket_getTicket, người mở, đơn liên quan, trang đầu của chat và các ticket khác của người đóticket, người mở
ticket_messagesMột trang chat của ticket, mới nhất trướcticket
tickets_listHàng đợi hỗ trợ: ticket mở hoặc đã xử lý, kèm dòng chat cuốiticket và người mở
tickets_of_account50 ticket mới nhất tài khoản mở, hoặc trên đơn nó bántài khoản và ticket
account_getTrạng thái, tuổi tài khoản, có số điện thoại và email hay không, tin đăng, đơn mua, số lần bị khoákhông
accounts_listTài khoản mới nhất, tài khoản đang bị khoá, hoặc tài khoản theo id hay số điện thoạikhông
orders_of_accountĐơn của tài khoản với vai người mua hoặc người bánkhông
listings_of_accountTin đang bán hoặc đã bán của người bánkhông
console_actionsNhật ký console theo bản ghi, theo moderator hoặc tất cả, không kèm IPkhông
order_getĐơn, hai bên, tin, giá, trạng thái và trạng thái vận đơn hiện tại ở hãngkhông
listing_getTin ở mọi trạng thái trừ đã xoá, như người bán thấykhông
price_guideGiá của tin so với giá giữa của các tin cùng danh mục và tình trạngkhông
report_cases_listHàng đợi báo cáo: ca đang mở hoặc đã xử lýkhông
report_case_getCa báo cáo của tài khoản: lý do, tin bị báo cáo, từng báo cáo với ghi chú, kết quả xử lýtài khoản, báo cáo, người báo cáo

Nhật ký đọc dữ liệu cá nhân

Mỗi lần tool đọc dữ liệu cá nhân (tin nhắn, ghi chú, người mở ticket, người báo cáo), server ghi một dòng vào console_agent_reads: moderator, tool, các id và thời điểm. Dòng được giữ 90 ngày và admin xem được cạnh nhật ký console. Yêu cầu tương ứng là NFR-PRIV-02.

Chữ của người dùng

Hướng dẫn của MCP server và system prompt của agent đều ghi rằng chữ người dùng viết (tin nhắn, ghi chú, mô tả tin) chỉ được trích làm dữ liệu. Agent không có tool ghi, nên lệnh giấu trong chữ đó không làm thay đổi dữ liệu nào.

ShopNexus Docs
EN VI