Đang tải tên DB...
Hướng dẫn sử dụng
Tổng quan

Chọn hoặc tạo quy trình ở cột trái. Kéo thả các bước (node) ra khung giữa, bấm vào một bước để sửa chi tiết ở cột phải. Nối cạnh bằng cách kéo từ chấm tròn bên phải một bước (ngõ ra) sang một bước khác (ngõ vào). Bấm vào đường nối để sửa điều kiện hoặc xóa. Mọi thay đổi tự lưu lên server sau khoảng 0,7 giây (xem chữ ở giữa thanh trên).

Bước Bắt đầu luôn có sẵn và không xóa được; đây là nơi quy trình bắt đầu chạy và cũng là nơi cấu hình tự động chạy (xem mục "Tự động chạy").

Các loại bước
BướcDùng để
▶ Bắt đầuĐiểm khởi đầu quy trình; cấu hình tự động chạy tại đây.
⑂ Điều kiệnRẽ nhánh theo giá trị (vd prev.muc_do) so với từng cạnh ra (=, ≠, >, <, chứa, còn lại).
⟳ LọcLọc một danh sách theo 0 hoặc nhiều điều kiện AND, trả về {items,first,count,total,checked,stopped}.
⚑ Bắt lỗiCạnh nối TỚI bước này chỉ chạy khi bước nguồn lỗi; dùng {{prev.error}} để đọc lỗi, quy trình không dừng lại.
◷ ChờDừng tối đa 60 giây (chỉ có tác dụng khi chạy tại trình duyệt).
⇄ Gọi APIGọi một API bất kỳ qua fetch (method/url/headers/body tự nhập).
✦ AI AgentGọi Claude/Gemini/ChatGPT, API tương thích OpenAI, hoặc Ollama chạy cục bộ (không cần key); có thể yêu cầu trả JSON theo trường.
▦ INKA DBBản nâng cấp của Gọi API: chọn sẵn một API của Inka (record/table/role/folder/cloud/database/run…) để tự điền URL/Headers.
✎ Trộn dữ liệuLàm sạch/ghép dữ liệu thành JSON hoặc văn bản mới cho bước sau, không gọi API, chạy ngay.
☁ Gọi quy trìnhGọi một quy trình khác, tại trình duyệt (dùng Secret đã tải) hoặc tại server qua POST /api/run.
■ Kết thúcĐánh dấu một nhánh đã xong, không cần cấu hình.
Token điền dữ liệu

Mọi trường văn bản (URL, headers, body, prompt…) đều hiểu các token dạng {{...}}, thay bằng giá trị tương ứng khi chạy:

{{input.x}}Trường x trong dữ liệu đầu vào của quy trình.
{{prev.x}}Trường x trong kết quả của (các) bước nối trực tiếp vào bước này.
{{steps.id.x}}Trường x trong kết quả của bước có mã id (xem mã bước ở panel phải).
{{secret.X}}Giá trị khóa X trong Secret.json (xem nút Secret).
{{client.user_id}}ID người gọi /api/run; chỉ có khi quy trình chạy tại server.
{{inka.db_id}}db_id của database đang chạy quy trình này (ở trình duyệt là db_id trên thanh trên; tại server là db_id trong URL /api/run/<db_id>).
{{inka.wf_id}}ID chính quy trình đang chạy, tức id trong /api/run/{{inka.db_id}}?id={{inka.wf_id}}.
Chạy quy trình

▶ Chạy (thanh trên): chạy ngay tại trình duyệt này, dùng Secret đã tải qua nút Secret. Bấm vào từng bước sau khi chạy để xem kết quả hoặc lỗi.

Gọi từ bên ngoài: quy trình khác (hoặc ứng dụng ngoài) gọi POST /api/run/<db_id>?id=<id quy trình> với body JSON là dữ liệu đầu vào; xem mẫu body ở panel "Input của quy trình" khi không chọn bước nào.

Tự động chạy: chọn bước Bắt đầu, mục "Tự động chạy" cho phép lặp lại sau mỗi N giây/phút/giờ/ngày/tháng, hoặc chạy đúng một lần vào một thời điểm cố định. Cả hai đều chỉ chạy tại trình duyệt này và chỉ khi tab trang này còn mở.

Secret.json & khóa API

Nút Secret mở danh sách khóa riêng của database (API key của Claude/Gemini/OpenAI, token gọi API khác…), dùng trong quy trình qua {{secret.TEN_KEY}}. Khóa được lưu trong một file quy trình ẩn của database, cần quyền đọc/ghi để xem hoặc sửa.

Database, Workflow, Cloud, Role, Quyền

Nút DB mở bảng quản trị: tạo/chọn database, đăng nhập hoặc tạo phiên Guest, quản lý file quy trình, thư mục Cloud, Bảng dữ liệu (table), Role và quyền truy cập (ACL) theo record/table/role.

Nhờ AI đề xuất quy trình

Nút ✦ Designing Workflows with AI mô tả yêu cầu bằng tiếng Việt, AI sẽ đề xuất toàn bộ các bước và cạnh nối; có thể dùng để tạo quy trình mới hoặc sửa một quy trình đã có.

Secret.json

Nhờ AI đề xuất quy trình


Database · đăng nhập · quyền
Database

db_id nhập ở thanh trên cùng; Guest/đăng nhập thành công sẽ tự điền.

Đăng nhập chưa đăng nhập
Auth URL

Router Server
Cloud
Workflow
Bảng
Nhánh
Role
Record
limit sibling auth_child
Quyền id role_id / user_id

Ảnh storage database

Tệp gồm các block 64 KiB; cần token đang sở hữu database. Nạp sẽ thay nội dung nhưng giữ db_id/owner.

API nhật ký (feed / errors / activities) record_id
Nhật ký