Kết nối đầu cuối điều khiển trình duyệt Mbbrowser

MBAgent có thể "thực sự thao tác trình duyệt Mbbrowser", nhờ vào một bộ giao thức giao tiếp hai chiều tên là Mbbrowser Client ControlV2. Bài này giới thiệu chi tiết MBAgent thiết lập kết nối với trình duyệt Mbbrowser thế nào, và khắc phục các vấn đề thường gặp.

NOTE

Chú thích ảnh chụp: Ảnh chụp "đầu cuối điều khiển kép" khi MBAgent và trình duyệt Mbbrowser chạy đồng thời (cửa sổ chính trình duyệt Mbbrowser + cửa sổ chính MBAgent đặt cạnh nhau hiển thị) sẽ được bổ sung dần trong phiên bản v1.x. Phần này trước tiên dùng văn bản mô tả quan hệ cộng tác của cả hai.

---

Một, Đầu cuối điều khiển trình duyệt Mbbrowser là gì?

Đầu cuối điều khiển trình duyệt Mbbrowser (Houniao Client ControlV2) là một bộ giao thức giao tiếp hai chiều mà trình duyệt Mbbrowser cung cấp ra ngoài, để các chương trình khác (bao gồm MBAgent) có thể:

• 🔍 Phát hiện phiên bản Mbbrowser đang chạy cục bộ
• 🤝 Bắt tay với phiên bản Mbbrowser
• 🔑 Đăng nhập qua tài khoản Mbbrowser
• 📦 Tải cấu hình Mbbrowser (môi trường, proxy, dấu vân tay)
• 🚀 Khởi động / dừng môi trường Mbbrowser
• 🌐 Thao tác trang web trong môi trường Mbbrowser

NOTE

Ví von: Có thể hiểu ControlV2 là "giao thức điều khiển từ xa" của trình duyệt Mbbrowser. MBAgent là cái điều khiển từ xa, trình duyệt Mbbrowser là cái TV.

---

Hai, Ba chế độ kết nối giữa MBAgent và Mbbrowser

1. Đầu cuối điều khiển MBAgent (Đề xuất)

MBAgent khi khởi động sẽ tự động khởi động một dịch vụ đầu cuối điều khiển Mbbrowser cục bộ, trình duyệt Mbbrowser kết nối đến với vai trò client.

Kịch bản áp dụng:

• Phiên bản Mbbrowser duy nhất
• Đa số người dùng cá nhân
• Mbbrowser + MBAgent chạy cùng máy

2. Đầu cuối điều khiển ApiServer

