cloud

Tổng quan về cloud skill

cloud skill dùng để làm gì

cloud skill là trợ lý định hướng theo tài liệu dành cho Browser Use Cloud — nền tảng và API tự động hóa trình duyệt được lưu trữ trên cloud. Skill này phù hợp nhất khi bạn cần tự động hóa website qua dịch vụ cloud, dùng REST API hoặc SDK, kết nối các công cụ trình duyệt bên ngoài qua CDP, hoặc thiết kế workflow xoay quanh session, profile, proxy và theo dõi trực tiếp.

Ai nên cài cloud skill này

Hãy cài cloud skill nếu công việc thực tế của bạn thuộc một trong các trường hợp sau:

• bắt đầu với Browser Use Cloud nhanh mà không cần đọc toàn bộ tài liệu tham chiếu
• chọn giữa v2 REST API, v3 agent API, dùng SDK hay kết nối trình duyệt trực tiếp
• tự động hóa tác vụ trình duyệt từ Python, TypeScript, cURL hoặc công cụ bên ngoài
• chạy browser automation trên hạ tầng hosted cho các use case Browser Automation
• làm việc với session, profile lưu trạng thái, residential proxy, xử lý CAPTCHA hoặc webhook

Không nên cài nếu thứ bạn thật sự cần là hỗ trợ cấu hình thư viện Python mã nguồn mở browser-use chạy local. cloud skill này tách bạch rất rõ phần sử dụng cloud với gói agent mã nguồn mở.

Điều gì khiến cloud skill này khác với một prompt chung chung

Một prompt thông thường có thể mô tả browser automation ở mức khái quát. cloud skill hữu ích hơn khi bạn cần đúng các đường dẫn tài liệu của Browser Use Cloud: nên đọc phiên bản API nào, cơ chế auth hoạt động ra sao, liveUrl xuất phát từ đâu, session trên cloud khác gì với các lần chạy one-off, cách khởi động truy cập CDP và kiểu tích hợp nào hợp với stack của bạn.

Giá trị lớn nhất của skill này nằm ở khả năng điều hướng và định hướng mức độ phù hợp, không phải ở “tool bí mật” nào đó. Nó đưa bạn tới đúng file tham chiếu một cách nhanh chóng:

• references/quickstart.md cho thiết lập ban đầu và pricing
• references/api-v2.md cho các REST endpoint ổn định
• references/api-v3.md cho agent API mới hơn dựa trên session
• references/browser-api.md cho Playwright, Puppeteer, Selenium và CDP thô
• references/sessions.md cho thiết kế session và profile
• references/features.md cho proxies, webhooks, workspaces, skills, MCP và live view
• references/patterns.md cho chạy song song, streaming, geo-scraping và structured output

Các trường hợp cloud skill phù hợp nhất cho Browser Automation

cloud skill này đặc biệt phù hợp khi bạn cần cloud cho Browser Automation thay vì điều khiển trình duyệt cục bộ. Một số tình huống thường gặp:

• scraping hoặc extraction cần stealth và proxy
• workflow có đăng nhập cần profile trình duyệt lưu trạng thái lâu dài
• session trình duyệt từ xa mà bạn có thể theo dõi qua liveUrl
• tự động hóa trực tiếp từ Playwright, Puppeteer hoặc Selenium qua CDP hosted
• tích hợp với hệ thống agent, chat UI, công cụ no-code hoặc backend chạy theo webhook

Những trở ngại chính cần kiểm tra trước khi quyết định dùng cloud skill

Phần lớn quyết định cài hay không đều xoay quanh vài câu hỏi thực tế:

• Bạn cần automation trên cloud được hosted hay quyền điều khiển local bằng mã nguồn mở?
• Bạn muốn dùng v2 REST endpoint ổn định hay mô hình session/message mới hơn của v3?
• Bạn cần các tác vụ run() đơn giản hay cần quản lý session/profile tường minh?
• Bạn đang dùng SDK, cURL hay framework trình duyệt bên ngoài qua CDP?
• Bạn có cần định tuyến theo khu vực địa lý, lưu auth lâu dài hay webhook callback không?

