Hai loại kỹ năng
Mỗi kỹ năng có số phiên bản và trạng thái bật/tắt, kèm thông tin đang được bao nhiêu agent dùng.
Thêm kỹ năng cho agent
- Tạo kỹ năng - tự viết một kỹ năng mới cho riêng agent.
- Kết nối kỹ năng workspace - lấy một kỹ năng đã có sẵn trong workspace.
- Nhờ trợ lý - mô tả việc cần lặp lại, trợ lý sẽ đề xuất tạo kỹ năng tương ứng và chờ bạn duyệt.
Sửa, xóa và bật/tắt kỹ năng
1
Sửa kỹ năng
Bấm vào thẻ kỹ năng trong danh sách để mở lại form - đổi Tên, Mô tả, Loại kỹ năng, Biểu tượng, hoặc xem lại cây file SKILL.md và các file kèm theo. Nếu kỹ năng đang được nhiều agent khác dùng, Console cảnh báo trước: “Kỹ năng này đang được N agent sử dụng - thay đổi sẽ ảnh hưởng tất cả.”
2
Xóa kỹ năng khỏi agent
Bấm icon thùng rác cạnh tên kỹ năng. Với kỹ năng riêng của agent, xóa là xóa hẳn. Với kỹ năng của workspace, xóa ở đây chỉ gỡ liên kết khỏi agent này - bản gốc trong workspace vẫn còn, agent khác vẫn dùng bình thường.
3
Bật / tắt kỹ năng
Chỉ áp dụng cho kỹ năng của workspace. Vào Tài nguyên > Kỹ năng, tìm kỹ năng cần tắt, gạt công tắc Đang bật sang tắt. Khi tắt, kỹ năng ngừng khả dụng cho MỌI agent đang gắn nó, không chỉ agent bạn đang xem - dùng khi cần tạm ngưng một kỹ năng mà không muốn xóa cấu hình.
Kỹ năng riêng của agent (tạo trực tiếp trong lúc dựng agent) không có công tắc bật/tắt - chỉ có thể sửa hoặc xóa hẳn.
Tải kỹ năng từ file có sẵn
Ngoài viết tay trong form, bạn có thể tải lên một kỹ năng đã soạn sẵn - tiện khi kỹ năng được viết ngoài, chia sẻ giữa các đội hoặc quản lý trong git. Console nhận ba dạng: .md, .zip và .skill (.skill thực chất là một gói zip đổi đuôi).
Dạng .md - kỹ năng chỉ có hướng dẫn
Chọn dạng này khi kỹ năng chỉ là một bản hướng dẫn thuần văn bản, không cần file kèm. Phần đầu file phải là khối YAML kẹp giữa hai dòng---:
SKILL.md
Phần nằm dưới khối YAML là nội dung hướng dẫn viết bằng Markdown - chính là thứ agent đọc và làm theo khi kỹ năng được kích hoạt.
Dạng .zip / .skill - kỹ năng kèm tài nguyên
Khi kỹ năng cần thêm tài liệu tra cứu, mã chạy được hay file mẫu, đóng gói tất cả vào một file zip. Ràng buộc duy nhất của hệ thống: phải có một fileSKILL.md ở gốc gói. Phần còn lại tùy bạn sắp xếp, nhưng quy ước dưới đây giúp agent định vị nhanh:
SKILL.md, kèm nút xem nội dung và tải gói về.
Gói kỹ năng giữ nguyên mọi loại file
Khi bạn tải lên gói .zip hoặc .skill, hệ thống giữ nguyên toàn bộ file bên trong, không lọc bỏ theo định dạng. Agent đọc được cả tệp nhị phân đi kèm trong gói, nên một kỹ năng có thể mang theo biểu mẫu Excel, tài liệu PDF, ảnh minh họa hay file dữ liệu mẫu để dùng khi chạy.
.skill chỉ là file zip đổi đuôi, nên cách đóng gói của hai định dạng giống hệt nhau.
Vì sao phải chia ra thay vì nhét hết vào SKILL.md
Agent không nạp cả gói vào ngữ cảnh mỗi lần chạy. Nó đọc theo ba nấc:1
Đọc description
Dòng mô tả luôn nằm sẵn trong ngữ cảnh. Agent dựa vào đây để quyết định yêu cầu hiện tại có cần kỹ năng này không.
2
Nạp SKILL.md
Khi kỹ năng được kích hoạt, toàn bộ hướng dẫn trong SKILL.md mới được nạp vào.
3
Mở file kèm khi cần
Các file trong references/, scripts/, assets/ chỉ được đọc hoặc chạy khi SKILL.md trỏ tới chúng.
SKILL.md ngắn - quy trình, điều kiện dừng và đường dẫn tới file chi tiết; phần dài đẩy hết sang references/.
Ví dụ: gói kỹ năng đối soát công nợ
Cuối mỗi tháng, kế toán phải đối chiếu sao kê ngân hàng với bảng theo dõi công nợ trên SharePoint rồi xuất báo cáo gửi trưởng phòng. Quy trình cố định, nhưng nhiều bước và có một bảng quy tắc khớp lệnh khá dài. Đóng gói lại:
Khi kế toán viên gõ “đối soát công nợ tháng 8”, agent nhận ra qua
description, nạp SKILL.md, chạy doi_soat.py, chỉ mở quy-tac-doi-soat.md khi gặp giao dịch lệch, rồi dựng báo cáo theo mau-bao-cao.html.
Tên kỹ năng nên viết thường, nối bằng dấu gạch ngang -
email-triage, doi-soat-cong-no - và trùng với tên thư mục gốc trong gói zip. Tên có dấu cách hoặc tiếng Việt có dấu dễ gây lỗi khi agent gọi kỹ năng.Một kỹ năng đáng tách ra khi nó có quy trình rõ ràng và được dùng nhiều lần - ví dụ tóm tắt báo cáo định kỳ hay phân loại email đến. Việc chỉ làm một lần thì để trong Instructions gọn hơn.