Orbe Tài liệu English Bắt đầu

Workflow Editor

Dựng tự động hoá mà không cần viết mã. Kéo các khối vào dòng thời gian, điền vài trường, và Orbe biến nó thành một kịch bản (flow) thật, chạy được — cùng loại mà SDK chạy, điều khiển qua kênh nội bộ nên không có dấu vết tự động hoá.

Hiện có gì: bạn dựng flow bằng tay — kéo khối, điền trường, kiểm tra và chạy — và đã có thể nhờ trợ lý AI của riêng bạn soạn nháp qua máy chủ MCP của Orbe (xem Dựng bằng AI).
  • Khối, không phải mã. Mỗi khối là một bước rõ ràng — mở trang, chờ chữ, nhấp, gõ, đọc, rẽ nhánh, lặp.
  • Chạy thật. Một flow là flow Orbe bình thường; thứ bạn dựng trong trình soạn thảo chính là thứ được chạy, và Validate kiểm tra nó trước khi bạn chạy.
  • Không dấu vết. Flow chạy qua cùng kênh nội bộ với SDK — không CDP, không navigator.webdriver, không cổng gỡ lỗi. Xem Tự động hoá và SDK.
  • Xác định. Bộ máy làm đúng điều các khối nói — không có AI ẩn khi chạy — nên bạn thấy gì thì chạy đó.

Orbe có sẵn vài flow mẫu để bạn đọc và chỉnh sửa — Basic login, Warm-up browsing và Post from a CSV list.

Trình soạn thảo

Trình soạn thảo gồm ba khung và một thanh công cụ:

  • Palette (trái) — các khối bạn có thể thêm, chia theo nhóm.
  • Canvas (giữa) — flow của bạn dưới dạng dòng thời gian từ trên xuống. Nhánh và vòng lặp lồng bên trong khối của chúng, thụt vào.
  • Inspector (phải) — các trường của khối đang chọn, và danh sách biến của bạn.

Thanh công cụ, từ trái sang phải: Validate; ▶ Run — chạy flow trên hồ sơ đang chọn trong danh sách Profiles của bạn (chưa chọn hồ sơ nào thì sẽ yêu cầu chọn); Pacing: On — nhịp nghỉ an toàn cho tài khoản của flow này, lưu theo từng flow; ✦ AI; và More ▾ gồm Undo, Redo, Save flow…, Open flow…, ⇄ Convert a script from another tool… và Allowed steps…. Một nút xem lại cũng xuất hiện khi flow nhập vào có các bước đang chờ bạn xem xét.

Các khối

Các khối được chia nhóm theo chức năng. Mỗi khối ứng với một bước thật mà Orbe có thể chạy.

NhómKhốiChức năng
NavigateOpen profile · Go to URL · Delay · Wait for element · CloseMở hồ sơ, chuyển tới một trang, tạm dừng, chờ tới khi một đoạn chữ xuất hiện, đóng.
ActMouse click · Type text · Scroll · Scroll untilThao tác nhập có nhịp như người: nhấp theo chữ của phần tử (hoặc toạ độ), gõ vào ô, cuộn, hoặc cuộn xuống tới khi có thứ xuất hiện.
ReadRead page text · List elements · ScreenshotĐọc trang ở phía trình duyệt (không có script trong trang), liệt kê các phần tử có thể thao tác, hoặc chụp khung hình.
DataSet variableLưu một giá trị để dùng lại sau trong flow.
ControlIf · For (repeat) · While · Retry · Try · Assert · StopRẽ nhánh theo điều kiện, lặp một nhóm bước, thử lại khi lỗi, thử một bước có phương án dự phòng, khẳng định trang đang ở trạng thái mong đợi, hoặc dừng lượt chạy.

Đây chỉ là tổng quan các nhóm. Danh sách đầy đủ, luôn cập nhật — mọi khối kèm các trường và ví dụ — xem tại Khối và hành động.

