NeboAI
NeboAI
Başlayın

Beceriler

Bir beceri, bir çalışana bir tür işi iyi yapmayı öğretir. Onu bir SKILL.md dosyası içeren bir klasör olarak yazarsınız: çalışanın beceriyi seçmek için kullandığı kısa bir açıklama ve beceri yüklendikten sonra izlediği talimatlar. Beceriler kod gerektirmez ve bir bottaki her çalışan onları kullanabilir.

Beceri nedir

Beceri, adı becerinin name değeriyle eşleşen bir klasördür. Klasörde bir SKILL.md dosyası ve isteğe bağlı olarak talimatların atıfta bulunduğu diğer dosyalar bulunur: başvuru belgeleri, şablonlar veya betikler.

SKILL.md iki bölümden oluşur. --- satırları arasındaki YAML ön bilgisi adı ve açıklamayı taşır. Ardından gelen Markdown gövdesi talimatları taşır.

Çalışanlar becerileri nasıl kullanır

Bir çalışan bir beceriyle üç adımda çalışır.

  1. Seçer. Her turda çalışan, kullanabileceği becerilerin bir listesini görür: her becerinin adı, açıklaması ve en fazla üç tetikleyicisi. Çalışanın karar vermek için okuduğu şey açıklamadır; bu yüzden onu becerinin ne yaptığını ve ne zaman kullanılacağını söyleyecek şekilde yazın.
  2. Yükler. Çalışan, becerinin adıyla use_skill aracını çağırır. Araç talimatları, becerinin klasörünün yolunu ve dosyalarının adlarını döndürür. Bir çalışanın bir beceriyi okumasının tek yolu budur.
  3. Çalışır. Çalışan talimatları izler. Destekleyici dosyaları read_skill_file ile okur ve paketlenmiş betikleri execute ile çalıştırır.

Tetikleyiciler bir beceriyi asla kendi başlarına yüklemez. Seçimi her zaman çalışan yapar. Liste uzadığında çalışan onu find_skills ile arayabilir.

İlk becerinizi yazın

Becerinin adını taşıyan ve içinde tek bir dosya bulunan bir klasör oluşturun.

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

Klasörü bir botun kullanıcı becerileri dizinine koyun (bkz. Beceriler nerede bulunur). Nebo yeni klasörü yaklaşık bir saniye içinde fark eder ve o bottaki her çalışan beceriyi kullanabilir.

Bir çalışan sizin için de bir beceri yazabilir. Ondan bir tane kaydetmesini isteyin; save_skill aracını çağırır ve klasörü aynı kullanıcı becerileri dizinine yazar.

Yükleyicinin uyguladığı kurallar

Bu kurallardan birini çiğneyen bir beceri yüklenmez. Nebo bir uyarı kaydeder ve onu atlar.

KuralAyrıntı
Dosya --- ile başlarÖn bilgi dosyadaki ilk şey olmalıdır. Dosya UTF-8 olmalıdır.
name zorunludurYalnızca küçük harfler, rakamlar ve kısa çizgiler; başta veya sonda kısa çizgi yok; art arda iki kısa çizgi yok; en fazla 64 bayt.
description zorunludurEn fazla 1.024 bayt.
Alanlar doğru türdedirYAML türü yanlış olan bir alan tüm dosyayı geçersiz kılar. Sürümleri "1.0.0" gibi tırnak içine alın.
platform eşleşirVarsa, beceri yalnızca listelenen işletim sistemlerinde yüklenir.

Nebo’nun tanımadığı ön bilgi anahtarları yok sayılır. Gövdenin boyut sınırı yoktur, ancak daha kısa talimatlar işe daha fazla yer bırakır. Uzun içeriği, çalışanın ihtiyaç duyduğunda okuyacağı dosyalara taşıyın.

Dosya ekleyin

Klasördeki SKILL.md ve nokta ile başlayan dosyalar dışındaki her dosya çalışanın kullanımına açıktır. Klasör adlarını siz seçersiniz; Nebo references/ veya assets/ klasörlerine özel bir anlam yüklemez. scripts/ veya bin/ altındaki dosyalar çalıştırılabilir.

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

Dosyalara klasör içindeki yollarıyla atıfta bulunun, örneğin references/policy.md. Çalışan onları, klasörün dışına çıkan her yolu reddeden read_skill_file ile okur. Betikler execute aracıyla bir korumalı alanda çalışır. Çalışma zamanları, ortam değişkenleri, gizli bilgiler ve ağ erişimi SKILL.md başvurusu sayfasında anlatılır.

Beceriler nerede bulunur

Bir bot becerileri birkaç yerden toplar. İki kaynak aynı adda bir beceri sağladığında bu listede daha sonra gelen kaynak önceliklidir.

KaynakKonumKim kullanabilir
YerleşikNebo’ya derlenmişHer çalışan
Pazar yeri<data>/nebo/skills/<slug>/<version>/Her çalışan
EklentiKurulu bir eklentinin skills/ klasörüHer çalışan
Kullanıcı<data>/user/skills/<name>/Her çalışan
Çalışan paketiKurulu bir çalışan paketinin içindeki skills/Yalnızca o çalışan
Öğrenilmiş<data>/learned/skills/<employee>/<name>/Yalnızca o çalışan

<data>, macOS’ta ~/Library/Application Support/Nebo, Windows’ta %APPDATA%\Nebo, Linux’ta ~/.local/share/nebo olur. NEBO_HOME ortam değişkeni bunu geçersiz kılar. Bir çalışanın kendi becerisi ile aynı adda ortak bir beceri olduğunda, kendi becerisi önceliklidir.

Nebo bu klasörleri izler ve değişen bir beceriyi bir saniye sonra yeniden yükler. Bir beceriyi silmeden kapatmak için dosyasının adını SKILL.md.disabled olarak değiştirin.

Beceriler araçları değil, işi anlatır. Bir beceriyi makbuzların mutabakatı gibi bir sorumluluk etrafında yazın ve çalışanın, sahibin sağladığı bağlantı hangisiyse onu kullanmasına izin verin. Bir beceri gerçekten bir eklentiye ihtiyaç duyduğunda bunu plugins alanıyla bildirin.

Sonraki adımlar