Incomex AI Portal
KB-45DF

Prefect Orchestration — SSOT

4 min read Revision 1
prefectorchestrationai-councilssot

Prefect Orchestration — SSOT

Version: 1.0
Date: 2026-02-27
Scope: AI Council Orchestration Layer
Status: Draft (Pending Constitutional Review)

I. MỤC ĐÍCH

Prefect được chuẩn hóa là Macro Orchestration Layer cho hệ AI Council.

Prefect chịu trách nhiệm:

  • Điều phối vòng đời workflow AI
  • Retry / Timeout / Failure recovery
  • Parallel execution
  • Conditional branching
  • Long-running process governance
  • Monitoring và logging cấp hệ thống

Prefect KHÔNG thay thế:

  • Agent Data (Shared Memory Layer)
  • Directus (Governance / Task UI)
  • MCP (Transport Layer)
  • Langroid A2A (Micro reasoning loop)

II. VỊ TRÍ TRONG KIẾN TRÚC

User / Directus
        ↓
Prefect (Orchestrator)
        ↓
AI Agents (Claude / Codex / Gemini)
        ↓
MCP HTTP
        ↓
Agent Data (Firestore + Qdrant)

Nguyên tắc bắt buộc:

  1. Prefect KHÔNG truy cập DB trực tiếp.
  2. Mọi thao tác với knowledge phải qua MCP HTTP.
  3. Không bypass Agent Data API.

III. PHÂN TẦNG LOGIC

1️⃣ Macro Orchestration (Prefect)

  • Workflow lifecycle management
  • Multi-phase AI execution
  • Conditional branching
  • Retry policies
  • Timeout enforcement
  • Long-running workflow durability

2️⃣ Durable Memory (Agent Data)

  • Shared memory
  • Reports
  • Decisions
  • Audit log
  • Vector synchronization (Qdrant integrity)

3️⃣ Micro Reasoning (Langroid A2A)

  • Planner vs Critic debate
  • Multi-round AI Council discussion
  • Voting logic
  • Output synthesis

A2A chỉ hoạt động trong phạm vi một workflow step. Không được dùng A2A làm backbone orchestration.

IV. HẠ TẦNG TRIỂN KHAI

Prefect phải chạy dưới dạng Docker trên VPS hiện tại.

Bắt buộc:

  • prefect-server (container)
  • prefect-worker (container)
  • PostgreSQL riêng cho Prefect (container)

Không được:

  • Dùng SQLite production
  • Dùng chung DB với Directus hoặc MySQL chính
  • Dùng Firestore làm metadata DB cho Prefect

V. STORAGE

Prefect Metadata

  • PostgreSQL riêng biệt
  • Không dùng MySQL chính
  • Không dùng Firestore

Flow Artifacts

Có thể dùng:

  • Google Cloud Storage (GCS)
  • Hoặc Docker volume

Phải tuân thủ Data Connection Law.

VI. NGUYÊN TẮC BẢO TOÀN HỆ THỐNG

  1. Vector integrity là bắt buộc.
  2. Không async hóa write gây orphan vector.
  3. Không cho phép infinite loop ngoài governance của Prefect.
  4. Không hardcode credentials.
  5. Mọi config phải dùng environment variables.

VII. VAI TRÒ TRONG AI COUNCIL

Prefect chịu trách nhiệm:

  • Khởi tạo AI Council Session
  • Theo dõi tiến trình
  • Ghi nhận trạng thái
  • Timeout nếu AI không phản hồi
  • Retry khi fail
  • Kết thúc workflow

Prefect KHÔNG:

  • Thực hiện reasoning thay AI
  • Lưu memory thay Agent Data
  • Truy cập trực tiếp database tầng dưới

VIII. PHÂN BIỆT VỚI KESTRA

Prefect = AI Orchestration Layer
Kestra = Human-in-the-loop & Business Workflow Layer

Không trộn hai vai trò.

IX. TUÂN THỦ LUẬT

  • Hiến Pháp Hạ Tầng v1.11e
  • Operating Rules v2.5
  • Checklist Layer 0 v1.1
  • Data Connection Law

Vi phạm bất kỳ luật nào → workflow không hợp lệ.

X. KẾT LUẬN

Prefect được chuẩn hóa là lớp điều phối AI cấp hệ thống.

Nó không thay thế Agent Data, không thay thế MCP, không thay thế A2A.

Prefect là lớp Macro Governance cho AI Council.