Các trường. Chọn một khối sẽ hiện các trường của nó trong Inspector. Vài ví dụ: Go to URL nhận địa chỉ; Wait for element nhận chữ cần chờ và thời gian chờ tối đa (tuỳ chọn); Mouse click nhận chữ hiển thị của phần tử (hoặc cặp x,y); Type text nhận chữ cần gõ, ô cần focus trước và có nhấn Enter hay không; If nhận một điều kiện (có chữ, có phần tử, hoặc biến bằng một giá trị); For lặp một số lần hoặc một lần cho mỗi dòng dữ liệu của bạn. Trường bắt buộc được đánh dấu, và Save sẽ không nhận khối còn thiếu trường bắt buộc.

Nhánh và vòng lặp

Các khối điều khiển là vùng chứa: khối If, For hoặc Retry giữ các bước chạy bên trong nó, lồng và thụt vào trên dòng thời gian. Không có dây nào để vẽ — thứ tự của flow đơn giản là thứ tự các khối, và bạn sắp xếp lại bằng cách kéo.

  • If — chạy một nhóm bước khi điều kiện đúng (ví dụ có một đoạn chữ), và tuỳ chọn chạy nhóm khác trong trường hợp ngược lại.
  • For (repeat) — chạy một nhóm bước một số lần, hoặc một lần cho mỗi dòng của nguồn dữ liệu.
  • Retry — chạy một nhóm bước, và thử lại nếu thất bại, tối đa tới một giới hạn.
  • Stop — kết thúc lượt chạy, kèm lý do (tuỳ chọn).

Biến

Biến giữ một giá trị để bạn dùng lại. Kéo một biến vào một trường để chèn nó dưới dạng {{name}} — ví dụ gõ {{username}} vào ô đăng nhập.

Biến của bạn đến từ nhiều nơi, được gom thành một danh sách trong Inspector:

  • các biến bạn khai báo trên flow,
  • các cột của nguồn dữ liệu (CSV), khi bạn lặp qua từng dòng,
  • một khối Set variable,
  • kết quả của khối Read page text hoặc List elements.

Chọn phần tử

Các khối tác động lên trang — Mouse click, Wait for element và tương tự — tìm mục tiêu theo chữ hiển thị của nó. Phần lớn trường hợp thế là đủ. Khi nhiều phần tử có cùng chữ (ba nút "Follow", một nút "Next" cả ở đầu và chân trang), khối sẽ mơ hồ, nên trình soạn thảo cho bạn một công cụ chọn phần tử nhỏ trong Inspector để chốt đúng một phần tử:

TrườngChức năng
TextChữ hiển thị cần khớp.
MatchContains (mặc định) hoặc Exact — chữ chỉ là một phần, hay là toàn bộ nhãn của phần tử.
ScopeGiới hạn tìm kiếm trong một vùng chứa (ví dụ chỉ trong thanh bên), để cùng chữ ở nơi khác bị bỏ qua.
NthKhi vẫn còn nhiều hơn một phần tử khớp, chọn cái thứ 1, 2, … theo chỉ số.
Nếu khi chạy một khối vẫn có thể khớp nhiều hơn một phần tử, lượt chạy sẽ tạm dừng thay vì nhấp nhầm cái — nên bộ chọn mơ hồ sẽ dừng an toàn chứ không thao tác lên phần tử sai. Hãy siết chặt công cụ chọn (thêm scope hoặc nth) rồi chạy lại.

Kiểm thử và chạy

  • Validate kiểm tra flow có vấn đề gì không trước khi bạn chạy.
  • ▶ Run kiểm tra lại, rồi chạy flow trên hồ sơ đang chọn trong danh sách Profiles — mỗi lượt chạy một hồ sơ.

Trình soạn thảo chạy từng hồ sơ một; để chạy nhiều hồ sơ từ mã, xem Chạy tài khoản quy mô lớn.

Mọi việc một flow làm vẫn đi qua lớp kỷ luật của Orbe — kiểm tra proxy, dừng ở checkpoint, nhịp nghỉ an toàn cho tài khoản và cảnh báo ngoài giờ. Xem An toàn mặc định.

