Phần 6 của 5120% hoàn thành

Agent mode — AI chủ động làm việc với code

English title: Agent Mode — AI Works Proactively with Your Code

Bài 6 trong chuỗi 15 bài hướng dẫn Cursor. Trong Composer (Cmd+I) có hai chế độ: Normal mode — AI chủ yếu tìm kiếm và gợi ý code; Agent mode — AI tự mở file, sửa code, chạy terminal (vd. chạy test). Bật Agent mode bằng Cmd+. (Mac) hoặc Ctrl+. (Windows/Linux). "AI tự mở file, sửa, chạy test" — đó chính là Agent mode. Bài này giúp bạn hiểu khác biệt và khi nào dùng.

Mở đầu: AI tự mở file, sửa, chạy test

Bạn mô tả: "Thêm comment JSDoc cho tất cả function trong file utils.ts và chạy npm test." Trong Normal mode, AI có thể đưa ra đoạn code mẫu và gợi ý bạn apply. Trong Agent mode, AI có thể mở file utils.ts, tìm từng function, thêm comment, lưu file, rồi chạy npm test trong terminal và báo kết quả. Bạn chỉ cần xem diff và accept hoặc reject. Đó là sự khác biệt: Agent mode = AI thực thi thay đổi và lệnh, không chỉ gợi ý.

1. Đi sâu: Normal mode vs Agent mode

Tại sao chủ đề này quan trọng: Nếu bạn không bật Agent mode, nhiều task "sửa nhiều file" hoặc "chạy lệnh" sẽ chỉ dừng ở mức gợi ý — bạn phải tự apply và tự chạy. Agent mode giảm thao tác tay và tăng tốc khi task rõ ràng.

Hiểu sai thường gặp: Nhiều người nghĩ "Composer = Agent". Thực tế Composer có hai chế độ; mặc định có thể là Normal. Cần bật rõ Agent (Cmd+.) khi muốn AI "làm" thay vì "gợi ý".

Bản chất đúng: Normal mode trong Composer: AI search codebase, generate code, có thể propose edit nhưng bạn thường phải approve từng bước. Agent mode: AI có quyền dùng tool (read_file, edit_file, run_terminal_cmd) và thực hiện nhiều bước liên tiếp; bạn xem kết quả (diff, output) rồi accept hoặc revert.

2. Khái niệm

Agent mode: Chế độ trong Composer khi AI chủ động gọi tool — đọc file, sửa file, chạy lệnh terminal. Bật bằng Cmd+. (Mac) / Ctrl+. (Win/Linux). Phù hợp task đa bước, đa file.
Normal mode: Chế độ Composer khi AI chủ yếu tìm kiếm và generate; ít "tự động" thực thi thay đổi so với Agent mode.
Tool (trong Cursor): Các hành động AI có thể gọi: read_file, search, edit_file, run_terminal_cmd, v.v. Agent mode dùng nhiều tool hơn và tự quyết định thứ tự.

3. Workflow: Khi nào dùng Agent

Task một file, một đoạn rõ ràng — Normal mode có thể đủ: AI gợi ý, bạn accept edit.
Task nhiều file hoặc cần chạy test/build — Bật Agent mode (Cmd+.). Mô tả task; AI sẽ tìm file, sửa, chạy lệnh. Bạn xem diff và output terminal.
Luôn xem diff trước khi accept (bài 13): Agent có thể sửa rộng hơn ý bạn; review từng thay đổi và accept có chọn lọc.
Dùng Rules (bài 8) để hướng dẫn Agent (vd. "luôn chạy test trước khi suggest commit").

4. Ví dụ ngắn

"Đổi tất cả console.log trong folder src/ thành logger.info" — Agent mode: AI có thể duyệt file, tìm console.log, thay thế, lưu. Bạn review diff.
"Thêm unit test cho function parseDate trong utils/time.ts và chạy npm test" — Agent mode: AI đọc function, viết test, chạy npm test, báo pass/fail.

5. Ứng dụng

Sau bài này bạn đã biết: Agent mode (Cmd+.) = AI chủ động sửa file và chạy lệnh; Normal mode = gợi ý là chính. Bài tiếp: Plan mode — lên kế hoạch trước khi code cho feature lớn.

Bài tiếp: Plan mode — lên kế hoạch trước khi code (bài 7).