Quy trình

Một quy trình là đồ thị các node nối với nhau. Nó bắt đầu từ một trigger, chuyển item (các dòng dữ liệu) từ node này sang node khác, và có thể điều khiển hồ sơ trình duyệt, tài khoản, thư, SMS, tệp, mô hình AI, điện thoại và ứng dụng bên ngoài. Engine chạy trong lõi ứng dụng, trên máy của bạn.

Trình soạn thảo

• Canvas: kéo node từ bảng bên, nối các cổng và sắp xếp. Node rẽ nhánh (If, Switch, Loop) có một đầu ra cho mỗi nhánh.
• Bảng node: mở trên một node để sửa tham số. Trường nhận giá trị cố định hoặc biểu thức đọc item đầu vào, các node trước, biến và ngữ cảnh lượt chạy. Dấu ? cạnh trường mở trợ giúp và liên kết tới danh mục node.
• Bản nháp: quy trình vẫn lưu được khi chưa hợp lệ; lỗi được liệt kê để bạn hoàn thiện sau.
• Phiên bản: mỗi lần lưu giữ một phiên bản để so sánh và khôi phục.

Trigger

Quy trình bắt đầu từ một trong:

• Thủ công, từ trình soạn thảo, danh sách quy trình, Local API hoặc mzb run;
• Lịch (theo chu kỳ hoặc cron);
• Webhook, lời gọi HTTP tới URL ứng dụng cấp cho bạn;
• Sự kiện trong MZBase, lỗi ở quy trình khác, hoặc lời gọi từ quy trình khác;
• tin nhắn chat từ trang Tác tử AI hoặc ứng dụng chat;
• trigger ứng dụng như dòng mới trong Google Sheets, tin nhắn Telegram hoặc Zalo OA.

Bật quy trình để trigger lịch, webhook hoặc sự kiện có thể khởi chạy nó.

Chạy trên hồ sơ

Một lượt chạy có thể nhắm tới một hoặc nhiều hồ sơ. Engine mở mỗi hồ sơ khi node trình duyệt cần (xem Hồ sơ: kiểm tra proxy, khóa, đồng bộ) và có thể đóng sau đó. Số lượng chạy song song, thử lại và giới hạn tốc độ được đặt theo quy trình và theo node.

Item và dữ liệu

• Node nhận một danh sách item và mặc định chạy một lần cho mỗi item.
• Node Dữ liệu sửa, lọc, sắp xếp, gộp, tổng hợp và định hình lại item; Bảng dữ liệu giữ dòng giữa các lượt chạy.
• Code (data.code) chạy JavaScript trong sandbox có giới hạn bộ nhớ và thời gian.
• Thông tin xác thực cho dịch vụ bên ngoài được lưu mã hóa và chọn theo tên; giá trị không bao giờ xuất hiện trong log.

Script trình duyệt

Node Browser script chạy JavaScript với cú pháp Playwright: page, locator, getByRole, click, fill, waitForResponse và hơn thế. Nó không chạy Playwright thật: mọi lời gọi đi tới trình điều khiển trình duyệt của MZBase, vốn:

• không bao giờ bật những tín hiệu trình duyệt mà trang web dùng để phát hiện tự động hóa;
• chạy mã hỗ trợ trong vùng cô lập, trang web không thấy;
• gõ phím và di chuột như người thật.

Cùng một script chạy trên mọi engine mà trình điều khiển hỗ trợ. Lời gọi ngoài phạm vi hỗ trợ sẽ báo lỗi rõ ràng, nêu tên lời gọi và lời gọi gần nhất được hỗ trợ; nó không bao giờ tự chuyển sang cách dễ bị phát hiện.

AI trong quy trình

Node AI trò chuyện, trích xuất, phân loại, viết và thao tác trên trang (ai.act), dùng mô hình của cổng AI (khóa của bạn, hoặc mô hình cục bộ trên GPU). Node tác tử AI có thể gọi các node khác như công cụ. Mọi thao tác đăng, gửi, mua hoặc xóa có thể đi qua bước duyệt.

Lượt chạy

Mỗi lượt chạy được lưu thành một execution với đầu vào, đầu ra, log và thời gian của từng node. Từ một execution, bạn có thể:

• chạy lại từ bất kỳ node nào với dữ liệu trước đó (chạy lại một phần);
• ghim đầu ra của một node trong khi dựng phần còn lại;
• xem vì sao node lỗi và thử lại.

Chạy từ bên ngoài

• Local API: POST /workflows/run với id quy trình và hồ sơ. Xem Local API.
• Terminal: mzb run "<quy trình>" --profile "<hồ sơ>" --wait.
• Tác tử AI và ứng dụng MCP thấy quy trình và node dưới dạng công cụ.

Tham chiếu

Danh mục node liệt kê mọi loại node kèm tham số và đầu ra. Nó được tạo từ registry node của ứng dụng.