Tệp flow

Tệp flow là một tệp .orbeflow — định nghĩa các bước ở dạng thuần, mang đi được, không có gì thêm.

  • Save flow… (trong More ▾, hoặc Ctrl+S) lưu flow thành tệp .orbeflow. Flow không hợp lệ sẽ không được lưu — dòng trạng thái báo Couldn't save kèm lý do.
  • Open flow… (trong More ▾) mở một tệp. Bạn cũng có thể nhấp đúp một tệp .orbeflow (Orbe đăng ký loại tệp này khi cài) hoặc chạy Orbe.exe --open-flow <file>. Tệp hỏng sẽ bị từ chối và flow hiện tại của bạn được giữ nguyên.
  • Bản nháp của bạn được giữ tự động — khoảng một giây sau mỗi thay đổi và khi bạn thoát — và nó quay lại trong thẻ Automation lần sau bạn mở Orbe, kể cả khi chưa hoàn thành.
Kiểm tra trước khi chia sẻ. Tệp .orbeflow chỉ mang các bước — không mang cookie hay vân tay của hồ sơ. Khi một khối cần bí mật — hạt giống 2FA, khoá API — hãy cho nó một tham chiếu tới vault của bạn (ví dụ vault:my-account-totp) để bản thân bí mật ở lại máy này; giá trị gõ thẳng vào trường sẽ được lưu trong tệp đúng như đã gõ. Khi bạn lưu flow, Orbe đề nghị thay các giá trị trông giống mật khẩu hoặc khoá bằng chỗ giữ chỗ. Hãy kiểm tra tệp trước khi chia sẻ.

Niềm tin đến từ đâu

Tệp .orbeflow không bao giờ mang niềm tin — niềm tin được quyết định bởi cách nó đến được Orbe này, không phải bởi thứ gì viết trong tệp. Đây là chủ ý: một tệp không thể tự bảo đảm cho chính nó.

  • Mọi flow mở từ tệp — kể cả flow bạn tự lưu, flow bạn nhận được, flow từ thư viện mẫu, hay flow do trợ lý soạn — đều mở ra được đánh dấu Imported · Untrusted flow và chạy ở chế độ không tin cậy cho tới khi bạn xem lại: ảnh chụp chỉ được lưu trong thư mục downloads, thời gian chờ bị giới hạn, và các bước nhạy cảm (Set proxy, HTTP request, Google Sheet, Solve captcha, 2FA code, các bước cookie, Regex extract và mọi bước dùng tham chiếu vault) không chạy cho tới khi bạn cho phép — xem Cho phép các bước nhạy cảm.
  • Bản nháp tự lưu giữ nguyên mức tin cậy vốn có — flow bạn dựng bằng tay vẫn tin cậy, còn flow không tin cậy vẫn không tin cậy; bản nháp không bao giờ được nâng thành tin cậy.

Cho phép các bước nhạy cảm

Flow mở từ tệp, script nhập từ công cụ khác và flow do AI soạn đều chạy ở chế độ không tin cậy. Trong đó, một bước nhạy cảm sẽ dừng lượt chạy trước khi nó hành động. Điều này gồm cả Regex extract: nó dừng trước khi chạy mẫu của nó, vì một mẫu viết để quay lui vô tận có thể làm treo bộ máy.

Chỉ cho phép các bước trong flow từ nguồn bạn tin cậy: các bước này có thể gửi dữ liệu ra ngoài, đổi proxy hoặc dùng bí mật bạn đã lưu. Nếu bạn không viết flow đó và không chắc một bước làm gì, đừng cho phép.
  1. Nhấp Review & allow N sensitive steps trên thanh công cụ (nút chỉ xuất hiện khi flow có các bước như vậy).
  2. Đọc danh sách trong Review & allow these N sensitive steps, rồi nhấp Allow these N steps.
  3. Nút đổi thành ✓ N sensitive steps allowed, và ▶ Run chạy flow bình thường — không cần lưu trước.

