Workflow - Chạy thử nghiệm nút và lớp phủ tiến trình chạy

Kiểm thử độc lập từng nút trên Canvas, theo dõi đèn trạng thái thời gian thực và xử lý sự cố lỗi phát sinh.

## Mở không gian Khung vẽ Canvas và chuẩn bị kiểm thử

Trong quá trình xây dựng kịch bản tự động hóa trên nền tảng RedAI, việc chạy thử nghiệm độc lập từng bước xử lý ngay trên Khung vẽ Canvas đóng vai trò vô cùng quan trọng. Tính năng này giúp người dùng kiểm chứng tính chính xác của dữ liệu đầu ra, phát hiện sớm các sai sót cấu hình và cô lập lỗi sự cố mà không cần phải kích hoạt chạy lại toàn bộ quy trình từ đầu.

Bước Cách thực hiện
1 Truy cập kịch bản cần kiểm thử: Mở trình duyệt web và điều hướng tới kịch bản đang thiết lập theo đường dẫn chuẩn https://app.redai.vn/workflows/:id.
2 Xác định bước xử lý và kiểm tra tính sẵn sàng: Quan sát sơ đồ quy trình trên mặt phẳng Khung vẽ Canvas. Định vị thẻ bước xử lý cần chạy thử nghiệm và kiểm tra bảo đảm bước này đã được điền đủ thông tin thiết lập (không xuất hiện biểu tượng cảnh báo hình tam giác màu vàng).

📸 [Vị trí chèn ảnh chụp màn hình: Khung vẽ Canvas hiển thị thẻ bước xử lý với nút Thực thi hình tam giác góc trên phải và dải băng tiến trình nổi sẵn sàng ở mép trên màn hình]

Các bước thực hiện

Chọn phương án kiểm thử

Tùy theo giai đoạn hoàn thiện kịch bản và khối lượng công việc cần đánh giá, người dùng có thể linh hoạt lựa chọn 1 trong 3 phương án kiểm thử sau:

Phương án Tình huống sử dụng Phạm vi và Cơ chế vận hành
1. Chạy thử nghiệm đơn lẻ từng bước Vừa cấu hình xong một bước xử lý mới (ví dụ: truy vấn dữ liệu bảng, tính toán biểu thức hoặc định dạng nội dung thư điện tử). Hệ thống chỉ kích hoạt duy nhất bước được chỉ định; cho phép nạp dữ liệu mẫu giả lập hoặc kế thừa kết quả từ lần chạy trước mà không ảnh hưởng tới các bước khác.
2. Chạy thử nghiệm toàn bộ quy trình Toàn bộ sơ đồ đã được nối dây hoàn chỉnh và cần kiểm tra dòng chảy dữ liệu xuyên suốt từ đầu đến cuối. Hệ thống kích hoạt từ bước khởi nguồn, dữ liệu tự động luân chuyển tuần tự qua từng bước theo đúng logic dây nối và điều kiện rẽ nhánh.
3. Chạy thử nghiệm qua Trợ lý ảo AI Agent Cần kiểm tra nhanh các trường hợp ngoại lệ hoặc muốn giao phó việc giả lập dữ liệu đầu vào phức tạp. Trợ lý ảo AI Agent tự động gọi công cụ máy chủ để chạy ngầm, giám sát tiến trình và tóm tắt kết quả phân tích bằng ngôn ngữ tự nhiên.

Giai đoạn 1 — Kích hoạt và chuẩn bị dữ liệu chạy thử nghiệm từng bước

Tính năng chạy thử nghiệm đơn lẻ cho phép bạn chủ động cung cấp dữ liệu đầu vào cho bước xử lý để quan sát chính xác kết quả trả về.

