Tạo workflow web bằng AI Web Builder

Điều kiện cần

• Workspace đang ở Chế độ Trình duyệt (Chrome CDP). Ở Chế độ Desktop sẽ bị từ chối.
• Không có macro nào đang chạy và không đang ghi macro.
• Đã cấu hình một provider AI trong tab AI / API kèm API key — trừ khi dùng chế độ Quick Create và tắt quan sát trực tiếp.
• Chỉ cần Chrome/CDP khi bật quan sát trực tiếp hoặc khi bấm chạy thử; viết workflow thường thì không cần.
• Vì phải vào được Chế độ Trình duyệt, tính năng này cần license trả phí.

Chế độ hỗ trợ

• Chế độ Browser — Chỉ chạy ở Chế độ Trình duyệt, và mọi workflow sinh ra đều được ghim ở chế độ browser. Trong đó có hai cách viết: Viết workflow không mở Chrome (mặc định) và Quan sát trực tiếp bằng Chrome/CDP.

Chức năng này làm gì

AI Web Builder nhận mô tả bằng lời của bạn (có thể tách thành nhiều bước), hỏi model AI để sinh ra một workflow, kiểm tra workflow đó theo danh sách lệnh được phép, rồi chuyển thành lệnh RunMacro thật và chèn vào macro dưới dạng một nhóm WF Group. AI có thể viết thẳng từ mô tả của bạn, hoặc mở Chrome quan sát trực tiếp — tự click, gõ, scroll để xem trang thật rồi mới viết.

Khi nào nên dùng

• Muốn có bản nháp workflow nhanh cho một việc web quen thuộc.
• Chưa biết dựng luồng thế nào và cần một điểm khởi đầu để sửa.
• Việc cần làm mô tả bằng lời thì rõ, nhưng gõ tay từng lệnh sẽ lâu.
• Muốn AI xem trang thật trước khi viết (bật quan sát trực tiếp).

Khi nào không nên dùng

• Tự động hóa phần mềm desktop — AI Web Builder chỉ hỗ trợ Chế độ Trình duyệt.
• Cần workflow chính xác tuyệt đối ngay lần đầu: hãy luôn xem trước và chạy thử, hoặc dùng Smart Record để lấy selector thật.
• Việc cần lệnh ngoài danh sách được phép (nhận diện hình ảnh, chạy shell, thao tác desktop).

Các bước cấu hình

1. Đảm bảo đang ở Chế độ Trình duyệt. Mở menu Thêm › Tạo Workflow bằng AI.
2. Chọn thẻ Tạo workflow hoàn toàn bằng AI (thẻ còn lại dùng template có sẵn, rẻ và chính xác hơn).
3. Ở thẻ 1. Mục tiêu, mô tả việc cần làm. Bấm Thêm bước nếu muốn tách thành nhiều bước rõ ràng (tối đa 21 bước).
4. Ở thẻ 2. Cách AI thao tác, chọn viết không mở Chrome (mặc định) hoặc quan sát trực tiếp. Chọn quan sát trực tiếp sẽ hiện thêm nhóm cấu hình Chrome.
5. Ở thẻ AI settings, chọn Builder mode: Quick Create, Plan & Build (mặc định) hoặc Smart Builder. Chọn Provider.
6. Bấm Bắt đầu tạo workflow.
7. Với Plan & Build và Smart Builder, hộp AI Workflow Plan mở ra: xem các block, biến, vòng lặp và rủi ro. Bạn sửa được tên và mục tiêu từng block, hoặc sửa trực tiếp JSON của plan.
8. Bấm Generate Full Workflow, hoặc Generate Selected Block để sinh từng phần.
9. Ở hộp xem trước, kiểm tra tab Danh sách lệnh và JSON. Bấm Chạy thử nếu đã có Chrome/CDP.
10. Bấm Thêm vào macro hiện tại để chèn, hoặc Tạo macro mới từ workflow này để thay cả macro.

Giải thích từng tùy chọn

Kết quả mong đợi

Một nhóm lệnh WF Group được thêm vào macro, gồm các lệnh Smart HTML/CDP tương ứng với mô tả của bạn. Nếu AI trả về JSON không hợp lệ, hộp thoại lỗi mở ra và bạn có thể bấm Nhờ AI sửa JSON.

Ví dụ thực tế

Giới hạn và trường hợp lỗi

• AI chỉ sinh được các lệnh trong danh sách cho phép: điều hướng và tab, thao tác phần tử web, chờ và kiểm chứng, điều khiển luồng cơ bản (delay, label, goto, if biến, retry), biến, và ghi ra file CSV/text. Không có nhận diện hình ảnh, thao tác desktop, chạy shell, hay nhắm vào iframe khác tên miền.
• Provider RunMacro AI hiện chỉ dùng được ở chế độ Quick Create khi tắt quan sát trực tiếp. Ở Plan & Build (mặc định) hoặc khi bật quan sát trực tiếp, app báo thiếu API key dù RunMacro AI không cần key. Cách xử lý: chọn Quick Create, hoặc chọn provider khác đã có API key.
• Chế độ viết không mở Chrome đoán selector, nên workflow có thể cần sửa khi chạy — chính giao diện cũng ghi rõ điều này.
• Không có nút hủy khi AI đang chạy: bấm Hủy chỉ đóng hộp thoại, tiến trình gọi AI vẫn tiếp tục ở nền.
• Có báo cáo về việc bấm Thêm vào macro hiện tại một lần nhưng chèn hai nhóm gần giống nhau. Sau khi thêm, hãy kiểm tra danh sách lệnh; nếu thấy trùng thì xóa nhóm dư.
• Có báo cáo app đóng đột ngột khi tắt hộp xem trước sau khi đã thêm. Hộp xem trước hiện tự đóng sau khi thêm thành công để tránh trường hợp này.
• Một số nhãn trong hộp plan và hộp xem trước còn để tiếng Anh khi giao diện đang ở tiếng Việt.
• Bước AI không hỗ trợ mà lọt qua kiểm tra sẽ bị bỏ qua âm thầm lúc chuyển thành lệnh — số lệnh ít hơn plan là dấu hiệu của việc này.

Mẹo & lỗi thường gặp

Thông tin kiểm chứng

• ui/ai_web_builder_dialog.py
• core/ai_web_builder.py
• core/ai_workflow_capabilities.py

Lệnh liên quan