MBAgent FAQ

Bài này tổng hợp các vấn đề thường gặp khi sử dụng MBAgent và giải pháp. Nếu vấn đề bạn gặp không có trong bài này, vui lòng liên hệ chăm sóc khách hàng Mbbrowser.

---

Một, Cài đặt và Khởi động

Q1.1: Nhấp đúp biểu tượng MBAgent không có phản ứng

Nguyên nhân có thể:

• Trình duyệt Mbbrowser chưa khởi động
• Tài khoản Mbbrowser chưa đăng nhập
• Quyền thư mục làm việc không đủ

Giải pháp:

1. Khởi động trình duyệt Mbbrowser và đăng nhập
2. Kiểm tra thư mục làm việc MBAgent có tồn tại không
3. Khởi động MBAgent với quyền quản trị viên

Q1.2: Sau khi khởi động luôn hiển thị "Chọn thư mục làm việc"

Nguyên nhân: Chương trình chính trình duyệt Mbbrowser chưa khởi động, MBAgent không thể đọc thông tin tài khoản Mbbrowser.

Giải pháp:

1. Đóng MBAgent
2. Khởi động trình duyệt Mbbrowser và đăng nhập
3. Khởi động lại MBAgent

Q1.3: Sau khi khởi động tiếng Trung hiển thị lỗi mã hóa

Giải pháp:

1. Cài đặt Windows → Thời gian và Ngôn ngữ → Ngôn ngữ → Ngôn ngữ hiển thị Windows → Tiếng Trung giản thể (Trung Quốc)
2. Khởi động lại máy tính

Q1.4: Trình cài đặt nói "Đã cài đặt phiên bản mới hơn"

Giải pháp:

1. Control Panel → Programs and Features → Gỡ cài đặt Mbbrowser cũ
2. Xóa C:\Program Files\Mbbrowser
3. Cài đặt lại phiên bản mới

---

Hai, Kết nối trình duyệt Mbbrowser

Q2.1: MBAgent hiển thị "Đang chờ Mbbrowser CDP"

Nguyên nhân có thể:

• Trình duyệt Mbbrowser chưa khởi động
• Cổng ControlV2 bị chiếm
• Tường lửa chặn

Giải pháp:

1. Khởi động trình duyệt Mbbrowser
2. Kiểm tra Mbbrowser → Cài đặt → ControlV2 có bật không
3. Đóng tường lửa / phần mềm diệt virus

Q2.2: AI không thể thao tác trình duyệt Mbbrowser

Các bước khắc phục:

1. Vào "Cài đặt → Phát hiện dịch vụ chính thức"
2. Nhấp "Bắt đầu phát hiện" dưới "Mbbrowser Client ControlV2"
3. Xem bước cụ thể nào thất bại

Q2.3: AI thao tác Mbbrowser luôn thất bại

Nguyên nhân có thể:

• Hạn ngạch tài khoản Mbbrowser hết
• Môi trường Mbbrowser bị hỏng
• Vấn đề mạng

Giải pháp:

1. Kiểm tra hạn ngạch AI tài khoản Mbbrowser
2. Kiểm tra thủ công môi trường đó trong trình duyệt Mbbrowser
3. Liên hệ chăm sóc khách hàng Mbbrowser

Q2.4: Có thể điều khiển Mbbrowser từ xa không?

❌ Không thể. Để biết thêm chi tiết, vui lòng tham khảo Tích hợp Mbbrowser ControlV2.

---

Ba, Mô hình và Provider

Q3.1: Danh sách mô hình trống

Nguyên nhân: Tài khoản Mbbrowser chưa mở hạn ngạch mô hình AI.

Giải pháp:

1. Truy cập bảng điều khiển Mbbrowser
2. Vào "Mô hình AI" → mở hạn ngạch
3. Quay lại MBAgent → làm mới danh sách mô hình

Q3.2: Danh sách không đổi sau khi chuyển Provider

Khắc phục:

1. Kiểm tra Provider đó có cấu hình API Key không
2. Kiểm tra kết nối có thành công không
3. Khởi động lại MBAgent

Q3.3: Provider tùy chỉnh không kết nối được

Khắc phục:

1. Kiểm tra API Key và Base URL có đúng không
2. Kiểm tra kết nối mạng (ping / curl)
3. Xem nhật ký MBAgent (%LOCALAPPDATA%\mbagent\logs\)

Q3.4: Mô hình phản hồi rất chậm

Nguyên nhân có thể:

• Vấn đề mạng
• Mô hình quá tải
• Ngữ cảnh quá dài

Giải pháp:

1. Chuyển sang mô hình nhanh hơn
2. Nén lịch sử phiên (/compact)
3. Kiểm tra mạng

---

Bốn, Tác vụ và Định thời

Q4.1: Tác vụ định thời không kích hoạt như mong đợi

Khắc phục:

1. Kiểm tra biểu thức cron
2. Kiểm tra MBAgent có chạy không (Daemon chưa cài đặt)
3. Xem lịch sử tác vụ
4. Xác nhận thời gian hệ thống

