Agent Spec là một bản đặc tả giúp xác định rõ nhiệm vụ mà một AI agent cần thực hiện, vai trò của nó, những công cụ và dữ liệu được phép sử dụng, cũng như tiêu chuẩn đánh giá kết quả. Một spec rõ ràng giúp giảm thiểu việc agent phải tự suy đoán về phạm vi công việc.
Cách tiếp cận này tương thích với cấu trúc của các framework agent hiện đại. OpenAI Agents SDK định nghĩa một agent thông qua các instructions, công cụ và hành vi bổ sung như handoffs, guardrails hay structured outputs.
Trong tài liệu P2.1 Brain Engineer – Non-IT Track, FUNiX nhấn mạnh việc cá nhân hóa assistant thông qua thông tin nền, phong cách, sở thích, memory/reference files và giới hạn hành động; workflow được xác định bằng input, kỹ năng, trigger, output, evidence và phê duyệt của con người. Điều này rất gần với cách viết một Agent Spec có kiểm soát.
Agent Spec không phải chỉ là một prompt dài
Một sai lầm phổ biến là coi Agent Spec chỉ đơn thuần là một đoạn prompt:
Bạn là một trợ lý chuyên nghiệp. Hãy làm việc cẩn thận và trả lời chính xác.
Đoạn này có thể là một phần của instruction, nhưng chưa đủ để trở thành một spec tốt. Nó chưa trả lời được các câu hỏi quan trọng như mục tiêu của agent là gì, những nhiệm vụ nào thuộc phạm vi công việc, và các hạn chế cụ thể.
Vì sao cần viết Agent Spec trước khi giao việc cho AI Agent?
Spec rõ ràng giúp giải quyết bốn vấn đề chính: giảm sự mơ hồ, kiểm soát quyền hành động, kiểm tra được chất lượng và giữ con người ở điểm quyết định quan trọng. Ví dụ, thay vì chỉ nói Hãy research đối thủ, bạn có thể yêu cầu Thu thập thông tin công khai về ba đối thủ, tập trung vào thay đổi sản phẩm trong 30 ngày gần nhất, lưu nguồn cho từng nhận định và không đưa ra kết luận nếu chưa có bằng chứng.
Khung Agent Spec gồm những gì?
- Được đọc gì
- Được tạo gì
- Được sửa gì
- Hành động nào cần xin phép
Một spec rõ ràng giúp agent hoạt động hiệu quả hơn và đảm bảo kết quả đạt tiêu chuẩn mong đợi.