PerchAI
การใช้ Perch

คำสั่งสแลช

วิธีใช้คำสั่งสแลชแต่ละคำสั่งใน Perch Terminal และ CLI ในการทำงานจริง สิ่งที่คุณจะได้กลับมา และเมื่อไรควรใช้คำสั่งแทนการถามตามปกติ

คำสั่งสแลชคือคำสั่งที่สั่ง Perch โดยตรง ไม่ใช่งานที่ส่งให้โมเดล พิมพ์ / ที่ช่องพรอมต์แล้วรายการคำสั่งจะปรากฏขึ้น คำสั่งส่วนใหญ่เป็นตัวควบคุมเซสชันแบบรวดเร็ว แต่มีห้าคำสั่งที่ทำงานจริง ได้แก่ /goal ทำงานอย่างอิสระต่อเนื่องหลายเทิร์น /verify ตรวจคำตอบซ้ำกับแหล่งที่มาของคุณ /deepresearch ค้นคว้าคำถามหลายรอบแล้วส่งรายงานพร้อมการอ้างอิงกลับมา /delegate ส่งงานให้เอเจนต์เบื้องหลัง และ /flock รันทีมเวิร์กเกอร์

หน้านี้อธิบายว่าควรใช้แต่ละคำสั่งเมื่อไร และเกิดอะไรขึ้นเมื่อคุณใช้ ส่วนรายการแบบกระชับของทุกคำสั่งและทุก flag ดูได้ที่คู่มืออ้างอิง CLI

ใช้ได้ที่ไหน

คำสั่งสแลชใช้ได้ใน Perch Terminal (แอปเดสก์ท็อปและ app.perchai.app) และใน CLI เว็บแชตไม่มีคำสั่งเหล่านี้ บางคำสั่งใช้ได้เฉพาะบนแพลตฟอร์มเดียว ตามที่ระบุไว้ด้านล่าง

/goal

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

ใช้คำสั่งนี้เมื่องานมีหลายขั้นตอน และมีเส้นชัยที่คุณอธิบายออกมาเป็นคำพูดได้

/goal make the test suite pass
/goal reconcile every invoice in this folder against the GL and write up the exceptions

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

ติดตามและกำกับทิศทาง

เมื่อเป้าหมายเริ่มทำงาน คุณจะเห็นแต่ละเทิร์นขณะที่เกิดขึ้น พร้อมการเรียกใช้เครื่องมือของเทิร์นนั้น ตัวควบคุมมีดังนี้

คำสั่งสิ่งที่ทำ
/goalแสดงเป้าหมายปัจจุบัน ได้แก่ สถานะ จำนวนเทิร์นที่ใช้ไป และเหตุผลที่หยุดครั้งล่าสุด
/goal pauseหยุดเป้าหมายชั่วคราวโดยไม่ทำให้เป้าหมายหายไป
/goal resumeกลับมาทำเป้าหมายต่อจากจุดที่หยุดไว้
/goal clearทิ้งเป้าหมายไปทั้งหมด ใช้ stop, off, cancel และ reset ได้เช่นกัน

/goal status เหมือนกับ /goal ที่ไม่มีอาร์กิวเมนต์ และ /goal continue เหมือนกับ /goal resume

การรันหยุดเมื่อไร

เป้าหมายไม่มีวันรันไปตลอดกาล มันจะจบด้วยเหตุผลข้อใดข้อหนึ่งต่อไปนี้ และ Perch จะบอกคุณว่าเป็นข้อไหน

การหยุดความหมาย
Completeผ่านการตรวจสอบความเสร็จสมบูรณ์แล้ว งานเสร็จ
Budgetถึง 40 เทิร์น หรือ 4 ชั่วโมงตามเวลาจริงแล้ว สิ่งที่คุณได้คือความคืบหน้าบางส่วน
No progressเทิร์นล่าสุดไม่ได้เรียกใช้เครื่องมือเลยและไม่ผ่านการตรวจสอบ จึงหยุดแทนที่จะวนอยู่กับที่
Blockedมีการกระทำที่ต้องได้รับการอนุมัติจากคุณ
Failedมีเทิร์นที่เกิดข้อผิดพลาด
Cancelledคุณหยุดเองด้วย Ctrl-C ใน CLI หรือ Esc ในแอปเดสก์ท็อป

ยกเว้น Complete ทุกกรณีเหล่านี้กลับมาทำต่อได้ด้วย /goal resume