Nếu những câu hỏi này vẫn chưa rõ, cloud skill sẽ hữu ích vì repo được tổ chức theo hướng hỗ trợ ra quyết định, không phải theo một tutorial tuyến tính duy nhất.

Cách dùng cloud skill

Cài cloud skill

Dùng trình cài skills tiêu chuẩn với repository và chỉ định cloud skill:

npx skills add https://github.com/browser-use/browser-use --skill cloud

Sau khi cài, hãy gọi skill này khi yêu cầu của bạn liên quan cụ thể đến Browser Use Cloud, không phải gói mã nguồn mở chạy local.

Bắt đầu từ đúng file theo đúng mục tiêu

Hãy đọc theo hướng ra quyết định, không phải theo thứ tự file:

• Mới làm quen với nền tảng: references/quickstart.md
• Cần API ổn định và ví dụ cURL: references/api-v2.md
• Cần mô hình agent/session mới hơn: references/api-v3.md
• Cần truy cập trình duyệt hosted từ các browser framework sẵn có: references/browser-api.md
• Cần trạng thái lưu lâu dài, auth hoặc chiến lược profile: references/sessions.md
• Cần tính năng nâng cao như proxy hoặc webhook: references/features.md
• Cần mẫu triển khai: references/patterns.md

Điểm này quan trọng vì cloud skill không che đi độ phức tạp của sản phẩm; nó giúp bạn chọn lộ trình đọc ngắn nhất nhưng vẫn đủ dùng.

Hiểu 4 hướng sử dụng cloud skill chính

Trước khi viết prompt, hãy xác định bạn muốn một trong các hướng sau:

1. thực thi tác vụ run() qua SDK
2. v2 REST API với các endpoint task/session/browser
3. v3 agent API với sessions, messages và workspaces
4. kết nối trình duyệt trực tiếp qua CDP cho Playwright, Puppeteer hoặc Selenium

Nhiều prompt yếu thất bại vì chỉ hỏi chung chung về “Browser Use Cloud usage” mà không nói rõ hướng sử dụng mong muốn.

Thiết lập xác thực cho đúng

Browser Use Cloud dùng header X-Browser-Use-API-Key, và SDK thường đọc BROWSER_USE_API_KEY từ biến môi trường.

export BROWSER_USE_API_KEY=your-key

Một số chi tiết hữu ích được chỉ ra ngay trong tài liệu tham chiếu:

• API base cho v2: https://api.browser-use.com/api/v2
• API base cho v3: https://api.browser-use.com/api/v3
• Tạo API key tại: https://cloud.browser-use.com/new-api-key

Nếu prompt của bạn không nói rõ muốn xử lý auth theo cách nào, câu trả lời rất dễ dừng ở mức quá trừu tượng.

Chọn SDK, REST hay CDP trước khi xin ví dụ

Dùng ví dụ SDK khi bạn muốn trải nghiệm phát triển đơn giản nhất.
Dùng REST khi bạn cần quyền kiểm soát ở cấp endpoint.
Dùng CDP khi bạn đã có sẵn code browser automation và chỉ cần một đích trình duyệt hosted.

Khác biệt này ảnh hưởng trực tiếp tới câu trả lời:

• câu trả lời theo SDK tập trung vào run(), sessions, profiles và structured output
• câu trả lời theo REST tập trung vào endpoint, polling, schema và headers
• câu trả lời theo CDP tập trung vào WebSocket URL và cách tích hợp với công cụ trình duyệt

Biến một mục tiêu mơ hồ thành prompt dùng cloud skill hiệu quả

Prompt yếu:

Help me use Browser Use Cloud.

Prompt tốt hơn:

I want cloud usage guidance for Python. I need a hosted browser workflow that logs into a site, persists cookies across runs, uses a US proxy, and lets me monitor progress live. Show whether I should use run() with auto-created sessions or manual sessions with a profile, and point me to the exact repo files to read first.

Vì sao prompt này tốt hơn:

• nêu rõ ngôn ngữ
• nêu rõ loại workflow
• đề cập nhu cầu lưu session/trạng thái
• có yêu cầu proxy
• có yêu cầu theo dõi trực tiếp
• yêu cầu điều hướng tới file cụ thể, không chỉ xin code

Những thông tin đầu vào giúp cloud skill trả lời tốt hơn

Để cloud skill cho ra kết quả tốt hơn, hãy cung cấp:

• ngôn ngữ: Python, TypeScript, cURL
• chế độ API: v2, v3 hoặc chưa chắc
• kiểu thực thi: tác vụ one-shot, session nhiều bước hay điều khiển trình duyệt trực tiếp
• nhu cầu trạng thái: stateless hay profile lưu lâu dài
• nhu cầu hạ tầng: quốc gia proxy, custom proxy, timeout, kích thước màn hình
• nhu cầu quan sát: liveUrl, streaming, webhooks
• dạng đầu ra: văn bản tự do hay schema có cấu trúc
• đích tích hợp: Playwright, Puppeteer, Selenium, chat UI, subagent, công cụ no-code

Nếu thiếu các thông tin này, câu trả lời thường vẫn đúng nhưng sẽ quá rộng để triển khai nhanh.

Dùng cloud skill để thiết kế session và profile

Một giá trị thực tế lớn của cloud skill là giúp bạn tránh thiết kế session sai ngay từ đầu.

Theo các tài liệu tham chiếu:

• run() thường tự tạo session
• manual session phù hợp hơn cho workflow nhiều bước
• profile lưu cookies và local storage qua nhiều session
• các session chạy đồng thời dùng cùng một profile sẽ bắt đầu từ một snapshot và không nhìn thấy thay đổi trạng thái của nhau

Điểm cuối cùng rất dễ bị bỏ sót nếu chỉ lướt nhanh tài liệu, nhưng lại cực kỳ quan trọng với các workflow xác thực chạy song song.

Dùng cloud skill cho các framework Browser Automation

Nếu bạn đã dùng Playwright, Puppeteer hoặc Selenium, con đường phù hợp nhất có thể là truy cập trình duyệt cloud trực tiếp thay vì dùng agent task.

Repo cho thấy một điểm vào CDP như sau:

wss://connect.browser-use.com?apiKey=YOUR_KEY&proxyCountryCode=us&timeout=30

Điều này quan trọng vì trình duyệt có thể tự khởi động khi kết nối và tự dừng khi ngắt kết nối — đây là mô hình vận hành khác hẳn với việc tự tạo và tự hủy task theo cách thủ công.

Dùng cloud skill cho các tính năng cloud nâng cao

Skill này cũng đặc biệt hữu ích khi quyết định của bạn phụ thuộc vào tính năng nền tảng hơn là cú pháp:

• stealth mặc định
• residential proxies ở nhiều quốc gia
• custom proxies
• xử lý CAPTCHA
• webhooks có xác minh chữ ký
• xem trực tiếp và share links
• workspaces
• hỗ trợ skills và marketplace
• các tài liệu tham chiếu liên quan đến MCP

Đây chính là những chi tiết quyết định Browser Use Cloud có phù hợp với nhu cầu production hay không.

Workflow đầu tiên nên làm sau khi cài cloud skill

Một trình tự thực tế cho người mới:

1. Đọc references/quickstart.md
2. Chạy một tác vụ đầu tiên thật đơn giản bằng SDK hoặc cURL
3. Xác định xem workflow thật của bạn có cần manual sessions không
4. Chỉ thêm profiles khi cần lưu đăng nhập hoặc trạng thái
5. Chỉ thêm proxy và thiết lập địa lý khi thật sự cần
6. Thêm structured output hoặc webhooks sau khi đường đi cơ bản đã chạy ổn
7. Chuyển sang references/patterns.md khi cần concurrency hoặc streaming

