Architecture • Runtime • Orchestration

Kiến trúc tổng thể của IAI Flow

IAI Flow được thiết kế như một AI workflow & automation orchestration platform thống nhất. Hệ thống này kết hợp visual builder, execution runtime, queue, scheduler, logs, metrics, node ecosystem và agent orchestration trong cùng một nền tảng.

Kiến trúc nhiều lớp

IAI Flow không được xây như một website đơn giản. Nó là một hệ điều phối nhiều lớp, trong đó UI, runtime, queue và orchestration engine phải hoạt động thống nhất.

1. Application Layer

Phần người dùng nhìn thấy và thao tác trực tiếp. Bao gồm dashboard, workflow builder, runtime monitor, logs viewer, module explorer và agent interface.

2. Execution Layer

Phần chịu trách nhiệm thực thi workflow, chạy node, quản lý retry, branch, parallel path và output của từng run.

3. Coordination Layer

Phần điều phối nhiều execution cùng lúc bằng queue, scheduler và Durable Objects để workflow có thể chạy phân tán và ổn định.

4. Data Layer

Lưu workflow definitions, run history, logs, metrics, schedules, execution states và các artifacts cần thiết để platform hoạt động lâu dài.

5. AI Layer

Cho phép workflow gọi AI nodes, agent tools, memory systems và các lớp intelligence để chuyển từ automation sang AI-native execution.

6. Platform Layer

Là nơi chứa auth, projects, permissions, API keys, secrets, audit trail và các chuẩn production cho toàn bộ hệ sinh thái.

Luồng thực thi chuẩn

Một workflow trong IAI Flow phải đi qua một execution pipeline rõ ràng thay vì chạy mơ hồ trong browser.

Definition Workflow được thiết kế, lưu và version hóa.
Validation Node graph, config, contract và input được kiểm tra.
Queue Execution được enqueue để đảm bảo orchestration chuẩn.
Runtime Engine claim job, tạo run state và bắt đầu thực thi từng node.
Observability Logs, metrics, status, output và traces được ghi lại.

Trạng thái một workflow run

State machine rõ ràng là điều bắt buộc để platform có thể đi lên production.

draft Workflow hoặc run mới được tạo nhưng chưa enqueue.
queued Đã vào queue và chờ claim bởi execution runtime.
claimed Một worker hoặc coordinator đã claim execution.
running Workflow đang chạy node theo execution graph.
waiting / retrying Workflow đang chờ delay, retry, approval hoặc wake-up signal.
completed / failed / cancelled Run kết thúc với output, lỗi hoặc bị dừng chủ động.

Cloudflare stack

IAI Flow được định hướng chạy trên một stack đơn giản nhưng đủ mạnh để mở rộng production: Workers, Durable Objects, D1, KV và R2.

flow.iai.one ↳ Frontend application and builder UI iai-flow-engine ↳ Execution engine and runtime services Cloudflare Workers ↳ API layer and orchestration routes Durable Objects ↳ Run coordinator, scheduler coordinator, execution state D1 ↳ Workflow definitions, runs, logs, metrics, schedules KV ↳ Fast cache, lightweight state, lookups R2 ↳ Large payloads, artifacts, exports, attachments

Tầm nhìn kiến trúc dài hạn

IAI Flow được xây để đi từ visual builder ban đầu lên một AI Workflow Operating System. Trục phát triển dài hạn gồm workflow runtime production, distributed queue, scheduler, AI agent nodes, memory systems và operations UI thống nhất.