โหมดสิทธิ์มีผลตรงนี้

นี่คือเรื่องที่ทำให้หลายคนแปลกใจ ในโหมดสิทธิ์ Default การเขียนหรือคำสั่งแรกจะหยุดรอการอนุมัติจากคุณ แล้วเป้าหมายจะรายงานว่า Blocked และหยุด นั่นคือพฤติกรรมที่ถูกต้อง แต่หมายความว่าเป้าหมายที่ปล่อยให้รันข้ามคืนโดยไม่มีคนดูในโหมด Default จะไปได้ไม่ไกล

ถ้าคุณอยากให้เป้าหมายรันระหว่างที่คุณไม่อยู่ ให้ใช้ Auto Review (งานที่ย้อนกลับได้จะรันเอง ส่วนการกระทำที่ย้อนกลับไม่ได้ยังคงถาม) หรือ Take the Wheel (อิสระเต็มที่) ดูว่าแต่ละโหมดอนุญาตอะไรบ้างได้ที่โหมดสิทธิ์

เป้าหมายยังอยู่แม้ออกจากโปรแกรม

เป้าหมายถูกบันทึกไว้กับเธรดของมัน จึงอยู่ได้นานกว่าเซสชัน ออกจาก CLI ปิดแอปเดสก์ท็อป หรือโหลดหน้าเว็บใหม่ แล้วกลับมาที่โฟลเดอร์หรือเธรดเดิมและรัน /goal resume เป้าหมายและจำนวนเทิร์นยังอยู่ครบ

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

/verify

/verify ตรวจข้อความกล่าวอ้างในคำตอบซ้ำกับแหล่งที่มาที่ทำดัชนีไว้ของคุณ คำสั่งนี้ใช้เพียงการดึงข้อมูล ไม่มีการเรียกโมเดลอยู่เบื้องหลัง จึงได้ผลกลับมาเร็วและไม่ใช้โทเค็น

/verify                  # check the last answer Perch gave
/verify <paste text>     # check text you wrote or pasted
/verify --changed        # re-check only what moved since your last check

คุณจะได้สรุปจำนวน แล้วตามด้วยหนึ่งบรรทัดต่อหนึ่งข้อความกล่าวอ้าง

Citation check — 6 claims in the last answer checked against your sources
✓ 4 verified · ~ 1 uncertain · ✗ 1 not found

✓ หมายความว่ามีแหล่งที่มารองรับข้อความกล่าวอ้างนั้น ~ หมายความว่าความตรงกันอ่อนพอที่คุณควรเข้าไปดู และ ✗ หมายความว่าไม่มีอะไรในแหล่งที่มาของคุณรองรับ บรรทัด ✗ คือเหตุผลที่คำสั่งนี้มีอยู่ รันคำสั่งนี้หลังจาก Perch ร่างอะไรก็ตามที่มีการอ้างอิง และก่อนที่ฉบับร่างนั้นจะออกจากมือคุณ

--changed และ checkpoint คืออะไร

/verify --changed ตอบคำถามที่แคบกว่า คือ ตั้งแต่ที่คุณตรวจครั้งล่าสุด มีแหล่งที่มาใดเปลี่ยนไปโดยที่คุณไม่รู้ตัวหรือไม่ และมีอะไรที่คุณอาศัยอยู่ซึ่งไม่เป็นจริงอีกต่อไปหรือไม่

รายละเอียดสำคัญคือ การรัน /verify ครั้งล่าสุดของคุณคือ checkpoint ไม่มีคำสั่งแยกสำหรับตั้ง checkpoint การตรวจแต่ละครั้งจะบันทึกแหล่งที่มาที่ใช้ไว้ การรัน --changed ครั้งต่อมาจึงตรวจซ้ำเฉพาะข้อความกล่าวอ้างที่แหล่งที่มาเปลี่ยนไปจริงๆ และไม่แตะส่วนที่เหลือ ถ้าคุณไม่เคยรัน /verify ในเธรดนั้นเลย --changed ก็ไม่มีอะไรให้เปรียบเทียบ และจะบอกคุณเช่นนั้น

ผลลัพธ์จะแสดง regression ก่อน หมายถึงข้อความกล่าวอ้างที่อ่อนลง เพราะเป็นส่วนเดียวที่คุณต้องลงมือทำอะไรบางอย่าง --since-last เป็นชื่อเรียกแทน ถ้าคุณอ่านแล้วเข้าใจง่ายกว่า

