Đào tạo doanh nghiệpHarness Engineering: Kỹ Thuật Đóng Khung Môi Trường Cho AI Agent Thực Chiến
5/8

Giáo trình tự học miễn phí · Dịch vụ hỗ trợ theo nhu cầu.

Bài 0540phút ước tínhCơ bản

5. Tách Biệt Ba Lớp: Brain (Não) – Hands (Tay) – History (Ký Ức Bền Vững)

Tránh bẫy trộn lẫn tất cả vào một transcript khổng lồ. Kiến trúc phân tách ba trách nhiệm độc lập giúp Agent chạy hàng giờ mà không mất kiểm soát.

Nhiều hệ thống AI Agent mong manh thất bại vì chúng dồn tất cả mọi thứ vào một luồng hội thoại duy nhất: Suy luận của mô hình, phản hồi JSON công cụ, nội dung file nguồn, thông báo lỗi và quyết định trước đó đều chen chúc trong một context window. Hệ quả là context phình to, chi phí tăng vọt và mô hình bắt đầu lẫn lộn.

🧩 Ba Trách Nhiệm Độc Lập Trong Kiến Trúc Bền Vững

Hệ thống chuyên nghiệp luôn tách biệt 3 tầng kiến trúc:

![Brain, Hands, History](/static/img/courses/harness-engineering/HRhr80OWgAAF953.jpg)

  1. Brain (Bộ não - Reasoning Engine):
  • Không cần nhìn thấy toàn bộ lịch sử thô sơ của 100 bước chạy trước.
  • Nó chỉ cần nhìn thấy trạng thái hiện tại chính xác nhất (Current State) và hợp đồng nhiệm vụ.
  1. Hands (Bàn tay - Execution Sandbox):
  • Không cần hiểu toàn bộ triết lý hay bức tranh kinh doanh của công ty.
  • Nó chỉ cần thực thi một hành động có giới hạn, an toàn và trả về kết quả chuẩn.
  1. History (Lịch sử & Ký ức - Durable State):
  • Không cần phải suy luận hay tư duy.
  • Nhiệm vụ của nó là lưu trữ trung thực những gì đã diễn ra để khi context bị làm mới (hoặc máy chủ khởi động lại), phiên làm việc mới có thể tiếp tục ngay lập tức.

📦 Ký Ức Phải Trở Thành Trạng Thái Bền Vững (Memory Must Become State)

Lịch sử trò chuyện (Conversation Transcript) không phải là trí nhớ đáng tin cậy. Nó chỉ là một dòng sự kiện thô (Event Stream). Muốn Agent ghi nhớ hiệu quả qua nhiều ngày, bạn phải có module biên dịch dòng sự kiện đó thành 4 cột trụ trạng thái tường minh:

![Memory Must Become State](/static/img/courses/harness-engineering/HRhsAy3bsAAjePW.jpg)

  1. Facts (Sự thật khách quan đã xác minh): Dự án dùng Python 3.11, database đặt tại cổng 5432, API key Stripe ở chế độ test.
  2. Decisions (Các quyết định đã chốt): Đã chọn phương án dùng JWT thay vì Session Cookie; không đổi schema bảng Orders.
  3. Progress (Tiến độ thực tế): Đã hoàn thành bước 1 và 2; đang ở bước 3 (viết unit test); bước 4 và 5 chưa bắt đầu.
  4. Lessons (Bài học kinh nghiệm rút ra sau lỗi): Thư viện lib-xyz không tương thích với Windows, phải dùng cờ --no-sandbox.

Lưu trữ lịch sử thô để kiểm toán (Auditability). Biên dịch trạng thái bền vững để thực thi (Execution).

example.py
# CẤU TRÚC STATE.JSON - KÝ ỨC BỀN VỮNG CỦA MỘT AGENT CHUẨN MỰC
{
  "session_id": "SES-2026-09-08-HARNESS",
  "task_contract_ref": "TASK-2026-OPTIMIZE-ONBOARDING",
  "durable_state": {
    "facts": {
      "python_version": "3.12.2",
      "test_framework": "pytest",
      "main_db": "SQLite / courses.db"
    },
    "decisions": [
      {"id": "DEC-1", "note": "Giữ nguyên cấu trúc bảng courses, chỉ bổ sung cột mới nếu có migration", "timestamp": "10:15:00"},
      {"id": "DEC-2", "note": "Dùng cơ chế 0ms DOM mutation thay vì reload trang", "timestamp": "10:45:00"}
    ],
    "progress": {
      "current_step": 3,
      "total_steps": 5,
      "completed_steps": ["1. Khám phá thư mục", "2. Tạo file migration"]
    },
    "lessons_learned": [
      {"trigger": "pytest_fail", "fix": "Cần thêm context processor trước khi render route /doanh-nghiep"}
    ]
  }
}
Thực hành

Thực hành và tự đánh giá

Lập bảng 4 cột trụ (Facts, Decisions, Progress, Lessons) cho công việc hiện tại của bạn trong ngày hôm nay. Nhận xét xem việc này giúp bạn tiết kiệm bao nhiêu thời gian so với việc đọc lại toàn bộ lịch sử chat dài.

🏢 BẠN MUỐN TRIỂN KHAI CHO CẢ PHÒNG BAN / DOANH NGHIỆP?
Đề Xuất Công Ty Tài Trợ & Đào Tạo In-House Trọn Gói

AI Tinh Gọn hỗ trợ khảo sát hiện trạng, kèm 1-1 on-premise bảo mật dữ liệu, setup hạ tầng riêng và xuất hóa đơn VAT hợp pháp cho doanh nghiệp.

⚖️ Bản quyền sở hữu trí tuệ: © 2026 AI Tinh Gọn (aitinhgon.vn) · Giấy phép Creative Commons CC BY-NC-ND 4.0. Cho phép tự học cá nhân, nghiêm cấm thương mại hóa hoặc bán lại. Giáo trình mở →

Tiến độ tự học lưu trên trình duyệt này. Chỉ đánh dấu khi đã kiểm tra sản phẩm thực hành.