Quyền cho phép thuộc về đúng flow này: đổi bất kỳ bước nào là bạn sẽ bị hỏi lại. Quyền hết hạn sau 30 ngày. More ▾ → Allowed steps… liệt kê những gì bạn đã cho phép và cho bạn Revoke chúng. Flow bạn dựng bằng tay trong trình soạn thảo là tin cậy và không bao giờ hỏi.

Tệp được kiểm tra khi mở — bước lạ hoặc bước chứa mã tự do sẽ bị từ chối (flow là dữ liệu, không phải mã; xem An toàn). Thứ bạn thấy trong trình soạn thảo chính là thứ sẽ chạy.

Dựng bằng AI

Mô tả điều bạn muốn bằng lời thường cho trợ lý AI của riêng bạn — Claude, Cursor hoặc bất kỳ ứng dụng khách MCP nào — và để nó soạn flow cho bạn. Việc này chạy qua máy chủ MCP của Orbe với hai công cụ chỉ xử lý dữ liệu:

  • list_blocks — trợ lý đọc các khối Orbe hỗ trợ và các trường của chúng, để nó dựng đúng bằng những bước này và không gì khác.
  • submit_flow — trợ lý gửi flow nó đã viết vào Orbe dưới dạng bản nháp. Nó được kiểm tra và lưu, nhưng không bao giờ chạy — nó mở trong trình soạn thảo để bạn xem lại, chỉnh sửa và tự chạy.
Flow do AI soạn đến với nhãn AI-drafted · Untrusted flow. Hãy xem lại trước khi chạy. Orbe không bao giờ tự chạy flow do AI soạn — AI có thể hiểu sai ý bạn hoặc bị trang web đánh lừa. Hãy duyệt nó vào trình soạn thảo, kiểm tra từng bước (đặc biệt bước nào điều hướng, gõ chữ hoặc dùng dữ liệu của bạn), rồi tự nhấn Run. Trợ lý viết các khối; bộ máy vẫn chạy chúng theo cách xác định, nên thứ bạn xem lại chính là thứ được chạy. Đừng gửi bí mật cho trợ lý — flow là một định nghĩa thuần, và khoá Orbe, thông tin đăng nhập proxy, cookie, vân tay và dữ liệu cá nhân của bạn không thuộc về nó.

Phím tắt và điều khiển khối

Thêm một khối bằng cách kéo nó từ palette. Sắp xếp lại cũng bằng cách kéo: thả một khối lên khối khác để đặt nó ngay sau đó, hoặc vào trong một khối điều khiển để lồng nó. Nhấp chuột phải một khối để chọn Duplicate (sao chép nó, cùng các khối bên trong, ngay sau bản gốc) và Delete step — cả hai đều có thể hoàn tác.

PhímThao tác
Ctrl+Z / Ctrl+YHoàn tác / làm lại
Ctrl+SLưu — vào tệp bạn lưu hoặc mở gần nhất; lần đầu sẽ hỏi nơi lưu
Delete / BackspaceXoá khối đang chọn (khi canvas đang có focus — gõ trong một trường không bao giờ xoá khối)

An toàn

  • Flow là dữ liệu, không phải mã. Nó là danh sách các bước của chính Orbe — không có khối nào chạy Python hay JavaScript tuỳ ý, nên flow bạn nhập vào hoặc do trợ lý soạn không thể làm gì ngoài các bước Orbe đã cung cấp.
  • Flow nhập vào và flow do AI soạn được kiểm tra trước khi chạy — bước lạ bị từ chối.
  • Chống chạy mất kiểm soát. Một lượt chạy có trần về tổng số bước và thời gian (cùng giới hạn về thời gian một lần chờ có thể chặn), nên một flow hỏng hoặc được chia sẻ không thể quay mãi.
  • Giữ nguyên tàng hình. Flow chạy qua kênh nội bộ y như SDK — không CDP, không cổng gỡ lỗi, thao tác nhập có nhịp như người.

Xem thêm Tự động hoá và SDK và Chạy tài khoản quy mô lớn.