/deepresearch

/deepresearch ใช้กับคำถามที่ต้องค้นหามากกว่าหนึ่งรอบ มันจะแตกคำถามออกเป็นคำถามย่อย ค้นหาในไฟล์ที่ทำดัชนีไว้ของคุณและบนเว็บ (รวมถึงแหล่งที่มาเฉพาะทางเมื่อเหมาะสม) อ่านสิ่งที่พบตลอดหลายรอบ แล้วกลับมาพร้อมรายงานที่มีการอ้างอิง และทะเบียนข้อความกล่าวอ้าง (claim ledger)

/deepresearch what changed in EU AI Act enforcement this year
/deepresearch --rounds 5 does creatine improve strength in trained adults
/deepresearch --web only use the public web for this merger timeline

/research และ /deep-research คือคำสั่งเดียวกัน ใช้คำสั่งนี้เมื่อคุณต้องการคำตอบที่ผ่านการค้นคว้าพร้อมแหล่งที่มาที่คุณตรวจสอบได้ ไม่ใช่คำตอบแชตแบบเร็วๆ อย่าใช้กับการค้นหาข้อมูลบรรทัดเดียว หรือกับงานที่มีเส้นชัยซึ่งควรใช้ /goal

Flag

Flagสิ่งที่ทำ
--rounds Nกำหนดงบจำนวนรอบตั้งแต่ 1 ถึง 6 ค่าเริ่มต้นคือ 3 ใช้ -r และ --rounds=N ได้เช่นกัน
--webข้ามไฟล์ในเวิร์กสเปซของคุณ และค้นคว้าบนเว็บสาธารณะเท่านั้น --web-only ทำงานเหมือนกัน
--resumeทำการรันที่ถูกพักไว้ต่อหลังจากถูกขัดจังหวะแบบกะทันหัน --continue ทำงานเหมือนกัน

/deepresearch เปล่าๆ ที่ไม่มีคำถามจะแสดงวิธีใช้ และไม่ใช้การใช้งานของคุณ ถ้ามีการรันที่รอให้ทำต่ออยู่ มันจะบอกคุณด้วย

สิ่งที่คุณได้กลับมา

คำตอบในแชตประกอบด้วยรายงาน รายการแหล่งที่มาแบบมีหมายเลข และทะเบียนข้อความกล่าวอ้าง ทะเบียนนี้แบ่งเป็นสามระดับ ได้แก่ มีไฟล์ของคุณรองรับ มีเฉพาะบนเว็บ หรือไม่มีหลักฐานรองรับ คำตอบจะเน้นข้อความกล่าวอ้างที่มีไฟล์รองรับและที่ไม่มีหลักฐานรองรับ ส่วนบันทึกฉบับเต็มจะแสดงครบทั้งสามระดับ

บนเดสก์ท็อปและ CLI นั้น Perch ยังเขียนไฟล์ markdown ไว้ใน perch-research/ ซึ่งมีรายงานฉบับเต็ม แผน แหล่งที่มาทุกรายการ และทะเบียนฉบับสมบูรณ์ ไฟล์นั้นคือบันทึกถาวรของการรันครั้งนั้น

การทำต่อ และเมื่อไรที่หมดอายุ

การขัดจังหวะแบบกะทันหันจะพักการรันไว้ให้คุณกลับมาทำต่อได้ด้วย /deepresearch --resume คุณมีเวลาประมาณ 45 นาที หลังจากนั้นการพักจะหมดอายุ และคุณต้องเริ่มใหม่ด้วยคำถามเดิม ส่วนการยกเลิกตามปกติจะเขียนรายงานบางส่วนแทน และไม่เหลืออะไรให้ทำต่อ

--web หมายความว่าจะไม่มีข้อความกล่าวอ้างที่มีไฟล์ของคุณรองรับ ถ้ายังไม่มีอะไรในโฟลเดอร์ที่ทำดัชนีไว้ ก็จะเป็นเช่นเดียวกันจนกว่าคุณจะทำดัชนีไฟล์สักไฟล์

/delegate

/delegate <task> ส่งงานที่มีขอบเขตชัดเจนให้เอเจนต์เบื้องหลัง แล้วคืนช่องพรอมต์ให้คุณ เอเจนต์จะรันแบบ async และส่งผลลัพธ์กลับมาให้รีวิว งานที่ใช้เวลานานจึงไม่บล็อกเซสชันที่คุณใช้อยู่ /bg <task> คือคำสั่งเดียวกันที่พิมพ์สั้นกว่า

