Skip to main content

Các khối

Khối (block) là viên gạch nhỏ nhất để dựng nên một flow. Bạn kéo–thả các khối rồi nối chúng lại với nhau; khi flow được kích hoạt, các khối sẽ chạy lần lượt từ trên xuống dưới.

Trang này là bản đồ để chọn khối: trước tiên hiểu vài quy tắc chung, sau đó tìm đúng nhóm khối cho việc bạn cần làm.

Ba quy tắc cần nhớ​

  1. Thứ tự chạy — các khối chạy từ trên xuống. Khi nhiều khối cùng nối vào một khối cha, thứ tự giữa chúng có thể không cố định.
  2. Dùng lại kết quả — kết quả của khối chạy trước được lấy ở khối sau bằng biểu thức result('id'). Mỗi khối có một id; xem Biểu thức để biết cách tham chiếu.
  3. Lỗi sẽ dừng flow — nếu một khối gặp lỗi, các khối phía sau sẽ không chạy. Dùng Xử lý lỗi khi bạn muốn flow tiếp tục dù có lỗi.

Chọn khối theo nhu cầu​

Mỗi flow luôn bắt đầu bằng một khối đầu vào (điểm vào), sau đó bạn ghép thêm các khối hành động và khối điều khiển để tạo logic:

tip

Mỗi khối hành động tiêu tốn credit khi chạy. Hãy đặt các điều kiện hợp lý để chỉ chạy khi thật sự cần.

Khối đầu vào​

Bắt đầu một flow. Mỗi flow cần đúng một khối đầu vào để xác định điều gì kích hoạt nó.

  • Lệnh - Điểm bắt đầu cho slash command
  • Lắng nghe sự kiện - Điểm bắt đầu cho luồng kích hoạt bởi sự kiện
  • Nút bấm - Điểm bắt đầu cho tương tác nút bấm

Khối phản hồi​

Trả lời trực tiếp một lệnh hoặc tương tác. Đây thường là khối đầu tiên sau khối đầu vào để cho người dùng thấy phản hồi.

Khối tin nhắn​

Gửi, sửa, xóa tin nhắn trong kênh (khác với phản hồi: tin nhắn không gắn với một lệnh cụ thể).

Khối người dùng và thành viên​

Đọc thông tin và quản lý thành viên trong server: cấm, đuổi, timeout, gán role...

Khối server và kênh​

Đọc thông tin về server, kênh và role để dùng trong các bước sau.

Khối biến​

Lưu và lấy lại dữ liệu tồn tại giữa các lần chạy flow. Xem Biến lưu trữ để hiểu phạm vi (scope).

Khối AI​

Dùng trí tuệ nhân tạo để sinh văn bản hoặc tìm kiếm thông tin. Lưu ý các khối này tốn nhiều credit hơn.

Khối tiện ích​

Công cụ xử lý dữ liệu chung: tính biểu thức, gọi API, biến đổi văn bản/số, lấy thời gian.

Khối danh sách và JSON​

Làm việc với danh sách và dữ liệu JSON: chọn, nối, đếm, phân tích và tạo JSON.

Khối kinh tế​

Dựng hệ thống điểm / tiền tệ: số dư, chuyển tiền, bảng xếp hạng, cooldown cho lệnh kiểu /daily.

Khối điều khiển luồng​

Tạo logic cho flow: rẽ nhánh theo điều kiện, lặp lại, tạm dừng. Các khối này không tốn credit.

Tùy chọn lệnh​

Tinh chỉnh hành vi của một lệnh: khai báo đối số, đặt quyền, giới hạn bối cảnh sử dụng.

Tùy chọn sự kiện​

Lọc khi nào một bộ lắng nghe sự kiện được kích hoạt.