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

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

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

3. Quản Trị Ngữ Cảnh: Progressive Disclosure Thay Vì Context Flooding

Nghệ thuật cung cấp Bản đồ thay vì Cuốn hướng dẫn dày đặc. Tối ưu hóa tỷ lệ tín hiệu trên mỗi token (Signal-per-token) và ngăn ngừa hiện tượng nghẽn ngữ cảnh làm suy giảm trí thông minh của mô hình.

Đổ toàn bộ cây thư mục, toàn bộ tài liệu dự án và lịch sử chat 50 trang vào Context Window không phải là Context Engineering — đó là Context Flooding (Lụt ngữ cảnh). Càng nhiều thông tin rác trong cửa sổ ngữ cảnh, khả năng tập trung chú ý (Attention Mechanism) của mô hình càng suy giảm.

🗺️ Nguyên Lý 'Bản Đồ, Không Phải Cuốn Sách' (Map, Not Manual)

Một kiến trúc Harness xuất sắc tuân thủ nguyên lý Progressive Disclosure (Tiết lộ tuần tự):

Harness chỉ cung cấp một bản đồ tổng quan nhỏ trước, sau đó trao cho Agent công cụ để nó tự đào sâu và truy xuất chi tiết khi nhiệm vụ thực sự cần đến.

![Map, Not Manual](/static/img/courses/harness-engineering/HRhrurDaYAAgCWo.jpg)

Ngữ cảnh chỉ nên mở rộng vì nhiệm vụ đòi hỏi, chứ không phải vì thông tin đó đang tồn tại trong ổ cứng.

| Phương pháp cũ: Context Flooding | Phương pháp chuẩn: Progressive Disclosure |

| :--- | :--- |

| Nhét toàn bộ 500 file code vào prompt ngay từ đầu | Cung cấp file PROJECT_MAP.md mô tả kiến trúc 1 trang |

| Bắt mô hình đọc hết tài liệu API 100 trang | Cung cấp bảng mục lục tóm tắt, Agent dùng tool read_doc(endpoint) khi cần |

| Tỷ lệ tín hiệu loãng (Low Signal-per-token), chi phí token cao | Tối đa hóa tín hiệu trên mỗi token (Max Signal-per-token) |

| Mô hình dễ bị ảo giác, bỏ qua chi tiết quan trọng ở giữa prompt | Mô hình đọc chính xác file cần sửa, không bị phân tán |

example.py
# PROJECT_MAP.md - BẢN ĐỒ DỰ ÁN TINH GỌN (DƯỚI 150 DÒNG)
# Cung cấp cho Agent cái nhìn toàn cảnh mà không gây ngợp Context

# 1. CORE ARCHITECTURE
Frontend: Flask / Jinja2 + Vanilla Modern CSS/JS (Zero-dependency framework)
Backend: Python 3.11+ / SQLAlchemy 2.0 / SQLite (courses.db)
Search: Pure client-side fuzzy search in static/app.js

# 2. DIRECTORY STRUCTURE & RESPONSIBILITIES
├── app.py                # Main Flask application, routes & security middleware
├── models.py             # Database models (Course, Lesson, Post, User)
├── seed.py               # Database initialization and idempotency triggers
├── audit_gatekeeper.py   # Mandatory pre-commit quality gate (54 automated checks)
├── build_static.py       # Production SSG generator (exports 430+ static HTML pages)
├── templates/            # Semantic HTML5 Jinja2 templates
   ├── base.html         # Root layout with CSP & navigation
   ├── courses/          # Course listing & detail views
   └── blog/             # Bilingual blog templates (VI ⇋ EN)
└── static/               # Assets (CSS variables, modern JS, images)
    ├── styles.css        # Pure CSS design system
    ├── i18n.js           # 0ms instant bilingual hydration engine
    └── app.js            # Interactive widgets & search filters

# 3. CRITICAL INVARIANTS
- DO NOT add external runtime JavaScript CDNs (must comply with strict CSP connect-src).
- All changes must pass `python audit_gatekeeper.py` with 0 failures before merging.
- Multi-language must support 0ms hydration without page reload.

⚙️ Nhiệm Vụ Của Một Bộ Biên Dịch Ngữ Cảnh (Context Compiler)

Harness cần một module đóng vai trò Context Compiler để ra quyết định thời gian thực:

  • Những gì luôn cần: Mục tiêu contract, các ràng buộc bất biến (Invariants), bản đồ thư mục.
  • Những gì truy xuất sau: Nội dung chi tiết từng file mã nguồn, log lỗi chi tiết.
  • Những gì đã lỗi thời: Lệnh test đã chạy ở bước 3, phản hồi nháp cũ không còn giá trị.
  • Những gì có thể tóm tắt: Quá trình khám phá 10 file chỉ cần ghi lại: "Đã kiểm tra 10 file, xác định lỗi nằm ở dòng 42 của utils.py".
  • Những gì phải giữ nguyên từng chữ (Verbatim): Khóa định danh, thông báo lỗi stack trace gốc, chữ ký hàm API.
Thực hành

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

Hãy tạo một file PROJECT_MAP.md ngắn gọn cho dự án hoặc thư mục làm việc của bạn, tuân thủ nguyên tắc: Tối đa 1 trang A4 nhưng đủ để một kỹ sư mới (hoặc AI) nắm được toàn bộ bức tranh.

🏢 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.