- Hiển thị JavaScript và tương tác thực của người dùng (nhấp, cuộn, điền biểu mẫu)
- Phiên làm việc được lưu giữ (cookie/bộ nhớ) thông qua hồ sơ
- Định tuyến proxy và cấu hình trình duyệt có thể lặp lại
Lưu ý: Trang này mô tả một mô hình tích hợp kỹ thuật. Nó không thay đổi quy tắc của các trang web đích và không đảm bảo quyền truy cập.
Mô hình tích hợp tổng quan
AI agent thường không “kết nối trực tiếp với trình duyệt”. Thay vào đó, chúng:- lên kế hoạch cho bước tiếp theo
- gọi các công cụ/hàm mà bạn cung cấp (tool calling)
- đọc kết quả có cấu trúc và tiếp tục
- kết nối với một phiên đám mây (token + hồ sơ tùy chọn)
- thực hiện các thao tác trên trình duyệt (điều hướng, nhấp, trích xuất, chụp ảnh màn hình)
- trả kết quả có cấu trúc về cho agent
Kiến trúc đề xuất
AI agent (Claude / Codex / khác) -> gọi máy chủ công cụ của bạn (dịch vụ Node/Python) -> máy chủ công cụ sử dụng Playwright/Puppeteer -> kết nối với Gologin Cloud Browser (điểm cuối từ xa) -> trả kết quả (văn bản/JSON/tham chiếu ảnh chụp màn hình) về cho agent Lý do nên dùng mô hình này:- token Gologin của bạn luôn nằm phía máy chủ
- bạn có thể áp dụng giới hạn tốc độ, thử lại, ghi nhật ký và kiểm tra an toàn
- bạn có thể tái sử dụng hồ sơ và proxy một cách nhất quán
Điều kiện tiên quyết
1) API token (phía máy chủ)
Tạo token trong ứng dụng Gologin: API & MCP → API → Mã thông báo mới.Hãy coi token là thông tin bí mật. Không để lộ token trong mã phía client.
2) (Khuyến nghị) Hồ sơ và proxy qua REST API
Cloud Browser là lớp thực thi/chạy trình duyệt. Để quản lý hồ sơ (tạo/cập nhật) và cấu hình proxy, hãy dùng REST API:- Profiles API: https://gologin.com/docs/api-reference/profile
- Proxy API: https://gologin.com/docs/api-reference/proxy
Quan trọng: Nếu hồ sơ có proxy cấu hình sai hoặc không thể truy cập, phiên cloud browser sẽ không khởi động được và báo lỗi hết thời gian chờ proxy. Hãy kiểm tra proxy có truy cập được trước khi kết nối, hoặc đặt chế độ proxy là none khi thử nghiệm.
Hai URL — hiểu rõ sự khác biệt
Gologin cung cấp hai URL khác nhau cho Cloud Browser. Chúng phục vụ các mục đích khác nhau:
Chỉ điểm cuối
/connect hoạt động với Puppeteer/Playwright. URL Live View trả về giao diện truyền phát HTML và không thể dùng làm browserWSEndpoint.
Kết nối với phiên đám mây
Hãy dùng điểm cuối chuẩn của Cloud Browser:token— API token Gologin của bạnprofile— ID hồ sơ (tùy chọn)- Dùng
profileIdkhi bạn muốn có phiên làm việc được lưu giữ và cấu hình được kiểm soát - Nếu bỏ qua
profile, một hồ sơ mới có thể được tạo cho phiên
- Dùng
/connect tự động khởi động phiên trình duyệt — không cần gọi API riêng trước khi kết nối.
Ví dụ triển khai (Puppeteer/Playwright):
https://gologin.com/docs/api-reference/cloud-browser/getting-started
Công cụ CLI dựng sẵn so với công cụ tùy chỉnh
Bạn có hai lựa chọn để cấp cho agent quyền truy cập trình duyệt:Lựa chọn A: Dùng các công cụ CLI của Gologin (khuyến nghị cho hầu hết trường hợp)
- Agent Browser CLI — CLI dựng sẵn với các lệnh
open,snapshot,click,type,fill,screenshot,closevà hơn 30 lệnh khác. Bao gồm daemon chạy liên tục, tương tác dựa trên ref và đầu ra gọn nhẹ được thiết kế cho vòng lặp của agent. - Web Access CLI — CLI hợp nhất kết hợp thu thập dữ liệu (Web Unlocker) và tương tác với trình duyệt trong một công cụ.
- AI Skills — các skill cắm là chạy dành cho Claude Code, tự động xử lý mọi thứ.
Lựa chọn B: Xây dựng công cụ tùy chỉnh với Puppeteer/Playwright
Nếu cần toàn quyền kiểm soát, hãy triển khai một bộ nhỏ các hàm bao quanh Playwright/Puppeteer và cung cấp chúng dưới dạng công cụ. Thường chỉ cần một bộ tối thiểu:open_url(url)click(selector)type(selector, text)wait_for(selector | timeout)extract_text(selector | page)screenshot()close_session()
Quan trọng: quản lý phiên giữa các lần gọi công cụ
Đây là vấn đề kiến trúc quan trọng nhất đối với quy trình agent. AI agent gọi các công cụ tuần tự qua nhiều bước. Mỗi lần gọi công cụ phải tái sử dụng cùng một kết nối trình duyệt — nếu bạn tạopuppeteer.connect() mới ở mỗi lần gọi công cụ, bạn sẽ mất cookie, bộ nhớ cục bộ và trạng thái trang giữa các bước.
Mô hình khuyến nghị: duy trì một session singleton trên máy chủ công cụ của bạn.
getSession() để lấy phiên dùng chung:
Công cụ nên trả về gì cho agent?
Hãy trả về kết quả nhỏ gọn, có cấu trúc để agent có thể tiếp tục một cách ổn định, ví dụ:- URL hiện tại
- văn bản/JSON đã trích xuất
- phần tử có được tìm thấy hay không
- tham chiếu ảnh chụp màn hình (nếu bạn lưu trữ)
- loại lỗi (hết thời gian chờ, lỗi điều hướng, v.v.)
Lưu ý vận hành
- Bảo mật: giữ token ở phía máy chủ; không bao giờ nhúng token vào ứng dụng client.
- Quản lý phiên: đóng phiên khi hoàn tất để tránh chạm giới hạn đồng thời. Gọi
closeSession()khi quy trình của agent kết thúc. - Độ tin cậy: thêm cơ chế thử lại/backoff cho các lỗi tạm thời (hết thời gian chờ, lỗi điều hướng).
- Khả năng quan sát: để gỡ lỗi, bạn có thể mở Live View khi có sẵn. Định dạng URL ví dụ:
https://cloudbrowser.gologin.com/browsers/{profileId}/{sessionId-or-view-token}/
Hạn chế
- Kết quả phụ thuộc vào trang web đích và cấu hình của bạn.
- Các trang web có thể chặn tự động hóa; Cloud Browser là môi trường chạy, không phải là sự đảm bảo.
- Kết nối với cùng một hồ sơ từ nhiều phiên đồng thời có thể gây xung đột — hãy chỉ dùng một kết nối cho mỗi hồ sơ tại một thời điểm.
- Áp dụng hạn mức và giới hạn tốc độ: https://gologin.com/docs/api-reference/limitations/rate-limits