NeboAI
NeboAI
Bắt đầu

Kỹ năng

Kỹ năng dạy nhân viên cách làm tốt một loại công việc. Bạn viết nó dưới dạng một thư mục có tệp SKILL.md: một đoạn mô tả ngắn mà nhân viên dùng để chọn kỹ năng, và các chỉ dẫn mà nhân viên làm theo khi kỹ năng đã được nạp. Kỹ năng không cần mã, và mọi nhân viên trên một bot đều có thể dùng.

Kỹ năng là gì

Kỹ năng là một thư mục có tên trùng với name của kỹ năng. Thư mục chứa một tệp SKILL.md và, nếu cần, bất kỳ tệp nào khác mà chỉ dẫn nhắc tới: tài liệu tham khảo, mẫu hoặc script.

SKILL.md có hai phần. Phần frontmatter YAML nằm giữa các dòng --- chứa tên và mô tả. Phần thân Markdown phía sau chứa các chỉ dẫn.

Cách nhân viên dùng kỹ năng

Nhân viên làm việc với một kỹ năng qua ba bước.

  1. Chọn. Ở mỗi lượt, nhân viên thấy danh sách các kỹ năng có sẵn cho mình: tên, mô tả và tối đa ba trình kích hoạt của mỗi kỹ năng. Mô tả là thứ nhân viên đọc để quyết định, nên hãy viết nó để nói kỹ năng làm gì và khi nào nên dùng.
  2. Nạp. Nhân viên gọi công cụ use_skill với tên kỹ năng. Công cụ trả về các chỉ dẫn, đường dẫn tới thư mục của kỹ năng và tên các tệp của nó. Đây là cách duy nhất để nhân viên đọc một kỹ năng.
  3. Làm việc. Nhân viên làm theo các chỉ dẫn. Nhân viên đọc các tệp hỗ trợ bằng read_skill_file và chạy các script đi kèm bằng execute.

Trình kích hoạt không bao giờ tự nạp một kỹ năng. Nhân viên luôn là người quyết định. Khi danh sách dài ra, nhân viên có thể tìm kiếm trong đó bằng find_skills.

Viết kỹ năng đầu tiên của bạn

Tạo một thư mục đặt tên theo kỹ năng, chứa một tệp.

meeting-notes/
└── SKILL.md
---
name: meeting-notes
description: Turn a meeting transcript into decisions, action items with owners, and open questions. Use when someone shares meeting notes or a transcript.
---

# Meeting notes

1. List the decisions that were made.
2. List action items as "owner — task — due date".
3. List open questions that need a follow-up.

Keep each list short. If the transcript names no owner for an item, write "unassigned".

Đặt thư mục vào thư mục kỹ năng của người dùng trên một bot (xem Nơi lưu kỹ năng). Nebo nhận ra thư mục mới trong khoảng một giây, và mọi nhân viên trên bot đó đều có thể dùng kỹ năng.

Nhân viên cũng có thể viết kỹ năng giúp bạn. Hãy yêu cầu nhân viên lưu một kỹ năng, nhân viên sẽ gọi save_skill để ghi thư mục vào chính thư mục kỹ năng của người dùng đó.

Các quy tắc trình nạp áp dụng

Kỹ năng vi phạm một trong các quy tắc này sẽ không được nạp. Nebo ghi cảnh báo vào nhật ký và bỏ qua nó.

Quy tắcChi tiết
Tệp bắt đầu bằng ---Frontmatter phải là phần đầu tiên của tệp. Tệp phải được mã hóa UTF-8.
name là bắt buộcChỉ gồm chữ thường, chữ số và dấu gạch nối; không có dấu gạch nối ở đầu hoặc cuối; không có hai dấu gạch nối liền nhau; tối đa 64 byte.
description là bắt buộcTối đa 1.024 byte.
Các trường đúng kiểuMột trường sai kiểu YAML sẽ làm hỏng toàn bộ tệp. Đặt phiên bản trong dấu ngoặc kép, chẳng hạn "1.0.0".
platform khớpNếu có, kỹ năng chỉ được nạp trên các hệ điều hành được liệt kê.

Các khóa frontmatter mà Nebo không nhận diện được sẽ bị bỏ qua. Phần thân không giới hạn kích thước, nhưng chỉ dẫn càng ngắn thì càng chừa nhiều chỗ cho công việc. Hãy chuyển tài liệu dài vào các tệp mà nhân viên đọc khi cần.

Thêm tệp

Mọi tệp trong thư mục ngoài SKILL.md và các tệp ẩn đều có sẵn cho nhân viên. Bạn tự chọn tên thư mục; Nebo không gán ý nghĩa đặc biệt nào cho references/ hay assets/. Các tệp trong scripts/ hoặc bin/ có thể được chạy.

invoice-check/
├── SKILL.md              # required
├── references/
│   └── policy.md         # read with read_skill_file
└── scripts/
    └── totals.py         # run with execute

Nhắc tới tệp bằng đường dẫn bên trong thư mục, chẳng hạn references/policy.md. Nhân viên đọc chúng bằng read_skill_file, công cụ này từ chối mọi đường dẫn đi ra ngoài thư mục. Script chạy bằng công cụ execute trong môi trường hộp cát. Tài liệu tham khảo SKILL.md trình bày về môi trường chạy, biến môi trường, thông tin bí mật và quyền truy cập mạng.

Nơi lưu kỹ năng

Một bot thu thập kỹ năng từ nhiều nơi. Khi hai nguồn cung cấp kỹ năng cùng tên, nguồn đứng sau trong danh sách này được ưu tiên.

NguồnVị tríAi có thể dùng
Tích hợp sẵnĐược biên dịch sẵn trong NeboMọi nhân viên
Chợ ứng dụng<data>/nebo/skills/<slug>/<version>/Mọi nhân viên
PluginThư mục skills/ của một plugin đã càiMọi nhân viên
Người dùng<data>/user/skills/<name>/Mọi nhân viên
Gói nhân viênskills/ bên trong một gói nhân viên đã càiChỉ nhân viên đó
Đã học<data>/learned/skills/<employee>/<name>/Chỉ nhân viên đó

<data> là ~/Library/Application Support/Nebo trên macOS, %APPDATA%\Nebo trên Windows và ~/.local/share/nebo trên Linux. Biến môi trường NEBO_HOME sẽ ghi đè giá trị này. Khi một nhân viên có kỹ năng riêng và một kỹ năng dùng chung trùng tên, kỹ năng riêng được ưu tiên.

Nebo theo dõi các thư mục này và nạp lại kỹ năng đã thay đổi sau một giây. Để tắt một kỹ năng mà không xóa, hãy đổi tên tệp của nó thành SKILL.md.disabled.

Kỹ năng mô tả công việc, không phải công cụ. Hãy viết kỹ năng xoay quanh một trách nhiệm, chẳng hạn đối chiếu biên lai, và để nhân viên dùng bất kỳ kết nối nào chủ sở hữu đã cung cấp. Khi một kỹ năng thực sự cần một plugin, hãy khai báo nó bằng trường plugins.

Tiếp theo