สอนผู้ช่วยให้ทำงานด้วยทักษะ

เขียนวิธีทำงานเป็นทักษะ หรือนำเข้าแพ็กทักษะจาก GitHub แล้วแนบให้ผู้ช่วย ซึ่งจะทำตามทักษะทุกครั้งที่ตอบ

ทักษะคืออะไร#

ทักษะคือความรู้เชิงปฏิบัติที่นำกลับมาใช้ซ้ำได้ เช่น "ขั้นตอนรับมือเรื่องร้องเรียน" หรือ "รูปแบบใบเสนอราคา" ผู้ช่วยที่มีทักษะแนบอยู่จะถือว่ามันเป็นคำสั่งประจำในทุกคำตอบ

ทักษะต่างจากคลังความรู้อย่างไร

• ความรู้ คือข้อมูล ผู้ช่วยค้นคืนจากข้อมูลตามคำถาม และใช้เฉพาะส่วนที่เกี่ยวข้อง
• ทักษะ คือวิธีทำงาน ทักษะที่แนบไว้ทุกรายการจะถูกใส่ทั้งหมดในทุกคำตอบ โดยไม่ผ่านการค้นคืน

เปิด ทักษะ ในคอนโซล คลังทักษะ แสดงทักษะที่แชร์ในเวิร์กสเปซและทักษะของคุณเอง ส่วน แพ็กทักษะ ใช้นำเข้าทักษะจาก GitHub

ใครทำอะไรได้#

สร้างทักษะ#

1. เปิด ทักษะ แล้วเลื่อนไปที่ สร้างทักษะ
2. กรอก ชื่อ
3. กรอก คำอธิบาย (ไม่บังคับ) ได้ถ้าต้องการ เพื่อบอกว่าทักษะนี้ใช้เมื่อไร
4. กรอก เนื้อหาคำสั่ง คือขั้นตอนทีละขั้นที่ผู้ช่วยทำตามเมื่อใช้ทักษะนี้
5. ตัดสินใจว่าจะเปิด เก็บไว้ใช้เอง หรือไม่ (ดูทักษะที่ใช้เฉพาะคุณ)
6. เลือก สร้าง

ทักษะจะแสดงในตาราง คลังทักษะ พร้อม ชื่อ และ คำอธิบาย

ทักษะที่ใช้เฉพาะคุณ#

เปิด เก็บไว้ใช้เอง ตอนสร้างทักษะ แล้วจะมีแค่คุณที่เห็น และทักษะจะไม่ถูกเพิ่มในคลังของเวิร์กสเปซ ทักษะเหล่านี้แสดงใต้ ทักษะของฉัน ในตาราง คลังทักษะ พร้อมป้าย เฉพาะคุณ

• สมาชิกที่ไม่ใช่เจ้าของหรือผู้ดูแลเขียนทักษะได้เฉพาะสำหรับตัวเอง สวิตช์นี้จึงเปิดค้างไว้สำหรับพวกเขา การเพิ่มทักษะในคลังของเวิร์กสเปซต้องใช้เจ้าของหรือผู้ดูแลเวิร์กสเปซ
• ทักษะของคุณเองแนบได้เฉพาะกับผู้ช่วยส่วนตัวของคุณ ใต้ การตั้งค่าอื่น ๆ ในหน้าของผู้ช่วยส่วนตัว
• ผู้ช่วยส่วนตัวที่แนบทักษะส่วนตัวของคุณไว้จะแชร์ไม่ได้ ให้ถอดทักษะออก หรือขอให้ผู้ดูแลเพิ่มทักษะนั้นในคลังของเวิร์กสเปซ แล้วแชร์อีกครั้ง
• คุณแก้ไข ลบ และกู้คืนทักษะของตัวเองได้โดยไม่ต้องมีสิทธิ์ผู้ดูแล

นำเข้าแพ็กทักษะจาก GitHub#

ถ้าทีมของคุณเก็บทักษะไว้บน GitHub อยู่แล้ว ให้นำเข้าทั้ง repository แล้วซิงก์ภายหลัง

1. ในส่วน แพ็กทักษะ ของหน้า ทักษะ กรอก URL ของรีโพซิทอรี เช่น https://github.com/your-org/skills
2. กรอก Branch หรือ tag ได้ถ้าต้องการ ถ้าเว้นว่างจะใช้ main
3. เลือก นำเข้าแพ็ก

จากนั้นหน้าจะรายงานผล: "เพิ่ม N อัปเดต N ข้าม N เก็บในเครื่อง N ผิดรูปแบบ N ไฟล์แนบที่ไม่นำเข้า N"

รูปแบบของ repository

แต่ละโฟลเดอร์ใน repository ที่มี SKILL.md คือหนึ่งทักษะ

---
name: Returns
description: Use when a customer asks to return an order
---

1. Confirm the order number and purchase date.
2. For orders older than 7 days, explain the return window and give the support email.

• name จำเป็นต้องมี และจะเป็นชื่อของทักษะ ส่วน description ไม่บังคับ
• ไฟล์ต้องขึ้นต้นด้วย --- และบล็อกต้องปิดด้วย --- อีกบรรทัด
• ทุกอย่างหลัง --- ตัวปิดคือเนื้อหาคำสั่ง และเว้นว่างไม่ได้
• ไฟล์อื่นในโฟลเดอร์เดียวกับ SKILL.md จะไม่ถูกนำเข้า และนับเป็น "ไฟล์แนบที่ไม่นำเข้า"
• SKILL.md ที่ไม่ตรงรูปแบบนี้ หรือยาวเกินขีดจำกัด จะไม่ถูกนำเข้าและนับเป็นผิดรูปแบบ

กฎการนำเข้าและซิงก์

