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 เป็นฟิลด์ที่จำเป็นตัวอักษรพิมพ์เล็ก ตัวเลข และขีดกลางเท่านั้น ห้ามขึ้นต้นหรือลงท้ายด้วยขีดกลาง ห้ามมีขีดกลางซ้อนกัน ไม่เกิน 64 ไบต์
description เป็นฟิลด์ที่จำเป็นไม่เกิน 1,024 ไบต์
ฟิลด์มีชนิดถูกต้องฟิลด์ที่มีชนิด 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> คือ ~/Library/Application Support/Nebo บน macOS, %APPDATA%\Nebo บน Windows และ ~/.local/share/nebo บน Linux ตัวแปรสภาพแวดล้อม NEBO_HOME ใช้แทนค่านี้ได้ เมื่อพนักงานมีทักษะของตัวเองและทักษะที่ใช้ร่วมกันซึ่งมีชื่อเดียวกัน ทักษะของตัวเองจะมีผลเหนือกว่า

Nebo เฝ้าดูโฟลเดอร์เหล่านี้และโหลดทักษะที่เปลี่ยนแปลงใหม่หลังจากหนึ่งวินาที หากต้องการปิดทักษะโดยไม่ลบ ให้เปลี่ยนชื่อไฟล์เป็น SKILL.md.disabled

ทักษะอธิบายงาน ไม่ใช่เครื่องมือ เขียนทักษะโดยยึดหน้าที่ความรับผิดชอบ เช่น การกระทบยอดใบเสร็จ แล้วให้พนักงานใช้การเชื่อมต่อใดก็ได้ที่เจ้าของจัดไว้ให้ เมื่อทักษะจำเป็นต้องใช้ปลั๊กอินจริง ๆ ให้ประกาศด้วยฟิลด์ plugins

ถัดไป