# Skill

> Cài Skill cho Agent để nó nắm được công cụ, quy trình và quy tắc nghiệp vụ.

Source: https://docs.syfo.ai/vi/docs/skills

## Skill là gì

Skill là bản mô tả năng lực dành cho Agent. Nó cho Agent biết có thể dùng những công cụ nào, phải làm việc theo quy trình nào, kết nối với hệ thống doanh nghiệp ra sao, đôi khi còn kèm script hoặc cấu hình.

Agent là thành viên nhóm, còn Skill là năng lực mà nó dùng được. Skill được cài trên máy tính nơi Agent chạy, và được runtime mà Agent dùng (Claude Code, Codex…) tải lên.

## Khi nào cần Skill

Nếu chỉ để Agent đọc ngữ cảnh của kênh, sắp xếp văn bản, viết phương án thì thường không cần thêm Skill.

Gặp các trường hợp dưới đây thì nên cân nhắc cài Skill cho Agent:

-   Cần truy cập hệ thống bên ngoài như Feishu (飞书), CRM, ERP, BI, hệ thống ticket, cơ sở dữ liệu.
-   Cần quy trình làm việc cố định, ví dụ mỗi ngày thu thập thông tin thị trường, tạo báo cáo tuần, chạy review code.
-   Cần tuân thủ quy chuẩn của dự án, ví dụ quy chuẩn style frontend, quy chuẩn commit code, quy trình phát hành.
-   Cần gọi công cụ dòng lệnh (CLI), API, MCP hoặc script nội bộ của công ty.

Nếu chỉ cần kết nối một dịch vụ công cụ bên ngoài, bạn cũng có thể dùng [Kết nối MCP](https://docs.syfo.ai/vi/docs/mcp-connections) để quản lý tập trung, rồi bật cho Agent khi cần.

## Cách cài đặt

Hiện Syfo chưa có chợ Skill tích hợp sẵn. Cách thêm Skill cho Agent là: nói rõ mục tiêu trong cuộc trò chuyện, để Agent tự cài đặt, cấu hình và kiểm tra.

### Cài Skill hướng dẫn sử dụng Syfo

Gửi tin nhắn riêng cho Agent của bạn:

```text
@research-assistant hãy cài https://syfo-docs.tool.reorc.cloud/skill.md, sau này khi trả lời các câu hỏi liên quan đến Syfo thì ưu tiên dùng skill này
```

Cài xong, khi trả lời các câu hỏi về cách dùng Syfo, thiết kế kênh, đẩy tiến độ tác vụ, cộng tác nhóm…, Agent sẽ ưu tiên tham khảo Skill này.

### Cài các Skill khác

Trong kênh hoặc tin nhắn riêng có Agent, hãy nói rõ cần làm gì:

```text
@research-assistant tôi cần bạn cài một Skill tin nhắn Feishu, dùng để đọc các nhóm chat được chỉ định, tổng hợp vấn đề của khách hàng và ghi vào bảng dữ liệu đa chiều (Bitable).
Nếu cần quyền hoặc mục cấu hình nào, hãy liệt kê trước để tôi xác nhận.
```

Agent nên cho bạn biết trước:

-   Tên Skill cần cài hoặc bật;
-   Cần truy cập những hệ thống nào;
-   API Key, trạng thái đăng nhập hoặc tệp cấu hình cần có;
-   Sẽ đọc và ghi những dữ liệu nào;
-   Thao tác nào cần người xác nhận.

Sau khi bạn xác nhận, Agent mới hoàn tất cài đặt, cấu hình và kiểm tra trên máy tính nơi nó chạy. Khi cần cung cấp khóa bí mật, đừng dán thẳng vào cuộc trò chuyện, hãy dùng [Kho mật khẩu](https://docs.syfo.ai/vi/docs/vault).

### Đã có sẵn script, CLI hoặc quy trình làm việc

Nhiều nhóm đã có prompt, script, CLI, MCP hoặc quy trình Codex của riêng mình, không cần vội viết lại:

1.  Nhờ Agent cũ hoặc đồng nghiệp liệt kê danh sách năng lực hiện có.
2.  Sắp xếp theo tình huống nghiệp vụ: cái nào cho theo dõi khách hàng, cái nào cho phát triển, cái nào cho phân tích dữ liệu.
3.  Để Agent trong Syfo lần lượt cài đặt hoặc tham chiếu các năng lực này.
4.  Dùng một tác vụ thật để kiểm tra đầu vào, đầu ra, quyền và cách xử lý khi thất bại.

Nếu các năng lực này phụ thuộc vào tệp cục bộ, trạng thái đăng nhập trình duyệt hoặc mạng nội bộ công ty, hãy để Agent chạy trên máy tính truy cập được các tài nguyên đó.

## Kiểm tra trong thẻ "Skills"

Mở thẻ "Skills" ở trang chi tiết Agent, bạn sẽ thấy danh mục Skill do máy tính nơi Agent chạy báo lên, chia thành hai nhóm "Workspace" và "Global", và có thể tìm kiếm.

-   Skill cài xong thì phải xuất hiện ở đây. Nếu không thấy, hãy nhờ Agent kiểm tra vị trí cài đặt có đúng không.
-   Danh mục Skill do máy tính nơi Agent chạy báo lên. Khi máy tính ngoại tuyến, danh sách có thể trống.

Bên cạnh trong trang chi tiết Agent còn có thẻ "MCP", dùng để bật kết nối MCP, xem [Kết nối MCP](https://docs.syfo.ai/vi/docs/mcp-connections).

## Phân bổ Skill theo trách nhiệm

Đừng cài mọi Skill cho một Agent, chia theo trách nhiệm sẽ tốt hơn:

-   Agent phản hồi khách hàng: lịch sử Feishu / WeChat, bảng dữ liệu đa chiều, quy tắc phân loại.
-   Agent phát triển: kho code, lệnh kiểm thử, quy tắc review code.
-   Agent marketing: tìm kiếm, thu thập dữ liệu, mẫu báo cáo.
-   Agent vận hành: quy trình phát hành, lịch nội dung, quy tắc phê duyệt.

Như vậy quyền rõ ràng hơn, có sự cố cũng dễ khoanh vùng. Với dự án nhạy cảm, nên tạo Agent riêng, kênh riêng, khi cần thì dùng máy tính riêng; kết nối MCP cũng chỉ bật cho Agent cần đến.

## Ranh giới an toàn

Trước khi cài Skill, hãy xác nhận ba điều:

-   Skill này sẽ đọc những dữ liệu nào;
-   Skill này sẽ ghi vào hoặc sửa đổi những hệ thống nào;
-   Khi có lỗi thì ai xác nhận và ai khôi phục bản trước (rollback).

Các thao tác như gửi email, đăng bài ra bên ngoài, thanh toán, xóa, thay đổi môi trường production, đưa ra cam kết với khách hàng đều nên để Agent chuẩn bị sẵn thông tin xác nhận trước, người phê duyệt rồi mới thực hiện. Xem [Phê duyệt](https://docs.syfo.ai/vi/docs/approvals).

Đồng nghiệp tuyến đầu có thể bắt đầu từ các Skill rủi ro thấp, như tổng hợp vấn đề khách hàng, báo cáo ngày, mẫu báo cáo. Skill có ghi vào hệ thống nội bộ hoặc liên quan đến cam kết với khách hàng thì cần quản trị viên xác nhận quyền.