NeboAI
NeboAI
Mulai

Skill

Skill mengajari karyawan cara mengerjakan satu jenis pekerjaan dengan baik. Anda menulisnya sebagai folder berisi file SKILL.md: deskripsi singkat yang digunakan karyawan untuk memilih skill, dan instruksi yang diikutinya setelah skill dimuat. Skill tidak memerlukan kode, dan setiap karyawan di sebuah bot dapat menggunakannya.

Apa itu skill

Skill adalah folder yang namanya sama dengan name skill. Folder itu berisi file SKILL.md dan, secara opsional, file lain yang dirujuk instruksinya: dokumen referensi, templat, atau skrip.

SKILL.md memiliki dua bagian. Frontmatter YAML di antara baris --- memuat nama dan deskripsi. Isi Markdown setelahnya memuat instruksi.

Cara karyawan menggunakan skill

Karyawan bekerja dengan skill dalam tiga langkah.

  1. Pilih. Setiap giliran, karyawan melihat daftar skill yang tersedia baginya: nama setiap skill, deskripsinya, dan hingga tiga pemicunya. Deskripsi adalah yang dibaca karyawan untuk memutuskan, jadi tulislah untuk menjelaskan apa fungsi skill dan kapan menggunakannya.
  2. Muat. Karyawan memanggil alat use_skill dengan nama skill. Alat itu mengembalikan instruksi, path folder skill, dan nama file-filenya. Inilah satu-satunya cara karyawan membaca skill.
  3. Kerjakan. Karyawan mengikuti instruksi. Ia membaca file pendukung dengan read_skill_file dan menjalankan skrip bawaan dengan execute.

Pemicu tidak pernah memuat skill dengan sendirinya. Karyawan selalu yang menentukan pilihan. Saat daftarnya panjang, karyawan dapat mencarinya dengan find_skills.

Tulis skill pertama Anda

Buat folder yang dinamai sesuai skill, dengan satu file di dalamnya.

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".

Letakkan folder itu di direktori skill pengguna sebuah bot (lihat Tempat skill disimpan). Nebo mendeteksi folder baru dalam sekitar satu detik, dan setiap karyawan di bot tersebut dapat menggunakan skill itu.

Karyawan juga dapat menulis skill untuk Anda. Minta ia menyimpannya, dan ia memanggil save_skill, yang menulis folder ke direktori skill pengguna yang sama.

Aturan yang diberlakukan pemuat

Skill yang melanggar salah satu aturan ini tidak dimuat. Nebo mencatat peringatan dan melewatinya.

AturanDetail
File diawali ---Frontmatter harus menjadi hal pertama di file. File harus berformat UTF-8.
name wajibHanya huruf kecil, angka, dan tanda hubung; tanpa tanda hubung di awal atau akhir; tanpa tanda hubung ganda; paling banyak 64 byte.
description wajibPaling banyak 1.024 byte.
Kolom memiliki tipe yang benarKolom dengan tipe YAML yang salah menggagalkan seluruh file. Beri tanda kutip pada versi, seperti "1.0.0".
platform cocokJika ada, skill hanya dimuat di sistem operasi yang tercantum.

Kunci frontmatter yang tidak dikenali Nebo diabaikan. Isi tidak memiliki batas ukuran, tetapi instruksi yang lebih singkat menyisakan lebih banyak ruang untuk pekerjaan. Pindahkan materi panjang ke file yang dibaca karyawan saat membutuhkannya.

Tambahkan file

File apa pun di folder selain SKILL.md dan dotfile tersedia bagi karyawan. Nama folder bebas Anda tentukan; Nebo tidak memberi arti khusus pada references/ atau assets/. File di bawah scripts/ atau bin/ dapat dijalankan.

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

Rujuk file berdasarkan path-nya di dalam folder, seperti references/policy.md. Karyawan membacanya dengan read_skill_file, yang menolak path apa pun yang keluar dari folder. Skrip berjalan dengan alat execute di dalam sandbox. Referensi SKILL.md membahas runtime, variabel lingkungan, rahasia, dan akses jaringan.

Tempat skill disimpan

Bot mengumpulkan skill dari beberapa tempat. Jika dua sumber menyediakan skill dengan nama yang sama, sumber yang lebih akhir di daftar ini yang berlaku.

SumberLokasiSiapa yang dapat menggunakannya
BawaanDikompilasi ke dalam NeboSetiap karyawan
Marketplace<data>/nebo/skills/<slug>/<version>/Setiap karyawan
PluginFolder skills/ dari plugin yang terinstalSetiap karyawan
Pengguna<data>/user/skills/<name>/Setiap karyawan
Paket karyawanskills/ di dalam paket karyawan yang terinstalHanya karyawan itu
Dipelajari<data>/learned/skills/<employee>/<name>/Hanya karyawan itu

<data> adalah ~/Library/Application Support/Nebo di macOS, %APPDATA%\Nebo di Windows, dan ~/.local/share/nebo di Linux. Variabel lingkungan NEBO_HOME menggantikannya. Jika karyawan memiliki skill sendiri dan skill bersama dengan nama yang sama, skill miliknya sendiri yang berlaku.

Nebo memantau folder-folder ini dan memuat ulang skill yang berubah setelah satu detik. Untuk menonaktifkan skill tanpa menghapusnya, ganti nama file-nya menjadi SKILL.md.disabled.

Skill menjelaskan pekerjaan, bukan alat. Tulis skill berdasarkan suatu tanggung jawab, seperti merekonsiliasi tanda terima, dan biarkan karyawan menggunakan koneksi apa pun yang disediakan pemilik. Jika skill benar-benar membutuhkan plugin, nyatakan dengan kolom plugins.

Berikutnya