Đến nội dung
GFlow4AI
ENTải cho Windows
Hướng dẫn/Kết nối AI agent

Giới hạn và ranh giới an toàn cho agent

Cập nhật 2026-11-04Thử bản mẫu trên web

Hiểu ngân sách từng khoá, giới hạn yêu cầu, kết nối cùng máy và đường dẫn tham chiếu an toàn.

Giới hạn theo khoá
Giới hạn theo khoá · Ảnh chụp app thật, dữ liệu mẫu

Trước khi bắt đầu

  • Biết khoá, cổng và quyền mà client đang dùng.

Các bước

  1. Tính cả việc đã cam kết, không chỉ việc đã xong

    Trần credit/ngày áp dụng riêng cho từng khoá theo ngày địa phương. Trần 0 nghĩa là không giới hạn. Trước khi nhận việc, app cộng credit đã gửi, ước tính của việc chờ/đang chạy và ước tính việc mới; vượt trần trả 429 daily_cap. Lỗi này khác 429 rate_limited. Credit Flow đã trừ không được hoàn khi huỷ.

  2. Điều tiết yêu cầu và thời gian chờ

    REST và MCP dùng chung giới hạn cửa sổ trượt 60 yêu cầu/phút/khoá. Vượt giới hạn trả 429 rate_limited kèm Retry-After. Mỗi khoá có tối đa 8 yêu cầu chưa xong, kể cả chờ; vượt số đồng thời trả 429 too_many_inflight.

    Mỗi lần chờ long-poll tối đa 50 giây, mặc định 30: REST dùng timeout, MCP dùng timeout_sec. Việc chưa kết thúc trả về nghĩa là chờ tiếp, không phải gửi tạo lại.

  3. Giữ nguyên ranh giới mạng

    Máy chủ HTTP chỉ bind 127.0.0.1, không bao giờ bind 0.0.0.0. Mọi yêu cầu đều được kiểm trước cả health/schema hoặc xác thực: có header Origin, kể cả rỗng, trả 403 origin_forbidden; Host phải khớp 127.0.0.1:<cổng hiện tại> hoặc localhost:<cổng hiện tại>, nếu không trả 421 host_mismatch. Phản hồi không cấp quyền CORS.

    Client cloud không gọi được loopback của PC. Không mở cổng ra ngoài, tự coi proxy là kết nối được hỗ trợ hoặc tắt bảo vệ trình duyệt.

  4. Dùng tệp cục bộ ngoài thư mục riêng cho tham chiếu MCP

    flow_upload_reference.file_path phải là đường dẫn tuyệt đối trên ổ đĩa cục bộ Windows, ví dụ C:\Users\You\Pictures\reference.png. Đường dẫn tương đối, UNC/mạng, thiết bị, ký tự NUL và luồng dữ liệu phụ NTFS đều bị từ chối.

    Máy chủ giải liên kết và từ chối tệp nằm trong dữ liệu app hoặc thư mục Thư viện. Tệp phải là tệp thường; máy chủ kiểm lại định danh và đọc qua handle đã kiểm; tệp đổi trong lúc đọc có thể trả 409 file_changed. Chép tham chiếu định dùng ra thư mục người dùng bình thường ngoài kho app. Không trỏ agent vào dữ liệu hồ sơ hoặc khoá riêng tư.

  5. Tuân thủ giới hạn tải và quyền sở hữu

    Ảnh tối đa 20 MB; video tối đa 1 GB và cần xác nhận quyền rõ ràng (rights_confirmed: true trong MCP hoặc X-Rights-Confirmed: true trong REST). Tải base64 qua MCP chỉ nhận ảnh; video dùng file_path cục bộ hoặc tải byte qua REST. Thân JSON REST thông thường giới hạn 256 KB.

    Khoá không đọc được việc, tham chiếu hoặc đầu ra của khoá khác hay của giao diện. Nhân vật dùng chung. Ưu tiên tệp đầu vào của bạn và mã yêu cầu ổn định; xem REST API và khoá API.

Khi đã xong

Client luôn ở cùng máy, tuân thủ giới hạn từng khoá, chờ không tạo trùng và chỉ tải tham chiếu hợp lệ mà bạn có quyền dùng.

Nếu gặp trục trặc

Vì sao ít yêu cầu vẫn có 429?

Đọc code: daily_cap là ngân sách credit, too_many_inflight là số yêu cầu đồng thời, rate_limited là cửa sổ tốc độ một phút. Chỉ thử lại sau khi xử lý đúng giới hạn.

Vì sao tệp có thật vẫn bị từ chối?

Kiểm tra đường dẫn mạng/thiết bị/tương đối, luồng phụ, đích trong dữ liệu riêng hoặc Thư viện sau khi giải liên kết, loại media sai, thiếu xác nhận quyền video hoặc tệp thay đổi khi đọc.