NeboAI
NeboAI
شروع کنید

مهارت‌ها

یک مهارت به کارمند یاد می‌دهد که یک نوع کار را چطور خوب انجام دهد. آن را به‌صورت یک پوشه با یک فایل SKILL.md می‌نویسید: توضیحی کوتاه که کارمند برای انتخاب مهارت از آن استفاده می‌کند، و دستورالعمل‌هایی که پس از بارگذاری مهارت دنبال می‌کند. مهارت‌ها به کد نیازی ندارند و همه کارمندان یک ربات می‌توانند از آن‌ها استفاده کنند.

مهارت چیست

یک مهارت پوشه‌ای است که نامش با name مهارت یکی است. این پوشه یک فایل SKILL.md و در صورت تمایل هر فایل دیگری را که دستورالعمل‌ها به آن اشاره می‌کنند در خود دارد: اسناد مرجع، الگوها یا اسکریپت‌ها.

SKILL.md دو بخش دارد. پیش‌متن YAML میان خطوط --- نام و توضیح را در خود دارد. بدنه Markdown پس از آن دستورالعمل‌ها را در خود دارد.

کارمندان چگونه از مهارت‌ها استفاده می‌کنند

کارمند در سه گام با یک مهارت کار می‌کند.

  1. انتخاب. در هر نوبت، کارمند فهرستی از مهارت‌های در دسترسش را می‌بیند: نام هر مهارت، توضیح آن و حداکثر سه تریگر آن. توضیح همان چیزی است که کارمند برای تصمیم‌گیری می‌خواند، پس آن را طوری بنویسید که بگوید مهارت چه می‌کند و کی باید از آن استفاده کرد.
  2. بارگذاری. کارمند ابزار use_skill را با نام مهارت فراخوانی می‌کند. این ابزار دستورالعمل‌ها، مسیر پوشه مهارت و نام فایل‌هایش را برمی‌گرداند. این تنها راهی است که کارمند یک مهارت را می‌خواند.
  3. کار. کارمند دستورالعمل‌ها را دنبال می‌کند. فایل‌های پشتیبان را با read_skill_file می‌خواند و اسکریپت‌های همراه را با execute اجرا می‌کند.

تریگرها هرگز به‌تنهایی مهارتی را بارگذاری نمی‌کنند. انتخاب همیشه با کارمند است. وقتی فهرست طولانی می‌شود، کارمند می‌تواند با find_skills در آن جستجو کند.

نخستین مهارت خود را بنویسید

پوشه‌ای به نام مهارت بسازید، با یک فایل در آن.

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

پوشه را در پوشه مهارت‌های کاربر یک ربات قرار دهید (مهارت‌ها کجا قرار دارند را ببینید). Nebo ظرف حدود یک ثانیه متوجه پوشه جدید می‌شود و همه کارمندان آن ربات می‌توانند از مهارت استفاده کنند.

یک کارمند هم می‌تواند برایتان مهارت بنویسد. از او بخواهید یکی ذخیره کند، و او save_skill را فراخوانی می‌کند که پوشه را در همان پوشه مهارت‌های کاربر می‌نویسد.

قواعدی که بارگذار اعمال می‌کند

مهارتی که یکی از این قواعد را نقض کند بارگذاری نمی‌شود. Nebo یک هشدار ثبت می‌کند و از آن می‌گذرد.

قاعدهجزئیات
فایل با --- شروع می‌شودپیش‌متن باید نخستین چیز در فایل باشد. فایل باید UTF-8 باشد.
name الزامی استفقط حروف کوچک، ارقام و خط تیره؛ بدون خط تیره در ابتدا یا انتها؛ بدون خط تیره دوتایی؛ حداکثر ۶۴ بایت.
description الزامی استحداکثر ۱٬۰۲۴ بایت.
فیلدها نوع درست دارندفیلدی با نوع YAML نادرست کل فایل را ناموفق می‌کند. نسخه‌ها را داخل نقل‌قول بگذارید، مانند "1.0.0".
platform تطبیق دارداگر وجود داشته باشد، مهارت فقط روی سیستم‌عامل‌های فهرست‌شده بارگذاری می‌شود.

کلیدهای پیش‌متن که Nebo نمی‌شناسد نادیده گرفته می‌شوند. بدنه محدودیت اندازه ندارد، اما دستورالعمل‌های کوتاه‌تر جای بیشتری برای کار باقی می‌گذارند. مطالب طولانی را به فایل‌هایی منتقل کنید که کارمند هر وقت لازم داشت بخواند.

افزودن فایل‌ها

هر فایلی در پوشه به جز SKILL.md و فایل‌های نقطه‌دار در دسترس کارمند است. انتخاب نام پوشه‌ها با شماست؛ Nebo معنای خاصی به references/ یا assets/ نمی‌دهد. فایل‌های زیر scripts/ یا bin/ را می‌توان اجرا کرد.

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

با مسیر فایل‌ها درون پوشه به آن‌ها اشاره کنید، مانند references/policy.md. کارمند آن‌ها را با read_skill_file می‌خواند که هر مسیری را که از پوشه بیرون برود رد می‌کند. اسکریپت‌ها با ابزار execute در یک محیط ایزوله اجرا می‌شوند. مرجع SKILL.md محیط‌های اجرا، متغیرهای محیطی، اسرار و دسترسی به شبکه را پوشش می‌دهد.

مهارت‌ها کجا قرار دارند

یک ربات مهارت‌ها را از چند جا جمع می‌کند. وقتی دو منبع مهارتی با نام یکسان ارائه دهند، منبعی که در این فهرست بعدتر آمده اولویت دارد.

منبعمکانچه کسی می‌تواند استفاده کند
داخلیکامپایل‌شده درون Neboهمه کارمندان
فروشگاه<data>/nebo/skills/<slug>/<version>/همه کارمندان
افزونهپوشه skills/ یک افزونه نصب‌شدههمه کارمندان
کاربر<data>/user/skills/<name>/همه کارمندان
بسته کارمندskills/ درون بسته یک کارمند نصب‌شدهفقط همان کارمند
آموخته‌شده<data>/learned/skills/<employee>/<name>/فقط همان کارمند

<data> در macOS برابر ~/Library/Application Support/Nebo، در Windows برابر %APPDATA%\Nebo و در Linux برابر ~/.local/share/nebo است. متغیر محیطی NEBO_HOME بر آن اولویت دارد. وقتی کارمندی مهارت خودش و یک مهارت مشترک با نام یکسان داشته باشد، مهارت خودش اولویت دارد.

Nebo این پوشه‌ها را زیر نظر دارد و مهارت تغییریافته را پس از یک ثانیه دوباره بارگذاری می‌کند. برای خاموش کردن یک مهارت بدون حذف آن، نام فایلش را به SKILL.md.disabled تغییر دهید.

مهارت‌ها کار را توصیف می‌کنند، نه ابزارها را. مهارت را حول یک مسئولیت بنویسید، مانند تطبیق رسیدها، و بگذارید کارمند از هر اتصالی که مالک فراهم کرده استفاده کند. وقتی مهارتی واقعاً به یک افزونه نیاز دارد، آن را با فیلد plugins اعلام کنید.

بعدی