Bước Cách thực hiện
1 Bấm nút Thực thi trên thẻ bước xử lý:
• Rê chuột vào thẻ bước xử lý cần kiểm thử trên Khung vẽ Canvas.
• Nhấp chuột vào nút hình tam giác Thực thi ở góc trên bên phải của thẻ bước (nằm ngay trước nút menu ba chấm).
• Lưu ý: Nếu nút này hiển thị biểu tượng hình tam giác màu vàng cảnh báo, bạn cần nhấp đúp vào thẻ bước để mở Cửa sổ cấu hình và điền đầy đủ các trường dữ liệu bắt buộc trước khi chạy thử.
2 Rà soát dữ liệu tại Cửa sổ Chuẩn bị chạy thử:
Hệ thống tự động mở cửa sổ Chạy bước này (NodeExecutionPreparationModal) gồm 2 phân khu thông tin:
• Khung Thiết lập hiện tại: Hiển thị khối mã tham số đã cấu hình của bước xử lý thông qua trình xem mã trực quan.
• Khung Thông tin cần điền: Liệt kê toàn bộ các biến đầu vào mà bước này đang sử dụng. Hệ thống tự động nhận diện nếu dữ liệu đã được điền sẵn từ kết quả của bước phía trước (hiển thị dòng chữ thông báo màu xanh lá: “Đã điền sẵn từ [Tên bước] / [Cổng]”).
• Nhập dữ liệu giả lập tùy biến: Đối với các trường biến chưa có dữ liệu hoặc bạn muốn kiểm tra trường hợp đặc biệt, hãy nhập trực tiếp giá trị mong muốn vào ô tương ứng (hỗ trợ đầy đủ định dạng chữ, số, công tắc đúng/sai hoặc khối dữ liệu có cấu trúc).
3 Kích hoạt chạy thử nghiệm ngay:
• Nhấp vào nút biểu tượng dấu tích Chạy ngay ở góc dưới bên phải cửa sổ chuẩn bị.
• Nút chuyển sang trạng thái chờ với dòng chữ “Đang chuẩn bị…” và hệ thống sẽ gửi lệnh thực thi bất đồng bộ lên máy chủ.

📸 [Vị trí chèn ảnh chụp màn hình: Cửa sổ Chuẩn bị dữ liệu chạy thử nghiệm mở ra hiển thị các trường biến đầu vào kèm thẻ viên nhộng màu sắc và nút Chạy ngay ở chân trang]

Giai đoạn 2 — Theo dõi lớp phủ tiến trình và đèn trạng thái trên Canvas

Trong khi bước xử lý hoặc toàn bộ kịch bản đang chạy, nền tảng RedAI cung cấp hệ thống tín hiệu thị giác thời gian thực giúp bạn nắm bắt tiến độ ngay trên không gian làm việc.

Khu vực chỉ báo Vị trí hiển thị Ý nghĩa và Cách tương tác
Dải băng tiến trình nổi Nằm chính giữa mép trên cùng của Khung vẽ Canvas • Huy hiệu trạng thái: Đổi màu sinh động theo tiến độ: Đang thực thi (vòng tròn xoay liên tục), Hoàn thành (dấu tích màu xanh lá) hoặc Thất bại (dấu nhân màu đỏ).
• Thanh tiến trình phần trăm: Dải màu xanh chuyển động từ 0% đến 100%, hiển thị tỷ lệ số bước đã chạy trên tổng số bước và số bước phát sinh sự cố nếu có.
• Nút Hủy khẩn cấp: Nút tròn màu đỏ có dấu nhân giúp ngắt ngay lập tức tiến trình khi phát hiện quy trình chạy quá lâu.
• Nút Mở khóa: Xuất hiện khi tiến trình bị gián đoạn, giúp giải phóng mặt phẳng Canvas để bạn tiếp tục thao tác chỉnh sửa.
Ngăn trượt Tiến trình bên phải Trượt ra từ mép phải màn hình khi tiến trình bắt đầu • Hiển thị danh sách tuần tự tất cả các bước trong kịch bản kèm đèn trạng thái nhấp nháy.
• Khung danh sách tự động cuộn êm ái tới bước đang được xử lý.
• Nhấp chuột vào tên bất kỳ bước nào trong danh sách để Canvas tự động di chuyển và phóng to tới vị trí bước đó.
Chấm tròn trạng thái góc thẻ bước Góc trên bên phải của thẻ bước (trước nút Thực thi) Hệ thống 4 màu sắc và hiệu ứng trực quan:
• Xanh dương nhấp nháy xoay tròn: Bước đang trong quá trình thực thi trên máy chủ.
• Xanh lá cây rực rỡ kèm dấu tích: Bước đã chạy thành công trọn vẹn. Nhấp chuột vào chấm tròn này để mở ngay Cửa sổ kết quả.
• Đỏ rực kèm dấu nhân: Bước gặp sự cố lỗi hoặc bị gián đoạn. Nhấp chuột vào để mở bảng phân tích chi tiết nguyên nhân lỗi.
• Xám than chì kèm dấu tạm dừng: Bước đang ở trạng thái chờ hoặc bị tạm dừng do điều kiện chưa thỏa mãn.