Thứ tự này giúp giảm nhầm lẫn và tránh thiết kế quá mức trước khi có lần chạy thành công đầu tiên.

Câu hỏi thường gặp về cloud skill

cloud skill này chỉ là tài liệu hay có thay đổi hành vi thực thi?

Về bản chất, đây chủ yếu là một skill định tuyến tài liệu tham chiếu. Giá trị của nó nằm ở việc giúp agent hoặc người dùng chọn đúng lộ trình tài liệu Browser Use Cloud và trả lời với ít giả định sai hơn. Nó không thay thế SDK hay API của nền tảng.

cloud skill có phù hợp cho người mới bắt đầu không?

Có, nếu bạn là người mới với Browser Use Cloud nói riêng. Điểm bắt đầu tốt nhất là references/quickstart.md. Tuy vậy, bạn vẫn nên biết mình muốn thực thi tác vụ đơn giản, quản lý session hay điều khiển trình duyệt ở cấp framework.

Khi nào không nên dùng cloud skill?

Không nên dùng cloud skill cho các câu hỏi về nội bộ thư viện local browser-use mã nguồn mở, cấu hình agent hoặc thiết lập gói non-cloud. Bản thân skill cũng nói rõ rằng các trường hợp này nên dùng open-source skill.

Nên dùng v2 hay v3?

Dùng v2 nếu bạn muốn REST API ổn định với độ phủ endpoint rộng.
Dùng v3 nếu bạn muốn mô hình BU Agent API mới hơn với sessions, messages, files và workspaces, đồng thời chấp nhận rằng trong tài liệu tham chiếu nó được đánh dấu là experimental.

cloud skill có hỗ trợ các framework trình duyệt thông thường không?

Có. Repo có references/browser-api.md riêng cho Playwright, Puppeteer, Selenium và kết nối CDP trực tiếp tới các trình duyệt hosted.

cloud skill có tốt hơn một prompt bình thường cho Browser Automation không?

Với các tác vụ Browser Use Cloud, thường là có. Một prompt bình thường dễ bỏ sót các chi tiết đặc thù của nền tảng như auth headers, phiên bản endpoint, liveUrl, hành vi của profile, chữ ký webhook hoặc mô hình kết nối CDP tự khởi động.

cloud skill có đề cập tới pricing và các ràng buộc vận hành không?

Có. Tài liệu quickstart bao gồm pricing và phần FAQ, còn các tài liệu khác bao quát timeout, cách xử lý session, các lưu ý về concurrency và những ràng buộc theo từng tính năng.

Cách cải thiện cloud skill

Hãy yêu cầu cloud skill ra quyết định, không chỉ giải thích

Cách nhanh nhất để cải thiện đầu ra của cloud skill là yêu cầu nó chọn giữa các phương án:

• “Should I use v2, v3, or CDP?”
• “Should this be auto-session or manual session?”
• “Should I use a profile or keep it stateless?”

Cách hỏi này tạo ra hướng dẫn triển khai cụ thể thay vì một bản tóm tắt quá rộng.

Cung cấp tác vụ và môi trường thật cụ thể

Tốt hơn:

I need cloud install and usage help for a TypeScript backend. The workflow logs into a dashboard weekly, downloads a file, and posts completion to my server. I need persistent auth, webhook notifications, and a recommendation between SDK and REST.

Prompt này cho kết quả tốt hơn vì nó làm rõ ngôn ngữ, tần suất chạy, yêu cầu trạng thái và cách báo hoàn tất.

Nói rõ thứ gì phải được giữ lại giữa các lần chạy

Một lỗi phổ biến là mô tả trạng thái quá sơ sài. Nếu việc đăng nhập, cookies, local storage hoặc thông tin xác thực đã lưu có ý nghĩa quan trọng, hãy nói rõ điều đó và yêu cầu hướng dẫn theo profile từ references/sessions.md.

