Skill
Đây là gì
Skill là kinh nghiệm được viết ra một lần và dùng cho nhiều Agent: quy trình hoàn tiền, giọng văn thương hiệu, cách đọc một vận đơn. Skill chỉ là văn bản, không tự thay đổi gì. Agent có Skill chỉ thấy phần mô tả, và mở toàn văn khi một yêu cầu khớp. Skill nằm ở menu trái, mục Build → Skills.
Khái niệm chính
- Tên skill — tên để mọi người tìm thấy Skill trong danh sách.
- Mô tả — một hai câu nói Skill dùng khi nào ("Dùng khi khách hỏi về hoàn tiền."). Agent chỉ đọc dòng này để quyết định có mở Skill hay không, nên hãy mô tả tình huống, đừng tóm tắt nội dung.
- Nội dung — các bước Agent làm theo, viết bằng Markdown: khi nào áp dụng, các bước theo thứ tự, quy tắc kèm con số cụ thể, câu chữ nên dùng, và khi nào chuyển cho người.
- Tools trong skill — các Tool được nhắc tới trong nội dung bằng
@. Agent có Skill cũng nhận luôn các Tool này. Tool chỉ do Skill mang tới thì giữ chế độ duyệt mặc định: nó hỏi người trước khi chạy nếu có ghi dữ liệu và FLAE khuyên nên duyệt. - Agent đang dùng — các Agent có Skill này trong bản nháp hoặc phiên bản production.
- Skill, Tool hay hướng dẫn — Skill dạy cách suy nghĩ, cách viết hoặc cách áp dụng một chính sách; Tool đọc hoặc thay đổi dữ liệu trong một hệ thống; còn vài thông tin chỉ một Agent cần thì nên đặt trong hướng dẫn của Agent đó.
Cách hoạt động
Một Skill có một bản nháp và một bản đã publish, không có phiên bản đánh số.
| Nhãn | Ý nghĩa |
|---|---|
| Nháp | Chưa publish lần nào. Agent chưa chọn được. |
| Đã publish | Agent đã chọn Skill dùng nội dung đã publish. |
| Có bản nháp | Đã publish, và bản nháp đã được sửa sau đó. Agent vẫn dùng nội dung đã publish. |
| Đã lưu trữ | Chỉ xem. Agent đang dùng sẽ không thấy Skill nữa. |
- Tạo skill tạo một bản nháp tên "Skill mới" và mở ra.
- Sửa tên, mô tả và nội dung, rồi bấm Lưu thay đổi. Lưu chỉ thay đổi bản nháp.
- Publish chép bản nháp đã lưu sang bản đã publish. Hộp thoại liệt kê các Agent đang dùng Skill; từ lượt kế tiếp chúng dùng nội dung mới. Không cần sửa gì ở các Agent đó.
- Lưu trữ ẩn Skill khỏi mọi Agent đang dùng nó. Khôi phục đưa Skill về Đã publish (hoặc Nháp nếu chưa từng publish).
Trên Agent, Skill được dùng thế này: Agent thấy mô tả của từng Skill đã chọn, mở nội dung khi yêu cầu khớp, và nhận các Tool mà nội dung nhắc tới.
Thao tác thường gặp
Viết một Skill
- Vào Skills và bấm Tạo skill.
- Đổi tên ở ô Tên skill.
- Viết Mô tả: khi nào Agent nên dùng Skill.
- Viết Nội dung. Gõ
@để nhắc tới một Tool đã publish ở bước dùng Tool đó ("Tra đơn hàng bằng @…"). - Bấm Lưu thay đổi, rồi Publish.
Giao Skill cho một Agent
- Publish Skill trước; bản nháp thì không chọn được ("Publish skill này trước khi chọn.").
- Mở Agent trong trình xây Agent. Trong thẻ Skills, bấm Thêm skill và chọn Skill đó.
- Lưu và publish Agent. Xem Agent.
Sửa một Skill đang có Agent dùng
Sửa rồi bấm Lưu thay đổi: các Agent vẫn dùng nội dung đã publish. Khi sẵn sàng, bấm Publish; mọi Agent có Skill sẽ chuyển sang nội dung mới từ lượt kế tiếp.
Giới hạn và quy tắc
- Ai làm được gì: Admin và Builder của Workspace (và Owner, Admin của Organization) tạo, sửa, publish, lưu trữ và khôi phục Skill. Thành viên khác xem được. Không thể thay đổi gì trong Workspace đã lưu trữ.
- Muốn publish phải có mô tả và nội dung.
- Mô tả: tối đa 500 ký tự. Nội dung: tối đa 20.000 ký tự. Tên: tối đa 255 ký tự.
- Mọi chỗ nhắc
@phải là Tool của Workspace này. - Mỗi Agent có tối đa 20 Tool, tính cả Tool mà các Skill của nó nhắc tới. Lần publish hoặc khôi phục nào khiến một Agent vượt giới hạn này sẽ bị từ chối và nêu tên các Agent đó ("Skill này sẽ khiến agent vượt giới hạn tool: …"); hãy bớt Tool trong Skill hoặc trong Agent.
- Mỗi Agent chọn được tối đa 20 Skill.
- Skill không xoá được; hãy lưu trữ.
- Assistant có thể viết và sửa bản nháp Skill, nhưng chỉ người mới publish được, trong app.
- Skill không test riêng được; hãy test qua một Agent có Skill đó, ở tab Test của Agent.