Q4.2: Tác vụ không thực thi khi máy tính ngủ đông

Giải pháp:

1. Cài đặt MBAgent Daemon
2. Cấu hình máy tính không ngủ đông
3. Cấu hình timer đánh thức

Q4.3: Tác vụ liên tục thất bại

Khắc phục:

1. Chạy tác vụ riêng để xem lỗi
2. Kiểm tra trạng thái trực tuyến trình duyệt Mbbrowser
3. Đơn giản hóa mô tả tác vụ, khắc phục từng bước
4. Liên hệ chăm sóc khách hàng Mbbrowser

Q4.4: Tác vụ định thời tiêu hao quá nhiều Token

Giải pháp:

1. Dùng mô hình rẻ
2. Đóng "hiển thị quá trình suy nghĩ"
3. Giảm tần suất thực thi
4. Tối ưu prompt

---

Năm, Tệp và Tệp đính kèm

Q5.1: Tải lên tệp lớn thất bại

Giới hạn:

• Tệp đơn đề xuất < 50 MB
• Tệp rất lớn (>100 MB) dùng công cụ AI để đọc đường dẫn

Giải pháp:

1. Nén tệp (zip)
2. Dùng công cụ Read để AI tự đọc
3. Tải lên theo khối

Q5.2: AI không thể thấy hình ảnh

Nguyên nhân có thể:

• Mô hình hiện tại không hỗ trợ đa phương thức
• Hình ảnh quá lớn
• Định dạng hình ảnh không hỗ trợ

Giải pháp:

1. Chuyển sang mô hình có khả năng đa phương thức (gpt-5, claude-sonnet-4)
2. Nén hình ảnh
3. Chuyển sang JPG / PNG

Q5.3: Tệp AI sửa không được lưu

Khắc phục:

1. Có vô tình nhấp "Từ chối" không?
2. Thư mục làm việc có quyền ghi không?
3. Kiểm tra thư viện trí nhớ AI có ghi đường dẫn sai không

---

Sáu, Quyền và Bảo mật

Q6.1: Làm sao thu hồi thao tác sai của AI?

Các bước:

1. Nhấn ngay Esc để dừng AI
2. Xem nhật ký thao tác
3. Thu hồi thủ công thao tác sai của AI

Q6.2: AI xóa tệp của tôi, làm sao khôi phục?

Trường hợp 1: Tệp ở trong sandbox (thư mục làm việc)

• Nếu đã bật "sao lưu", khôi phục từ bản sao lưu
• Nếu không, cần dùng công cụ khôi phục chuyên nghiệp

Trường hợp 2: Tệp ở ngoài sandbox (thư mục hệ thống)

• ⚠️ Thao tác này mặc định sẽ bị chặn
• Nếu xảy ra, vui lòng lập tức liên hệ chăm sóc khách hàng Mbbrowser

Phòng ngừa:

• Để AI sao lưu tệp quan trọng trước khi thao tác
• Dùng chế độ Ask (cửa sổ xác nhận)

Q6.3: API Key có an toàn không?

✅ An toàn:

• MBAgent không tải API Key lên
• Key chỉ lưu trong Windows Credential Manager
• Credential sẽ xóa khi gỡ cài đặt MBAgent

⚠️ Đề xuất:

• Xoay vòng API Key định kỳ
• Không dán Key bản rõ trong thư viện trí nhớ hoặc phiên

---

Bảy, Thư viện trí nhớ AI

Q7.1: AI có vẻ không "nhớ" những gì tôi đã nói trước đó

Khắc phục:

1. Kiểm tra trí nhớ có tồn tại trong thư viện trí nhớ AI không
2. Yêu cầu lại AI nhớ và xác nhận
3. Kiểm tra thư mục làm việc có đổi không

Q7.2: AI dùng trí nhớ sai

Giải pháp:

1. Sửa trí nhớ đó
2. Sửa hoặc xóa

Q7.3: Làm sao sao lưu thư viện trí nhớ?

1. Tìm thư mục: %LOCALAPPDATA%\mbagent\memory\
2. Sao chép toàn bộ thư mục
3. Lưu vào vị trí an toàn

---

Tám, Giao diện và Hiển thị

Q8.1: Giao diện bị lag

Nguyên nhân có thể:

• Tài nguyên hệ thống không đủ
• Quá nhiều phiên / KMS / MCP được tải
• Vấn đề kết xuất chủ đề

Giải pháp:

1. Đóng các tab không cần thiết
2. Giảm số phiên
3. Chuyển chủ đề (tối < sáng)
4. Khởi động lại MBAgent

Q8.2: Hiển thị phông chữ bất thường

Giải pháp:

1. Kiểm tra phông chữ hệ thống có đầy đủ không
2. Chuyển phông chữ trong cài đặt MBAgent

Q8.3: Không thấy thanh tab

Giải pháp:

1. Cài đặt → Giao diện và Điều hướng → Hiển thị tab nào → chọn tất cả
2. Khởi động lại MBAgent

---

Chín, Tối ưu hiệu năng

Q9.1: MBAgent chiếm bộ nhớ cao