Kết nối qua giao diện ApiServer tích hợp sẵn của trình duyệt Mbbrowser (http://127.0.0.1:8186).

Kịch bản áp dụng:

• Điều khiển Mbbrowser từ xa
• Trình duyệt Mbbrowser ở máy khác
• Script tự động hóa (Selenium / Puppeteer / Playwright)

3. Cùng phiên bản

MBAgent và trình duyệt Mbbrowser ở cùng một phiên bản client, trực tiếp giao tiếp nội bộ.

Kịch bản áp dụng:

• Gỡ lỗi phát triển
• Kịch bản nhạy cảm hiệu năng

---

Ba, Kết nối trình duyệt Mbbrowser lần đầu

Điều kiện tiên quyết

✅ Trình duyệt Mbbrowser đã khởi động và đăng nhập tài khoản ✅ MBAgent đã cài đặt ✅ Thư mục làm việc MBAgent chọn khi khởi động có quyền

Quy trình kết nối tự động

MBAgent khi khởi động sẽ tự động thực thi quy trình sau:

[1] Khởi động dịch vụ ControlV2 cục bộ
    ↓
[2] Quét phiên bản Mbbrowser cục bộ
    - Qua broadcast UDP / quét cổng cục bộ
    - Tìm cổng ControlV2 của trình duyệt Mbbrowser
    ↓
[3] Bắt tay
    - Trao đổi số phiên bản giao thức
    - Bàn giao cách mã hóa
    ↓
[4] Đăng nhập tài khoản
    - MBAgent dùng tài khoản Mbbrowser đăng nhập ControlV2
    - Tự động đọc Token
    ↓
[5] Tải cấu hình
    - Tải tất cả môi trường dưới tài khoản Mbbrowser
    - Tải cấu hình proxy dưới tài khoản Mbbrowser
    ↓
[6] Phát hiện khả năng
    - Kiểm tra khởi động / dừng môi trường
    - Kiểm tra tiếp quản trang web
    - Kiểm tra thao tác tệp
    ↓
[7] Kết nối thành công ✅

Xem trạng thái kết nối

1. Vào "Cài đặt → Phát hiện dịch vụ chính thức"
2. Nhấp tùy chọn "Mbbrowser Client ControlV2"
3. Nhấp "Bắt đầu phát hiện"
4. Vài giây sau hiển thị:
   • ✅ Bình thường: Tất cả kiểm tra đều qua
   • ⚠️ Bất thường: Cụ thể bước nào thất bại
   • ⚪ Chưa bật: Chưa bật ControlV2
   • ⏳ Đang phát hiện: Đang phát hiện

---

Bốn, Giải thích kết quả phát hiện

✅ Bình thường

Hiển thị:

Mbbrowser Client ControlV2 có thể sử dụng bình thường
Phát hiện khứ hồi sẵn sàng thời gian thực đã xác minh kết nối, đăng nhập, cấu hình và khả năng thực thi.

Có nghĩa MBAgent có thể thao tác bình thường trình duyệt Mbbrowser.

⚠️ Bất thường: Kết nối thất bại

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

Khắc phục:

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

⚠️ Bất thường: Tài khoản chưa đăng nhập

Nguyên nhân có thể:

• Token tài khoản Mbbrowser hết hạn
• MBAgent không đọc được Token

Khắc phục:

1. Trong trình duyệt Mbbrowser đăng nhập lại tài khoản
2. Khởi động lại MBAgent

⚠️ Bất thường: Tải cấu hình thất bại

Nguyên nhân có thể:

• Dưới tài khoản Mbbrowser không có môi trường nào được tạo
• Kết nối cơ sở dữ liệu Mbbrowser thất bại

Khắc phục:

1. Trong trình duyệt Mbbrowser tạo một môi trường
2. Khởi động lại MBAgent

⚠️ Bất thường: Khả năng thực thi không qua

Nguyên nhân có thể:

• Phiên bản trình duyệt Mbbrowser không tương thích với MBAgent
• Quyền hệ thống không đủ

Khắc phục:

1. Xác nhận trình duyệt Mbbrowser là phiên bản mới nhất
2. Khởi động MBAgent với quyền quản trị viên
3. Liên hệ chăm sóc khách hàng Mbbrowser

---

Năm, Chuyển phiên bản điều khiển Mbbrowser

Nếu bạn có nhiều phiên bản trình duyệt Mbbrowser cục bộ (kịch bản phát triển), có thể chuyển:

Bước một: Xem tất cả phiên bản Mbbrowser

1. Vào "Cài đặt → Mbbrowser Client ControlV2"
2. Nhấp tùy chọn "Phiên bản Mbbrowser"
3. Hiển thị danh sách phiên bản Mbbrowser phát hiện hiện tại:

Phiên bản Mbbrowser #1 (Mặc định)
  - Cổng: 8186
  - Phiên bản: v3.0.0
  - Trạng thái: Đã kết nối

Phiên bản Mbbrowser #2 (Phát triển)
  - Cổng: 8286
  - Phiên bản: v3.0.0
  - Trạng thái: Chưa kết nối

Bước hai: Chuyển

1. Chọn phiên bản Mbbrowser mục tiêu
2. Nhấp nút "Chuyển"
3. MBAgent sẽ ngắt kết nối phiên bản hiện tại, kết nối phiên bản mới
4. Lưu ý: Chuyển sẽ dừng tất cả thao tác Mbbrowser hiện tại

TIP

Sử dụng hàng ngày: 99% người dùng chỉ cần một phiên bản Mbbrowser, không cần chuyển.

---

Sáu, Quá trình AI thao tác trình duyệt Mbbrowser

Khi MBAgent nhận chỉ thị "thao tác Mbbrowser", sẽ tự động thực thi quy trình sau:

[1] AI phân tích tác vụ
    "Mở cửa hàng 223223, kiểm tra đơn hàng hôm nay"
    ↓
[2] Gọi giao diện ControlV2
    - control.browser.start({ environment_id: "223223" })
    ↓
[3] Trình duyệt Mbbrowser khởi động môi trường
    - Tạo / tái sử dụng môi trường 223223
    - Áp dụng dấu vân tay / proxy / Cookie
    - Trả về browser_handle
    ↓
[4] MBAgent tiếp quản trang qua CDP
    - attach({ handle })
    - Nhận ảnh chụp trang, cấu trúc DOM
    ↓
[5] AI phân tích trang + quyết định bước tiếp theo
    "Đã thấy trang đơn hàng, bước tiếp theo trích xuất số"
    ↓
[6] Thực thi hành động
    - click / type / extract
    ↓
[7] Hoàn thành tác vụ, đóng môi trường (hoặc giữ mở)
    ↓
[8] Sắp xếp kết quả cho người dùng
    "Đơn hàng hôm nay 23 đơn, số tiền $1234.56"

Khái niệm chính

• handle (handle): "Handle môi trường" trình duyệt Mbbrowser trả về cho MBAgent, dùng để tham chiếu một môi trường cụ thể
• attach (gắn vào): MBAgent tiếp quản một trang môi trường Mbbrowser
• CDP: Chrome DevTools Protocol, giao thức tầng dưới trình duyệt Mbbrowser sử dụng

---

Bảy, Câu hỏi thường gặp

Q1: MBAgent sau khi khởi động hiển thị "Đang chờ Mbbrowser CDP"

Nguyên nhân: Trình duyệt Mbbrowser chưa khởi động, hoặc môi trường chưa khởi động.

Giải pháp:

1. Xác nhận trình duyệt Mbbrowser đã khởi động và đăng nhập
2. Trong trình duyệt Mbbrowser khởi động thủ công một môi trường
3. MBAgent tự động tiếp quản

Q2: AI thao tác môi trường Mbbrowser luôn thất bại

Nguyên nhân có thể:

• ControlV2 bất thường (xem phát hiện dịch vụ chính thức)
• Hạn ngạch tài khoản Mbbrowser hết
• Môi trường Mbbrowser bị hỏng

Khắc phục:

1. Tại Cài đặt → Phát hiện dịch vụ chính thức xem ControlV2 có bình thường không
2. Kiểm tra hạn ngạch AI tài khoản Mbbrowser
3. Trong trình duyệt Mbbrowser thử thủ công môi trường đó

Q3: Sau khi tiếp quản trang Mbbrowser hình ảnh đen

Nguyên nhân có thể:

• Trình duyệt Mbbrowser vừa khởi động, môi trường chưa sẵn sàng
• Tài khoản Mbbrowser cần xác minh hai bước

Giải pháp:

1. Chờ 5-10 giây rồi thử lại
2. Trong trình duyệt Mbbrowser thủ công hoàn thành xác minh

Q4: Có thể để MBAgent điều khiển trình duyệt Mbbrowser từ xa không?

❌ Không thể. Kết nối Mbbrowser Client ControlV2 của MBAgent ở tầng thực thi giới hạn cứng là 127.0.0.1 (ControlClientError::NonLoopbackEndpoint), không chấp nhận bất kỳ địa chỉ IP không phải loopback nào. Ngay cả khi phơi bày cổng ControlV2 của trình duyệt Mbbrowser ra ngoài (ví dụ 0.0.0.0:8186), MBAgent cũng sẽ từ chối kết nối trực tiếp ở giai đoạn bắt tay.

Cách điều khiển Mbbrowser từ xa đúng đắn:

• Dùng script Selenium / Puppeteer / Playwright, qua ApiServer tích hợp sẵn của trình duyệt Mbbrowser (http://127.0.0.1:8186) gọi từ xa——chi tiết xem phần trên "Hai, Ba chế độ kết nối giữa MBAgent và Mbbrowser → 2. Đầu cuối điều khiển ApiServer"
• Trong kịch bản này, MBAgent không tham gia, chỉ với vai trò client HTTP thường gọi giao diện ApiServer của Mbbrowser

NOTE

Tại sao giới hạn loopback:

• Bản thân giao thức ControlV2 không có kiểm tra định danh mạnh, cổng TCP phơi bày trên mạng công cộng tương đương "quyền điều khiển tài khoản Mbbrowser giao cho bất kỳ ai"
• MBAgent và trình duyệt Mbbrowser giả định chạy cùng máy, cùng ngữ cảnh tài khoản, loopback là biên giới rủi ro thấp nhất

Q5: MBAgent không thao tác trình duyệt Mbbrowser có dùng được không?

✅ Hoàn toàn có thể. Chức năng cốt lõi của MBAgent (chat, tài liệu, mã, thư viện kiến thức) không phụ thuộc trình duyệt Mbbrowser. Chỉ khi bạn yêu cầu rõ ràng thao tác môi trường tài khoản Mbbrowser mới thiết lập kết nối ControlV2.

---

Tám, Thực hành tốt nhất

Thứ tự khởi động

Thứ tự khởi động đề xuất:

1. Trình duyệt Mbbrowser (khởi động trước và đăng nhập)
2. MBAgent (khởi động sau, tự động kết nối)

Không đảo ngược.

Khi không dùng lâu dài

Nếu bạn không thao tác trình duyệt Mbbrowser trong thời gian dài:

1. Đóng lối vào thanh bên "Thư viện kiến thức RAG Mbbrowser" và "Mbbrowser Client ControlV2" trong MBAgent
2. Giảm thao tác Mbbrowser trong tác vụ
3. Tiết kiệm chiếm dụng tài nguyên tài khoản Mbbrowser

Cộng tác nhiều người

Nếu nhiều người trong nhóm chia sẻ một tài khoản Mbbrowser:

1. MBAgent của mỗi người đều có thể kết nối độc lập
2. Nhưng thao tác đồng thời một môi trường sẽ xung đột
3. Đề xuất sử dụng xen kẽ, hoặc mỗi người mở tài khoản con Mbbrowser độc lập

---

Bước tiếp theo: Quản lý quyền và sử dụng an toàn → Yên tâm để AI làm việc.