📸 [Vị trí chèn ảnh chụp màn hình: Khung vẽ Canvas với dải băng tiến trình nổi ở trên cùng và thẻ bước xử lý phát sáng chấm tròn trạng thái màu xanh lá kèm nút tích thành công]

Giai đoạn 3 — Khám phá dữ liệu kết quả và xử lý sự cố lỗi phát sinh

Sau khi bước xử lý hoàn thành lượt chạy thử nghiệm, bạn cần kiểm tra dữ liệu kết quả thực tế để thẩm định chất lượng dữ liệu.

Bước Cách thực hiện
1 Mở Cửa sổ Kết quả thực thi chi tiết:
• Nhấp chuột trực tiếp vào chấm tròn màu xanh lá hoặc màu đỏ ở góc thẻ bước trên Canvas.
• Hoặc nếu đang mở Cửa sổ cấu hình thuộc tính của bước đó, nhấp vào nút Xem kết quả gần nhất ở thanh thao tác chân trang.
2 Kiểm tra dữ liệu tại Thẻ tab “Kết quả”:
• Cửa sổ mở ra hiển thị các thẻ tab con tương ứng với từng Cổng kết nối dữ liệu của bước xử lý (main, true, false, error…).
• Dữ liệu trả về được trình bày qua trình xem dữ liệu có cấu trúc với định dạng cây phân cấp trực quan.
• Bạn có thể nhấp vào các mũi tên để mở rộng hoặc thu gọn từng nhánh thông tin, kiểm tra các trường khóa và giá trị dữ liệu cụ thể.
• Hệ thống tích hợp cơ chế bảo vệ hiển thị an toàn tối đa 10.000 ký tự giúp trình duyệt luôn hoạt động mượt mà ngay cả khi dữ liệu trả về có quy mô lớn.
3 Phân tích và gỡ rối tại Thẻ tab “Lỗi” (Khi bước chạy thất bại):
• Nếu bước xử lý gặp sự cố, thẻ tab Lỗi sẽ tự động được chọn với dải băng cảnh báo màu đỏ tóm tắt lý do thất bại.
• Bên dưới là khung Chi tiết lỗi hiển thị toàn bộ nội dung dấu vết lỗi kỹ thuật từ máy chủ.
• Nhấp vào nút Sao chép chi tiết một chạm ở góc khung lỗi để lưu nội dung vào bộ nhớ tạm, sẵn sàng gửi cho bộ phận kỹ thuật hoặc nhờ Trợ lý ảo AI Agent phân tích nguyên nhân.
• Đóng cửa sổ kết quả, nhấp đúp vào thẻ bước để mở Cửa sổ cấu hình điều chỉnh tham số, sau đó bấm nút Thực thi để chạy thử lại tức thì.

📸 [Vị trí chèn ảnh chụp màn hình: Cửa sổ Kết quả thực thi chi tiết hiển thị dữ liệu đầu ra dạng cây JSON với các tab phân tách theo cổng dữ liệu và nút sao chép chi tiết lỗi]

Kiểm tra kết quả

Sau khi hoàn tất quy trình chạy thử nghiệm một bước xử lý, bạn có thể dễ dàng xác nhận kết quả thành công thông qua 3 dấu hiệu trực quan sau:

Dấu hiệu kiểm tra Trạng thái hiển thị đạt chuẩn Ý nghĩa nghiệp vụ
1. Đèn trạng thái thẻ bước Chấm tròn góc thẻ chuyển sang màu xanh lá cây rực rỡ với biểu tượng dấu tích rõ nét. Bước xử lý đã hoàn thành trọn vẹn, không phát sinh bất kỳ lỗi tham số hay lỗi kết nối dịch vụ ngoài nào.
2. Dải băng tiến trình Canvas Dải băng hiển thị trạng thái Hoàn thành với thanh tiến trình đạt 100% màu xanh lá. Toàn bộ chu trình chuẩn bị, truyền tải và xử lý dữ liệu đã kết thúc an toàn trên hệ thống máy chủ.
3. Cửa sổ kết quả dữ liệu Dữ liệu đầu ra tại cổng tương ứng hiển thị đầy đủ các trường thông tin mong muốn dưới dạng cây cấu trúc rõ ràng. Dữ liệu đã sẵn sàng để làm biến đầu vào cho các bước kế tiếp thông qua hệ thống dây nối luồng dữ liệu.

Hướng dẫn thao tác qua Trợ lý ảo AI Agent

Mọi thao tác chạy thử nghiệm từng bước, kiểm tra tiến trình thực thi, đọc nhật ký kết quả và phân tích nguyên nhân lỗi đều có thể được tự động hóa hoàn toàn thông qua việc tương tác trực tiếp với Trợ lý ảo AI Agent.

1. Thông tin kết nối Kỹ năng chuyên môn của Trợ lý ảo AI Agent

Thông số cấu hình Giá trị thiết lập trên nền tảng RedAI
Tên Kỹ năng chuyên môn RedAI - Module - AI Workflow
Mã định danh Kỹ năng f25229db-9fad-4567-a65e-88af1e31f6a7
Tên Bộ công cụ RedAI - Module - AI Workflow
Mã định danh Bộ công cụ 7c6818a0-dd73-4503-99c9-0e0d83fc9b73
Quy mô công cụ sẵn sàng 71 công cụ nghiệp vụ chính thức sẵn sàng trên hệ thống máy chủ

2. Bảng đối chiếu 5 công cụ AI Agent chuyên sâu về Kiểm thử và Thực thi

Thao tác trên Giao diện Canvas Công cụ Trợ lý ảo AI Agent sử dụng Nhiệm vụ nghiệp vụ của công cụ
Chạy thử nghiệm một bước workflow_node_test_run Kích hoạt chạy thử nghiệm độc lập một bước xử lý cụ thể với dữ liệu đầu vào tùy biến theo cơ chế hàng đợi bất đồng bộ.
Kiểm tra tiến độ thực thi workflow_execution_get_status Tra cứu nhanh trạng thái chạy hiện tại (đang xử lý, hoàn thành, thất bại) siêu tinh gọn, tiết kiệm hơn 95% tài nguyên xử lý cho AI Agent.
Đọc kết quả và nhật ký lỗi workflow_execution_get_detail Truy xuất toàn bộ chi tiết kết quả đầu ra của từng cổng dữ liệu, thông số thời gian chạy và nhật ký lỗi thô để phân tích chuyên sâu.
Chạy toàn bộ quy trình workflow_execution_run Khởi động và điều phối chạy toàn bộ kịch bản từ bước khởi đầu hoặc từ một vị trí bước được chỉ định.
Hủy phiên chạy khẩn cấp workflow_execution_cancel Gửi tín hiệu hủy tức thì một phiên chạy đang xử lý khi phát hiện bước bị treo hoặc chạy quá thời gian cho phép.

3. Các câu lệnh mẫu giao tiếp với Trợ lý ảo AI Agent

Dưới đây là 5 câu lệnh mẫu chuẩn hóa theo cấu trúc 4 phần giúp bạn dễ dàng ra lệnh cho Trợ lý ảo AI Agent điều hành việc kiểm thử kịch bản:

Câu lệnh 1: Chạy thử nghiệm một bước xử lý với dữ liệu giả lập

“Tôi vừa cấu hình xong bước xử lý thông tin khách hàng trong kịch bản.
Hãy sử dụng công cụ workflow_node_test_run để chạy thử nghiệm bước [Chuẩn hóa số điện thoại].
Truyền dữ liệu đầu vào giả lập là số điện thoại [0912345678] và kiểm tra xem bước này có trả về định dạng chuẩn hay không.”