Phạm vi bình thường:

• Nhàn rỗi: 200-500 MB
• Tác vụ phức tạp: 1-2 GB
• Đồng thời cao: 2-4 GB

Tối ưu:

1. Đóng các phiên không cần thiết
2. Giảm số tác vụ đồng thời
3. Gỡ cài đặt dịch vụ MCP không dùng

Q9.2: Phản hồi AI chậm

Nguyên nhân có thể:

• Độ trễ máy chủ mô hình
• Vấn đề mạng
• Ngữ cảnh quá dài

Tối ưu:

1. Chuyển sang mô hình nhanh hơn
2. Nén lịch sử
3. Kiểm tra mạng

---

Mười, Cập nhật và Nâng cấp

Q10.1: Làm sao cập nhật MBAgent?

MBAgent cập nhật cùng trình duyệt Mbbrowser:

1. Trình duyệt Mbbrowser phát hiện phiên bản mới khi khởi động
2. Bật nhắc cập nhật
3. Nhấp "Cập nhật ngay"
4. Khởi động lại sau khi cập nhật

Q10.2: Dữ liệu mất sau khi cập nhật?

Không:

• Thư viện trí nhớ AI, phiên, KMS đều được giữ
• Chỉ tệp cấu hình có thể bị đặt lại

Nếu dữ liệu mất:

1. Kiểm tra thư mục sao lưu
2. Khôi phục từ bản sao lưu
3. Liên hệ chăm sóc khách hàng Mbbrowser

Q10.3: Có thể quay lại phiên bản cũ không?

Có, nhưng cần:

1. Sao lưu dữ liệu hiện tại
2. Gỡ cài đặt phiên bản hiện tại
3. Cài đặt phiên bản cũ
4. Khôi phục dữ liệu

⚠️ Lưu ý: Phiên bản cũ có thể không hỗ trợ chức năng mới.

---

Mười một, Mã lỗi

BROWSER_AUTO_UNAVAILABLE

Ý nghĩa: Khả năng tự động hóa trình duyệt không khả dụng. Nguyên nhân: Trình duyệt Playwright MCP chưa khởi động. Giải pháp:

1. Cài đặt Node.js và npx
2. Để MBAgent tự động cài đặt Playwright
3. Khởi động lại MBAgent

CONTROL_V2_DISCOVERING

Ý nghĩa: Đang phát hiện phiên bản client Mbbrowser. Nguyên nhân: Vừa khởi động hoặc đang quét. Giải pháp: Chờ vài giây rồi thử lại.

CONTROL_V2_HANDSHAKE_SPEC_MISMATCH

Ý nghĩa: MBAgent và client Mbbrowser sử dụng phiên bản đặc tả ControlV2 khác nhau. Giải pháp:

1. Cập nhật trình duyệt Mbbrowser lên phiên bản mới nhất
2. Cập nhật MBAgent lên phiên bản mới nhất

TOOL_ENABLE_PREREQUISITE_MISSING

Ý nghĩa: Điều kiện tiên quyết của công cụ không thỏa mãn. Giải pháp:

1. Kiểm tra Skill tương ứng có bật không
2. Kiểm tra cấp độ ủy quyền tài khoản Mbbrowser

Thư viện kiến thức Mbbrowser RAG hiện không khả dụng

Ý nghĩa: Dịch vụ thư viện kiến thức RAG chính thức Mbbrowser bất thường. Giải pháp:

1. Kiểm tra tài khoản Mbbrowser có hợp lệ không
2. Kiểm tra mạng
3. Liên hệ chăm sóc khách hàng Mbbrowser

Mbbrowser Client ControlV2 hiện không khả dụng

Ý nghĩa: Giao thức ControlV2 trình duyệt Mbbrowser bất thường. Giải pháp:

1. Khởi động lại trình duyệt Mbbrowser
2. Khởi động lại MBAgent
3. Xem trình duyệt Mbbrowser → Cài đặt → ControlV2

---

Mười hai, Nhận trợ giúp

Kênh chính thức

• Tài liệu chính thức: https://help.mbbrowser.com/mbagent
• Bảng điều khiển Mbbrowser: https://www.mbbrowser.com/console
• WeChat chăm sóc khách hàng: Xem trang chính thức Mbbrowser
• Email chăm sóc khách hàng: support@mbbrowser.com

Tự khắc phục

1. Xem nhật ký MBAgent: %LOCALAPPDATA%\mbagent\logs\
2. Xem nhật ký trình duyệt Mbbrowser
3. Dùng "Cài đặt → Phát hiện dịch vụ chính thức" kiểm tra trạng thái dịch vụ

Phản hồi

Khi liên hệ chăm sóc khách hàng, vui lòng cung cấp:

• Số phiên bản MBAgent
• Số phiên bản trình duyệt Mbbrowser
• Phiên bản Windows
• Thông tin lỗi đầy đủ
• Các bước thao tác
• Cung cấp tệp nhật ký khi cần

---

Quay lại: Giới thiệu MBAgent hoặc Tải xuống cài đặt MBAgent.