PerchAI
การใช้ Perch

งานเบื้องหลัง

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

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

มีสองสิ่งที่ต่างกันทำงานอยู่เบื้องหลัง และควรแยกให้ออก

คำสั่งเบื้องหลัง

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

Perch ควบคุมมันด้วยห้าเครื่องมือ

เครื่องมือทำอะไร
run_in_backgroundเริ่มคำสั่งเป็นงานแยกต่างหากและคืนค่าทันทีพร้อม id ของงาน
list_background_tasksแสดงรายการงานและสถานะของมัน
check_background_taskอ่านผลลัพธ์ล่าสุดโดยไม่บล็อก
wait_for_background_taskบล็อกไว้จนกว่ามันจะเสร็จ
kill_background_taskหยุดมัน

สิ่งที่ harness รับประกัน

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

ขอด้วยคำพูดได้เลย "รันชุดทดสอบไว้เบื้องหลังแล้วทำต่อ" ก็พอแล้ว

Perch กลับมาหางานที่ทำเสร็จแล้ว

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

เรื่องนี้เกิดขึ้นภายใต้กรอบกั้นเท่านั้น

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

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

เอเจนต์เบื้องหลัง

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

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

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

ใน CLI /agents แสดงรายการเอเจนต์ของแชตนี้ /agents <id> พิมพ์ขั้นตอนและรายงานของเอเจนต์หนึ่ง และ /agents stop <id> หยุดมัน

เอเจนต์มีกรอบจำกัดแบบเดียวกับคำสั่งเบื้องหลัง มีเพดานจำนวนขั้นของตัวเอง 30 นาทีตามเวลาจริง และ 10 นาทีที่ไม่มีผลลัพธ์ออกมาจะถือว่าค้าง ทุกผลลัพธ์จะบอกว่าเอเจนต์หยุดเพราะอะไร รวมถึงเมื่อมันชนขีดจำกัด /delegate ต้องใช้เซสชันที่ยังเปิดอยู่ จึงใช้ไม่ได้ใน perch run แบบครั้งเดียว

สำหรับตัวช่วยที่ Perch เรียกใช้ภายในเทิร์น และสำหรับเซสชันย่อย ดูซับเอเจนต์ ส่วนทีมงานทั้งทีมที่ทำงานเดียวกัน ดูFlock