Câu lệnh 2: Theo dõi trạng thái tiến trình phiên chạy thử

“Tôi vừa bấm lệnh chạy thử nghiệm cho kịch bản tự động hóa đơn hàng.
Hãy gọi công cụ workflow_execution_get_status với mã phiên chạy [exec_789456] để kiểm tra xem tiến trình đã hoàn thành chưa.
Hãy báo cáo cho tôi biết số lượng bước đã chạy thành công và bước nào đang được xử lý.”

Câu lệnh 3: Đọc và giải thích kết quả dữ liệu đầu ra của một bước

“Bước truy vấn bảng tính vừa chạy xong lượt thử nghiệm.
Hãy dùng công cụ workflow_execution_get_detail để đọc dữ liệu đầu ra của bước [Lấy danh sách khách hàng VIP].
Hãy tóm tắt cho tôi xem có bao nhiêu bản ghi được tìm thấy và các trường thông tin chính gồm những gì.”

Câu lệnh 4: Phân tích nguyên nhân lỗi và hướng dẫn cách khắc phục

“Bước gửi thư điện tử trong kịch bản của tôi vừa báo chấm đỏ thất bại.
Hãy sử dụng công cụ workflow_execution_get_detail để trích xuất nội dung lỗi kỹ thuật của bước [Gửi email xác nhận].
Hãy phân tích nguyên nhân vì sao bước này thất bại và hướng dẫn tôi cách sửa lại cấu hình để bước có thể chạy thành công.”

Câu lệnh 5: Hủy khẩn cấp một phiên chạy đang bị treo

“Tiến trình chạy thử nghiệm của kịch bản đang quay vòng liên tục hơn 2 phút mà chưa có kết quả.
Hãy lập tức gọi công cụ workflow_execution_cancel đối với phiên chạy [exec_123789] để ngắt tiến trình an toàn.
Sau khi hủy xong, hãy kiểm tra lại trạng thái để xác nhận sơ đồ đã được mở khóa.”

4. Bảng kiểm tra xác nhận kết quả hai chiều

Hành động yêu cầu Dấu hiệu nhận biết trên Giao diện Canvas Dấu hiệu nhận biết trong câu trả lời của AI Agent
Chạy thử một bước Chấm tròn trên thẻ bước chuyển sang màu xanh dương nhấp nháy, sau đó đổi thành màu xanh lá cây hoặc màu đỏ. Trợ lý ảo AI Agent phản hồi mã phiên chạy thử nghiệm, thời gian bắt đầu và kết quả xử lý chi tiết của bước đó.
Kiểm tra tiến độ Dải băng tiến trình nổi ở trên cùng cập nhật tỷ lệ phần trăm tương ứng với số bước hoàn thành. Trợ lý ảo AI Agent thông báo rõ trạng thái hiện tại (đang xử lý hoặc đã xong) kèm số lượng bước thành công/thất bại.
Phân tích sự cố lỗi Chấm tròn thẻ bước đổi màu đỏ rực; mở cửa sổ kết quả thấy thẻ tab Lỗi có dải băng cảnh báo màu đỏ. Trợ lý ảo AI Agent chỉ rõ dòng lỗi cụ thể, giải thích nguyên nhân bằng ngôn ngữ nghiệp vụ dễ hiểu và đề xuất phương án khắc phục ngay.

📸 [Vị trí chèn ảnh chụp màn hình: Khung trò chuyện tương tác với Trợ lý ảo AI Agent thể hiện lệnh yêu cầu chạy thử nghiệm đơn lẻ bước xử lý và phản hồi chi tiết kết quả chạy của AI Agent]

Bảng câu hỏi thường gặp khi chạy thử nghiệm quy trình

