Cách Viết Skill Hiệu Quả cho Agent AI

02/05/2026 Sơn Nguyễn 7 phút đọc

Skill là "bộ não" của Agent AI. Đó là tập hợp các hành động mà Agent biết cách thực hiện. Một Skill tốt không chỉ giải quyết vấn đề, mà còn dễ bảo trì, dễ hiểu, và có thể tái sử dụng cho các quy trình khác.

Skill là gì?

Skill là một "công cụ" (function) mà Agent có thể gọi để hỗ trợ hoàn thành task. Ví dụ:

Skill "xuất báo cáo": Đọc dữ liệu từ Google Sheet, xử lý, xuất file Excel
Skill "gửi email": Soạn email theo mẫu, gửi tới danh sách người nhận
Skill "tra cứu": Tìm thông tin khách hàng từ CRM
Skill "nhập liệu": Kiểm tra và lưu dữ liệu vào database

5 Nguyên tắc viết Skill hiệu quả

1. Chuẩn hóa Input (Đầu vào)

Skill phải rõ ràng về những gì nó cần nhận vào. Đây là công cụ giúp Agent hiểu được tham số nào để truyền vào.

{
  "type": "object",
  "properties": {
    "email": { "type": "string", "description": "Email người nhận" },
    "subject": { "type": "string", "description": "Tiêu đề email" },
    "body": { "type": "string", "description": "Nội dung email" }
  },
  "required": ["email", "subject", "body"]
}
				

2. Chuẩn hóa Output (Đầu ra)

Skill phải trả về kết quả theo một định dạng nhất quán. Điều này giúp Agent và người dùng biết được Skill có hoạt động thành công hay thất bại.

					Ví dụ trả về thành công:

					{ "success": true, "message": "Email sent successfully", "id": "12345" }

					Ví dụ trả về lỗi:

					{ "success": false, "error": "Invalid email address" }

3. Viết Logic rõ ràng

Logic của Skill nên đơn giản, dễ theo dõi, và có comment rõ ràng:

async function sendEmail(email, subject, body) {
  // 1. Validate email
  if (!isValidEmail(email)) {
    return { success: false, error: "Email không hợp lệ" };
  }

  // 2. Kiểm tra dữ liệu
  if (!subject || !body) {
    return { success: false, error: "Thiếu tiêu đề hoặc nội dung" };
  }

  // 3. Gửi email
  try {
    const result = await mailer.send({ email, subject, body });
    return { success: true, id: result.id };
  } catch (err) {
    return { success: false, error: err.message };
  }
}
				

4. Xử lý Lỗi (Error Handling)

Skill tốt phải chuẩn bị cho trường hợp xấu. Không để lỗi "bất ngờ" làm Agent bị dừng:

Kiểm tra input trước khi xử lý
Bắt exception và trả về message rõ ràng
Ghi log để dễ debug sau

5. Viết Test để chắc chắn

Trước khi bàn giao, test Skill với các trường hợp:

Trường hợp bình thường (happy path)
Trường hợp input sai (email sai định dạng, dữ liệu thiếu…)
Trường hợp lỗi mạng hoặc timeout

Quy trình viết Skill từ A đến Z

Bước 1: Phân tích Quy trình nội bộ

Trước khi viết code, hãy hiểu rõ workflow:

Người dùng bước vào như thế nào?
Những bước nào là lặp lại, thủ công?
Kết quả cuối cùng là gì?
Có những ngoại lệ nào?

Bước 2: Thiết kế Skill (spec)

Viết tài liệu nêu rõ:

📋 Spec Skill "Xuất báo cáo":
- Mục đích: Xuất báo cáo doanh thu tháng từ Google Sheet thành file Excel
- Input: month (số tháng), year (năm)
- Output: File path hoặc URL download
- Lỗi có thể xảy ra: Tháng/năm không hợp lệ, Sheet không có dữ liệu

Bước 3: Code & Test

Viết code theo spec, test kỹ lưỡng, fix bug.

Bước 4: Tài liệu hóa

Viết SOP (Standard Operating Procedure) cho người vận hành:

📖 SOP: Xuất báo cáo doanh thu

1. Yêu cầu Agent: "Xuất báo cáo tháng 5 năm 2026"
2. Agent sẽ:
   - Lấy dữ liệu từ Google Sheet "Doanh thu tháng"
   - Tính toán tổng, trung bình
   - Tạo file Excel với biểu đồ
   - Gửi email tới [email danh sách]
3. Nếu lỗi:
   - "Không có dữ liệu" → Kiểm tra Sheet có tháng đó không
   - "Email lỗi" → Kiểm tra danh sách email trong cấu hình
				

Lỗi thường gặp khi viết Skill

❌ Input không rõ: Agent không biết phải truyền gì → Viết chi tiết description của mỗi parameter
❌ Output không nhất quán: Khi thành công trả về 1 format, khi lỗi lại trả về format khác → Luôn trả về { success, data/error }
❌ Không xử lý timeout: Skill mất > 30 giây Agent sẽ timeout → Đặt timeout, return kết quả tạm thời
❌ Ghi log không đủ: Khi có vấn đề khó debug → Ghi log chi tiết từng bước (nhưng đừng log password, API key)

Kết luận

Viết Skill tốt là nghệ thuật cân bằng giữa logic phức tạp và đơn giản hóa. Nếu bạn cần hỗ trợ viết Skill cho quy trình nội bộ, hãy liên hệ chúng tôi để cùng phân tích và xây dựng nhé!

Cần viết Skill cho doanh nghiệp?
Gọi: 0905 458 281