/delegate summarize every PDF in ./contracts and list the renewal dates

ใช้คำสั่งนี้เมื่องานจบในตัวเอง และคุณอยากทำงานอื่นต่อมากกว่านั่งดูมันรัน ถ้างานต้องการข้อมูลจากคุณระหว่างทาง หรือคุณอยากกำกับทิศทางเอง ให้ทำงานนั้นในเซสชันหลักแทน

/flock

/flock <task> ให้ทีมเวิร์กเกอร์ทำงานยากหนึ่งงาน และให้เวิร์กเกอร์ตรวจสอบยืนยันผลลัพธ์ก่อนที่คุณจะเห็น คำสั่งนี้ยังอยู่ในขั้นทดลองและไม่แสดงในเมนูคำสั่ง แต่ใช้งานได้ในแอปเดสก์ท็อปและ CLI

/flock review this branch for regressions and verify the tests

คำสั่งนี้สร้างมาสำหรับงานที่ทำรอบเดียวไม่พอ และจะปฏิเสธงานเล็กก่อนเริ่ม เพราะเทิร์นปกติเร็วกว่า ดูวิธีวางแผนและรันทีมได้ที่ Flock

คำสั่งเซสชัน

คำสั่งเหล่านี้ไม่ได้รันงาน แต่เปลี่ยนหรือแสดงข้อมูลบางอย่างของเซสชัน

คำสั่งสิ่งที่ทำใช้ได้ที่
/model [tier|name]แสดงหรือตั้งค่าโมเดลของคุณ เป็นระดับของ Roost หรือการปักหมุดโมเดลที่ระบุชัดเจน ดูระดับโมเดลทั้งสองแบบ
/usageแสดงการใช้งาน Perch Token ที่รวมอยู่ในแพ็กเกจของคุณ และการใช้งานของเซสชันนี้ทั้งสองแบบ
/compactสรุปเทิร์นเก่าเพื่อเพิ่มพื้นที่ว่างใน context windowเดสก์ท็อป
/contextแสดงมาตรวัดบริบทและรายละเอียดการบีบอัดบริบทCLI
/persona [saffron|quill]แสดงหรือสลับน้ำเสียง ดูเพอร์โซนาCLI
/mode [ask|agents|plan]แสดงหรือตั้งค่าโหมดแชตCLI
/permission [mode]แสดงหรือตั้งค่าว่า Perch ทำอะไรได้มากแค่ไหนโดยไม่ต้องถามCLI
/thinking [on|off]แสดงหรือเปิดปิด extended thinking ของโมเดลที่เลือกCLI
/local-tools [on|off]แสดงหรือเปิดปิดเครื่องมือเชลล์และเครื่องมือไฟล์ในเครื่องCLI
/cwd [dir]แสดงหรือเปลี่ยนไดเรกทอรีทำงานCLI
/thread [new|id]แสดง รีเซ็ต หรือตั้งค่า id ของเธรดปัจจุบันCLI
/skills [name]แสดงรายการสกิลหลักของ Perch หรือแสดงเนื้อหาของสกิลหนึ่งรายการCLI
/memory-audit <text>ตรวจว่าโน้ตหนึ่งจะถูกบันทึกลงหน่วยความจำหรือไม่ และเพราะอะไร ดูหน่วยความจำCLI
/statusแสดง cwd การยืนยันตัวตน โหมด เพอร์โซนา สิทธิ์ และเธรดCLI
/clearล้างหน่วยความจำบทสนทนาในเครื่องของเซสชันเทอร์มินัลนี้CLI
/helpแสดงรายการคำสั่งทั้งหมดCLI
/login, /logoutลงชื่อเข้าใช้ผ่าน OAuth ในเบราว์เซอร์ หรือล้างการยืนยันตัวตนที่บันทึกไว้CLI
/exitออกจาก CLICLI

ระหว่างที่ Perch ทำงาน

คุณไม่ต้องรอให้เทิร์นจบก่อนจึงจะกำกับทิศทางได้ พิมพ์ข้อความแล้วกด Enter เพื่อเพิ่มคำสั่งกำกับทิศทางกลางเทิร์น Ctrl-C หยุดเทิร์นปัจจุบันใน CLI และ Ctrl-E ขยายรายละเอียด

ขั้นตอนถัดไป