Câu hỏi thường gặp Giải đáp hướng dẫn chi tiết
1. Khi chạy thử nghiệm một bước gửi thư hoặc tin nhắn, hệ thống có gửi dữ liệu thật ra ngoài không? Có. Khi bạn nhấn Chạy thử nghiệm một bước kết nối với dịch vụ bên ngoài (như gửi thư điện tử, tin nhắn Zalo hoặc thông báo Telegram), hệ thống trên nền tảng RedAI sẽ gửi gói tin thật tới cổng dịch vụ của nhà cung cấp đó. Do đó, khi kiểm thử, bạn nên điền thông tin người nhận là hòm thư hoặc số điện thoại thử nghiệm nội bộ của mình để tránh gửi nhầm thông tin tới khách hàng thật.
2. Khi chạy thử nghiệm đơn lẻ một bước ở giữa quy trình, dữ liệu của các bước phía trước được lấy từ đâu? Hệ thống tự động ưu tiên lấy dữ liệu từ kết quả của lần chạy gần nhất của các bước phía trước đó. Nếu kịch bản chưa từng chạy lần nào hoặc bạn muốn thử nghiệm một tình huống mới, cửa sổ Chuẩn bị chạy thử sẽ hiển thị danh sách các biến để bạn tự tay nhập dữ liệu giả lập theo ý muốn.
3. Nút Mở khóa trên dải băng tiến trình có tác dụng gì và khi nào tôi nên bấm? Khi một phiên chạy đang diễn ra, Khung vẽ Canvas sẽ tạm thời chuyển sang trạng thái chỉ xem để bảo đảm tính toàn vẹn dữ liệu. Nếu phiên chạy kết thúc bất thường do mất kết nối mạng hoặc máy chủ phản hồi chậm khiến sơ đồ vẫn bị khóa, nút Mở khóa sẽ xuất hiện trên dải băng tiến trình. Nhấp vào nút này sẽ lập tức giải phóng giao diện để bạn có thể tiếp tục kéo thả, chỉnh sửa bình thường.
4. Làm thế nào để dừng khẩn cấp một bước đang chạy vòng lặp hoặc xử lý quá lâu? Bạn có thể ngắt tiến trình bằng 2 cách nhanh chóng: Nhấp vào biểu tượng nút tạm dừng hình tròn màu đỏ ngay trên đầu thẻ bước đang chạy, hoặc nhấp vào nút biểu tượng hình tròn có dấu nhân trên dải băng tiến trình nổi ở mép trên Canvas. Hệ thống sẽ lập tức gửi lệnh hủy tới máy chủ và hoàn trả quyền điều khiển cho bạn.

Các bước tiếp theo và Chuyên đề liên quan

Sau khi đã thuần thục kỹ năng chạy thử nghiệm từng bước và kiểm soát hoàn toàn tiến trình chạy trên Khung vẽ Canvas, người dùng có thể tiếp tục tìm hiểu các công cụ theo dõi lịch sử chuyên sâu và đóng gói phát hành quy trình trên nền tảng RedAI:

Chuyên đề tiếp theo Mục tiêu làm chủ kỹ năng Đường dẫn tài liệu
08. Ngăn trượt Lịch sử Phiên chạy và Đo lường Hiệu năng Hướng dẫn tra cứu toàn bộ nhật ký các phiên chạy trong quá khứ, phân tích dữ liệu vào/ra chi tiết của từng bước, xác định bước gặp sự cố và theo dõi biểu đồ thời gian thực thi của quy trình. [Xem tài liệu 08](08. Ngăn trượt lịch sử phiên chạy và đo lường hiệu năng.md)
09. Ngăn Quản lý Phiên bản và Cài đặt Lịch chạy Nền Làm chủ kỹ thuật đóng gói bản chụp phiên bản cố định của kịch bản, kích hoạt phiên bản vận hành chính thức, khôi phục bản nháp từ lịch sử và cài đặt lịch tự động chạy ngầm định kỳ trên máy chủ. [Xem tài liệu 09](09. Ngăn quản lý phiên bản và cài đặt lịch chạy nền.md)
06. Cửa sổ trượt Cấu hình Thuộc tính Nút và Biểu thức Động Quay lại tinh chỉnh các tham số đầu vào, điều chỉnh biểu thức logic hoặc cấu hình số lần thử lại an toàn nếu dữ liệu chạy thử nghiệm chưa đạt yêu cầu nghiệp vụ mong muốn. [Xem tài liệu 06](06. Cửa sổ trượt cấu hình thuộc tính nút.md)