haih-agent

haih-agent trước hết là một CMS/web engine độc lập, hiện đại, và các tính năng AI-agent được xây dựng dựa trên nền tảng đó. Định vị hiện tại là "AI-agent + CMS" là chưa chính xác; định vị mục tiêu là CMS + AI agent.

Kho lưu trữ: https://github.com/haih-net/agent/

Dự án phát triển từ một tập hợp các script cho ý tưởng haih.net, và sau đó chuyển thành một dự án độc lập dựa trên prisma-cms/nextjs-nexus.

Một nền tảng web hoàn chỉnh, không chỉ là bộ công cụ gói gọn AI

Khác với các hệ thống headless/API-first, nơi CMS thường chỉ thu gọn thành một frontend bên ngoài trên một backend tùy ý, haih-agent bao gồm mô hình dữ liệu riêng, PostgreSQL, Prisma ORM và migration, GraphQL API, phân quyền, định tuyến, xuất bản, Concepts, hạ tầng tệp và môi trường Docker. Đây là một nền tảng full-stack độc lập, trên đó lớp AI được phủ lên.

Nhân kỹ thuật của dự án bao gồm frontend Next.js/React, backend Express + Apollo/Pothos GraphQL, PostgreSQL + Prisma, hạ tầng Docker và AgentOrchestrator riêng chạy trên OpenAI-compatible API.

AI như một thực thể độc lập trong hệ thống

Một trong những ý tưởng cốt lõi của wiki là agent không được coi là một đoạn chat phi trạng thái (stateless) hay một proxy của người dùng, mà là một thực thể độc lập của hệ thống.

Agent có thể có:

• danh tính và hồ sơ riêng;
• thông tin đăng nhập (credentials) và quyền hạn (permissions) riêng;
• bộ nhớ và tri thức bền vững (persistent memory and knowledge);
• khả năng tự khám phá GraphQL API thông qua introspection;
• các công cụ làm việc với cơ sở dữ liệu, web, tệp, email và shell;
• khả năng tự cập nhật trạng thái của chính mình và tích lũy kinh nghiệm.

Đây là một phần quan trọng của haih-agent, nhưng nó nằm trên lớp CMS/web-platform, chứ không định nghĩa toàn bộ sản phẩm.

Tính minh bạch thay vì "phép thuật"

Kiến trúc agent được thiết kế dựa trên nguyên lý quan sát toàn diện (full observability). Các lệnh gọi công cụ (tool calls) phải đi kèm với quá trình suy luận (reasoning), và trạng thái hệ thống có thể được khám phá thông qua GraphQL, Prisma Studio và các công cụ workflow. Mục tiêu không phải là che giấu độ phức tạp sau một lớp trừu tượng hộp đen (black-box), mà là làm cho hành vi của agent có thể kiểm chứng và điều khiển được.

Knowledge, memory và Agent World

Wiki mô tả một số cấp độ bộ nhớ và tri thức bổ sung cho nhau:

• Knowledge Base — Concepts và một mô hình nhận thức chính thống hơn với độ tin cậy (confidence), tính hợp lệ theo thời gian (temporal validity) và các xung đột;
• MindLogs — trạng thái dài hạn, ngữ cảnh, các kết luận và kinh nghiệm tích lũy của agent;
• Tool Calls History / Memory Recall — lịch sử hành động và khả năng tìm kiếm trong quá khứ thực thi;
• Agent World — đồ thị bền vững (persistent graph) của các thực thể mà agent biết, với cơ chế chú ý (attention mechanics): các node được đọc thường xuyên sẽ nhận được ưu tiên cao hơn và được khai thác sâu hơn.

Về mặt thực tế, điều này có nghĩa là haih-agent không chỉ được thiết kế để lưu trữ nội dung trang web, mà còn dành cho các hệ thống nơi AI phải duy trì ngữ cảnh làm việc liên tục giữa các phiên.

Code-first workflows

n8n hiện được sử dụng làm môi trường thực thi (runtime) cho workflow, nhưng bản thân các workflow không được thiết kế để lắp ráp thủ công trên giao diện UI. Chúng được mô tả bằng TypeScript, được tạo/nhập khi khởi động và nằm trong git cùng với phần còn lại của mã nguồn.

Điều này mang lại khả năng kiểm soát phiên bản (version control), khả năng tái tạo và khả năng xem workflow như một phần thông thường của dự án phần mềm. Đồng thời, n8n không phải là thực thể nền tảng của sản phẩm: vai trò tiếp theo của nó có thể thay đổi và có thể được thay thế trong tương lai.

Skills như bộ nhớ thủ tục (procedural memory)

Trong haih-agent có một danh mục Skills dựa trên tệp (file-based) có thể truy cập thông qua GraphQL. Một Skill có thể nằm cạnh kiểu GraphQL mà nó liên quan, có mô tả bằng Markdown, tự động xây dựng nội dung từ dữ liệu cơ sở dữ liệu và khi cần thiết có thể chứa mã shell/node có thể thực thi.

Điều này cho phép lưu trữ không chỉ tri thức "đã biết gì", mà cả các hướng dẫn thủ tục "cách thực hiện công việc lặp đi lặp lại" dưới dạng được kiểm soát phiên bản (version-controlled).

Local-first và hạ tầng riêng

Một trong những nguyên lý của dự án là khả năng tự chạy hoàn toàn (self-hosting). Ngăn xếp (stack) bao gồm Docker, cơ sở dữ liệu riêng, máy chủ thư điện tử (mailserver) và LLM cục bộ tùy chọn thông qua llama.cpp. Cloud AI có thể được sử dụng nhưng không phải là điều kiện bắt buộc của kiến trúc.

Nơi được sử dụng

haih-agent hiện đang vận hành fi1osof.ru, freecode.academy, conceptica.world, ne-chatgpt.ru, vietnamguru.ru / vietnamguru.travel, gorodskie-bani.ru, thainguyen-city.vn, happybaby2000.ru, osobinka.su và ventyra.capital.

Tổ tiên công nghệ lịch sử: prisma-cms/nextjs-nexus.

Dòng lịch sử liên quan: MODX → prisma-cms → freecode → haih-agent.