Nếu trạng thái không quan trọng, cũng nên nói rõ. Khi đó cloud skill có thể đề xuất các lần chạy one-shot đơn giản hơn.

Chỉ rõ bạn cần quan sát trực tiếp hay callback

Rất nhiều người dùng quan tâm một trong các nhu cầu sau nhưng lại quên nhắc tới:

• theo dõi tiến trình trực tiếp qua liveUrl
• stream cập nhật theo từng bước
• nhận webhook callback khi task hoàn tất

Mỗi nhu cầu dẫn tới mẫu triển khai khác nhau và cần đọc những file khác nhau.

Trước tiên hãy xin con đường tối thiểu có thể chạy được

Một cách cải thiện rất hiệu quả là:

1. xin ví dụ nhỏ nhất nhưng chạy được
2. chạy thử
3. sau đó mới hỏi cách thêm profile, proxy hoặc webhook

cloud skill mạnh nhất khi giúp bạn triển khai theo từng bước, không phải khi bị yêu cầu thiết kế toàn bộ kiến trúc production chỉ trong một lần.

Cẩn thận với việc lẫn lộn phiên bản API

Một trong những cách dễ nhất khiến cloud skill trả lời yếu là trộn lẫn khái niệm của v2 và v3 trong cùng một yêu cầu. Nếu bạn muốn so sánh, hãy nói rõ là cần so sánh. Nếu bạn muốn triển khai, hãy chỉ định một phiên bản.

Prompt tốt:

Compare Browser Use Cloud v2 vs v3 for a multi-step agent workflow, then recommend one and give only that version's starter example.

Hãy yêu cầu lộ trình đọc ở cấp file

Repo có đủ nhiều tài liệu tham chiếu để việc đọc đúng file sẽ tiết kiệm đáng kể thời gian. Hãy hỏi theo kiểu:

• “Which file should I read first for webhook verification?”
• “Which reference covers CDP and Playwright setup?”
• “Which document explains concurrent sessions with the same profile?”

Cách này khiến phần hướng dẫn cloud trở nên thực dụng hơn nhiều so với một bản tóm tắt chung chung.

Cải thiện đầu ra bằng tiêu chí thành công rõ ràng

Thay vì:

Show me cloud usage.

Hãy dùng:

Show me a cloud usage path that gets from API key to first successful task in under 10 minutes, then list the next file to read if I need structured output.

Tiêu chí thành công rõ ràng sẽ buộc câu trả lời đi theo một lộ trình áp dụng thực tế.

Sau câu trả lời đầu tiên, hãy bổ sung khoảng trống thay vì bắt đầu lại từ đầu

Sau phản hồi đầu tiên, hãy cải thiện nó bằng cách chỉ ra phần còn thiếu:

• thiếu cách xử lý auth
• thiếu ví dụ polling
• thiếu dọn dẹp session
• thiếu cấu hình proxy
• thiếu schema cho structured output
• thiếu xác minh webhook
• thiếu chi tiết kết nối Playwright

Cách này thường cho ra vòng trả lời thứ hai tốt hơn nhiều so với việc hỏi lại từ đầu.

Cách tốt nhất để nhận hướng dẫn cloud skill giá trị cao

cloud skill hoạt động tốt nhất khi prompt của bạn có đủ:

• stack bạn đang dùng
• mục tiêu browser automation
• trạng thái có cần được giữ giữa các lần chạy hay không
• bạn ưu tiên điều khiển trình duyệt hosted hay thực thi agent
• bạn có cần monitoring, streaming hoặc webhook không
• bạn có quan tâm tới định tuyến địa lý hoặc các ràng buộc về stealth không

Tổ hợp thông tin này cho cloud skill đủ ngữ cảnh để điều hướng bạn tới đúng tài liệu Browser Use Cloud và đưa ra hướng dẫn có thể áp dụng ngay.