Giới thiệu
Một prompt viết tốt không phải là prompt dài nhất hay dùng nhiều từ hoa mỹ nhất. Đó là prompt khiến AI agent hiểu đúng ngay lần đầu và trả về kết quả bạn thực sự cần. Vấn đề phổ biến nhất khi làm việc với AI trong lập trình là prompt mơ hồ: không rõ bạn đang yêu cầu ai, trong hoàn cảnh nào, cần làm gì, và kết quả trả về trông như thế nào. Bài này sẽ đưa ra một cấu trúc cụ thể để giải quyết đúng vấn đề đó.
Bốn thành phần cốt lõi của một prompt hiệu quả
Một prompt hiệu quả cho AI agent trong bối cảnh lập trình thường gồm bốn phần: Vai trò, Ngữ cảnh, Nhiệm vụ, và Định dạng đầu ra. Không phải lúc nào cũng cần đủ cả bốn, nhưng hiểu rõ từng phần giúp bạn biết khi nào nên bỏ bớt và khi nào bắt buộc phải có.
Vai trò là cách bạn xác định AI agent đang đóng vai gì. Ví dụ: "Bạn là một senior Python developer" hay "Bạn là code reviewer chuyên về security". Khai báo vai trò giúp agent điều chỉnh ngôn ngữ, mức độ chi tiết và góc nhìn khi trả lời.
Ngữ cảnh cung cấp thông tin nền mà agent cần để hiểu đúng tình huống. Đây là phần nhiều người bỏ qua nhất. Ví dụ: "Dự án đang dùng Django 4.2, chạy trên Python 3.11, cơ sở dữ liệu là PostgreSQL" hoặc "Hàm này đang được gọi trong một vòng lặp xử lý 10.000 bản ghi mỗi lần".
Nhiệm vụ là phần mô tả chính xác bạn muốn agent làm gì. Câu nhiệm vụ tốt thường bắt đầu bằng một động từ rõ ràng: viết, refactor, giải thích, kiểm tra, tạo test, tối ưu. Tránh dùng những từ chung chung như "giúp tôi với đoạn code này".
Định dạng đầu ra cho agent biết kết quả cần trả về ở dạng nào: chỉ code, code kèm giải thích từng bước, danh sách các vấn đề cần sửa, hay một bảng so sánh các phương án. Nếu bạn không chỉ định, agent sẽ tự chọn định dạng và thường không khớp với điều bạn cần.
Ví dụ thực tế
So sánh hai cách viết prompt cho cùng một yêu cầu:
Prompt yếu: "Sửa lỗi trong đoạn code Python này cho tôi."
Prompt theo cấu trúc: "Bạn là một Python developer có kinh nghiệm với xử lý lỗi và clean code. Đoạn code dưới đây là một hàm đọc file CSV và parse dữ liệu, hiện đang raise KeyError không rõ nguyên nhân khi chạy với một số file đầu vào. Hãy xác định nguyên nhân gây ra KeyError, sửa lại hàm với error handling phù hợp, và giải thích ngắn gọn từng thay đổi bạn thực hiện."
Prompt thứ hai rõ ràng hơn ở cả bốn chiều: agent biết mình là ai, biết đây là hàm parse CSV đang gặp lỗi cụ thể, biết nhiệm vụ là tìm và sửa lỗi, và biết cần giải thích từng thay đổi.

Áp dụng vào các tình huống lập trình thường gặp
Viết unit test: "Bạn là QA engineer quen với pytest. Hàm bên dưới tính tổng giờ làm việc từ một danh sách timestamp. Hãy viết unit test bao phủ các edge case: danh sách rỗng, timestamp không hợp lệ, và khoảng thời gian vượt quá 24 giờ. Trả về chỉ code test, không cần giải thích."
Code review: "Bạn là senior developer chú trọng security và performance. Đây là endpoint FastAPI xử lý đăng nhập người dùng. Hãy liệt kê các vấn đề bảo mật tiềm ẩn theo thứ tự mức độ nghiêm trọng từ cao xuống thấp, mỗi vấn đề ghi rõ vị trí trong code và cách khắc phục."
Refactor: "Bạn là Python developer theo chuẩn PEP 8 và nguyên tắc SOLID. Đoạn code này đang có một hàm dài 80 dòng xử lý nhiều việc khác nhau. Hãy refactor thành các hàm nhỏ hơn với trách nhiệm rõ ràng. Giữ nguyên logic xử lý, chỉ thay đổi cấu trúc."
Mỗi ví dụ đều có đủ vai trò, ngữ cảnh đủ để agent không phải đoán, nhiệm vụ dùng động từ rõ ràng, và định dạng đầu ra được chỉ định cụ thể.

Tổng kết
Cấu trúc bốn phần — Vai trò, Ngữ cảnh, Nhiệm vụ, Định dạng đầu ra — không phải công thức cứng nhắc mà là checklist tư duy. Trước khi gửi prompt, hãy tự hỏi: agent có biết mình đang đóng vai gì không, có đủ thông tin về tình huống không, nhiệm vụ có được mô tả bằng động từ cụ thể không, và kết quả mong muốn có được chỉ định rõ không. Trả lời được bốn câu đó, prompt của bạn đã tốt hơn phần lớn những gì người dùng thường viết.
Bài kiểm tra cuối bài
Ôn lại kiến thức, thử sức và nhận góp ý cho bài làm.