• รองรับเฉพาะ repository สาธารณะบน github.com
• ถ้าคลังมีทักษะชื่อเดียวกันอยู่แล้ว (ไม่สนตัวพิมพ์เล็กใหญ่) ทักษะนั้นจะถูกข้าม ไม่ถูกเขียนทับ
• ทักษะที่นำเข้าจะเข้าไปอยู่ในคลังของเวิร์กสเปซ และนับรวมใน 50 รายการของคลัง
• แต่ละแพ็กแสดง URL, branch หรือ tag และ commit ที่ซิงก์ล่าสุด ซิงก์ จะดึงเนื้อหาล่าสุดของ repository - ทักษะที่เปลี่ยนต้นทางและคุณยังไม่ได้แก้จะถูกอัปเดต ถ้อยคำเดิมยังอยู่ในประวัติ - ทักษะที่คุณแก้ใน Agent Lab จะคงเวอร์ชันของคุณไว้ และนับเป็น "เก็บในเครื่อง" - ทักษะที่ถูกลบจากต้นทางจะยังอยู่ในคลัง ไม่ถูกลบอัตโนมัติ
• ตัว repository จำกัดที่ 5,000 ไฟล์ รวม 32 MB และไฟล์ละ 4 MB ถ้าเกินข้อใดข้อหนึ่งจะไม่นำเข้าเลย

แนบให้ผู้ช่วย#

1. เปิดหน้าของผู้ช่วยแล้วหาส่วน ทักษะ
2. เลือกทักษะใต้ เลือกทักษะ แล้วเลือก ติดตั้ง
3. ถ้าต้องการถอดออก เลือก × บนป้ายของทักษะ

ผู้ช่วยหนึ่งตัวมีทักษะได้สูงสุด 20 รายการ ถ้าคลังยังไม่มีทักษะ ส่วนนี้จะพาคุณไปที่หน้า ทักษะ ก่อน ส่วนการตั้งค่าอื่นของผู้ช่วย ดูผู้ช่วย

ผู้ช่วยใช้ทักษะอย่างไร#

ทุกครั้งที่ตอบ ผู้ช่วยจะต่อทักษะที่แนบไว้ตามลำดับที่แนบ ไว้หลังคำสั่งการทำงานของตัวเองและก่อนความรู้ที่ค้นคืนมา ทักษะไม่เปลี่ยนตามคนที่ถาม

ทักษะที่แนบไว้ทั้งหมดรวมกันมีขีดจำกัดความยาวประมาณ 6,000 ไบต์ (ราว 6,000 ตัวอักษรภาษาอังกฤษ หรือราว 2,000 ตัวอักษรภาษาจีน) เมื่อทักษะถัดไปจะทำให้เกินขีดจำกัด ทักษะนั้นและทุกทักษะหลังจากนั้นจะถูกตัดออก และคอนโซลจะไม่เตือน ถ้าผู้ช่วยมีทักษะจำนวนมากหรือทักษะที่ยาว ให้แนบทักษะที่สำคัญที่สุดก่อน และเขียนแต่ละทักษะให้สั้น

แก้ไขและประวัติ#

• แก้ไข: เลือก แก้ไข ในแถวของทักษะ แก้ แล้วเลือก บันทึกการแก้ไข ตัวแก้ไขจะแสดง เวอร์ชัน N ปัจจุบัน ผู้ช่วยทุกตัวที่แนบทักษะนี้จะใช้ถ้อยคำใหม่ทันที
• แก้ไขพร้อมกัน: ถ้ามีคนอื่นเปลี่ยนทักษะระหว่างที่คุณกำลังแก้ การบันทึกของคุณจะถูกปฏิเสธ ทักษะจะโหลดใหม่ และระบบจะขอให้คุณอ่านเนื้อหาปัจจุบันก่อนบันทึกอีกครั้ง
• ประวัติ: เลือก ประวัติ เพื่อดู เนื้อหาเดิมของ "…" พร้อมเวลาและผู้เขียนของแต่ละเวอร์ชัน เวอร์ชันที่ใช้อยู่จะมีป้าย ใช้งานอยู่ตอนนี้ ถ้าต้องการกลับไปใช้เวอร์ชันใด เลือก กลับไปใช้เนื้อหานี้

ลบทักษะ#

เลือก ลบ ในแถวของทักษะ หน้าต่างจะแสดงผู้ช่วยที่ใช้ทักษะนี้และเตือนว่าคำตอบของพวกมันจะเปลี่ยน เลือก ลบต่อไป เพื่อยืนยัน หรือ เก็บไว้ เพื่อยกเลิก

การลบจะถอดทักษะออกจากผู้ช่วยทุกตัว การแนบ การถอด และการลบทักษะจะถูกบันทึกในบันทึกการตรวจสอบใต้ ทีมและการเข้าถึง

ขีดจำกัด#

ชื่อ คำอธิบาย และเนื้อหาคำสั่งนับเป็นตัวอักษร ตัวอักษรจีนหนึ่งตัวจึงนับเป็นหนึ่ง เท่ากับตัวอักษรภาษาอังกฤษ แต่ขีดจำกัดรวมของทักษะที่แนบในหนึ่งคำตอบต่างออกไป เพราะนับเป็นไบต์ และตัวอักษรจีนใช้สามไบต์ ทักษะภาษาจีนจึงถึงขีดจำกัดที่ราว 2,000 ตัวอักษร ถ้าชื่อ คำอธิบาย หรือเนื้อหาคำสั่งยาวเกิน การสร้างจะแสดง "สร้างทักษะไม่ได้ ตรวจสอบชื่อและคำแนะนำ" และการบันทึกการแก้ไขจะแสดง "บันทึกสกิลไม่สำเร็จ โปรดลองอีกครั้ง"

ขั้นต่อไป#