รูทีน

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

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

สร้างรูทีน

หรือบอก Perch

ในแชตใดก็ได้ของ Perch Terminal ไม่ว่าจะบนเว็บ ใน Perch Desktop หรือใน CLI ให้อธิบายรูทีนที่คุณต้องการ หรือพิมพ์ /schedule (ใช้ /routines ก็ได้) Perch จะถามข้อมูลที่ยังขาด แล้วแสดงการ์ดที่มีทุกอย่างที่จะบันทึก ได้แก่ ชื่อ คำสั่งฉบับเต็ม กำหนดการตามเขตเวลาของคุณพร้อมการรันครั้งถัดไป โมเดล การเชื่อมต่อ รีโพ และการตั้งค่า

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

การรันของรูทีนเองสร้างหรือแก้ไขรูทีนไม่ได้

ทริกเกอร์

Schedule

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

API

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

ในหน้าของรูทีน Trigger from another app จะแสดงที่อยู่และตัวอย่างคำขอ

curl -X POST https://chat.perchai.app/api/routines/fire \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"text": "..."}'

• text ไม่บังคับ ยาวได้สูงสุด 2,000 ตัวอักษร ข้อความนี้ส่งถึงการรันในฐานะข้อมูล ไม่ใช่คำสั่งให้ทำตาม Perch จึงใช้ข้อความนี้ตามที่คำสั่งของคุณระบุไว้เท่านั้น ตัวอย่างเช่น "แนบข้อความการแจ้งเตือนมาให้แล้ว หาสาเหตุของการแจ้งเตือนนี้ในรีโพ"
• Perch ตอบกลับด้วย 202 พร้อม runId และ chatUrl ของการรันใหม่
• รูทีนหนึ่งเริ่มด้วยวิธีนี้ได้สูงสุด 30 ครั้งต่อชั่วโมง
• Make a new token จะแทนที่โทเค็น และโทเค็นเดิมจะใช้ไม่ได้อีก Delete token จะปิดทริกเกอร์ API

Run now

ทุกรูทีนมี Run now ในหน้าของรูทีน ไม่ว่าจะใช้ทริกเกอร์แบบใด เลือก Add a note ก่อน หากต้องการส่งข้อความเพิ่มเติมไปกับการรันครั้งนั้นครั้งเดียว

การตั้งค่า

การเชื่อมต่อ

รูทีนใช้ได้เฉพาะการเชื่อมต่อที่คุณเพิ่มไว้ในแท็บนี้ ระบบจะไม่เลือกให้คุณเอง คุณเพิ่มแอปใดก็ได้ที่เชื่อมต่อไว้ใน Settings › Connections ได้สูงสุด 10 รายการต่อรูทีน

รูทีนรันบนคลาวด์ เซิร์ฟเวอร์ MCP ในเครื่องที่ตั้งค่าไว้บนคอมพิวเตอร์ของคุณจึงใช้กับรูทีนไม่ได้ เช่นเดียวกับเอเจนต์บนคลาวด์ทุกตัว

การทำงาน

• Ask before risky actions เป็นค่าเริ่มต้น การรันจะรอการอนุมัติจากคุณก่อนทำสิ่งใดที่เสี่ยง และสถานะจะแสดงเป็น Waiting for you หน้า Routines จะแสดง A run is waiting for your approval พร้อมปุ่ม Review ที่เปิดแชตนั้น คำขออนุมัติที่ไม่ได้รับคำตอบภายใน 24 ชั่วโมงจะหมดอายุ
• Run without asking ให้ Perch ทำตามคำสั่งโดยไม่หยุดถาม รวมถึงทำการเปลี่ยนแปลงผ่านการเชื่อมต่อของรูทีน ใช้ตัวเลือกนี้กับงานที่คุณเคยดูการรันมาก่อนแล้ว
• New chat each run เป็นค่าเริ่มต้น Keep one chat จะทำให้การรันแต่ละครั้งทำต่อจากครั้งก่อน จึงบอกคุณได้ว่ามีอะไรเปลี่ยนไปตั้งแต่ครั้งนั้น

การแจ้งเตือน

Tell me ใช้กำหนดว่าคุณจะได้รับแจ้งเรื่องการรันเมื่อใด

• After every run (ค่าเริ่มต้น)
• Only when there's something to report. การรันแต่ละครั้งจะบอกว่าพบอะไรหรือไม่ การรันที่ไม่พบอะไรจะแสดง Nothing to report และไม่แจ้งเตือนคุณ
• Only when a run fails
• Never

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

เว้นแต่ Tell me จะตั้งเป็น Never Perch จะส่งอีเมลถึงคุณเสมอเมื่อการรันล้มเหลว รอการอนุมัติจากคุณ หรือเริ่มไม่ได้ แม้จะไม่ได้ติ๊ก Email ไว้ก็ตาม

ติดตามรูทีนของคุณ

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

เปิดรูทีนเพื่อดูการรันของรูทีนนั้น ได้แก่ เวลาที่แต่ละการรันเริ่ม สิ่งที่เริ่มการรัน (Schedule, API หรือ Run now) ผลของการรัน และระยะเวลาที่ใช้ Open chat จะเปิดแชตของการรันนั้น แชตของรูทีนจะไม่แสดงในรายการแชตของคุณ รูทีนที่รันทุกชั่วโมงจึงไม่ทำให้งานอื่นของคุณจมหายไป แต่ละแชตเป็นแชตบนคลาวด์ตามปกติ คุณถามต่อ ตอบคำขออนุมัติ หรือรีวิว branch ในแผง Changes ได้

การรันตามกำหนดการจะถูกข้าม และการรันครั้งถัดไปจะดำเนินต่อตามแผน ในกรณีต่อไปนี้

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

หากต้องการแก้ไขรูทีน ให้เปิดรูทีนนั้นแล้วเลือก Edit จากเมนู More actions สวิตช์ใช้ปิดและเปิดรูทีน Delete จะลบรูทีนแต่ยังเก็บแชตของรูทีนนั้นไว้

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

การใช้งานและขีดจำกัด

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

การแก้ปัญหา

ไม่เห็น Routines รูทีนมาพร้อมกับ Pro ตรวจสอบว่าคุณลงชื่อเข้าใช้บัญชี Pro ของคุณอยู่

กำหนดการถูกปฏิเสธ รูทีนหนึ่งรันได้ไม่เกินชั่วโมงละครั้ง และเวลาของ Once ต้องเป็นเวลาในอนาคต

การรันแสดงว่า Skipped สาเหตุจะแสดงอยู่ข้างๆ รายการด้านบนอธิบายสาเหตุแต่ละข้อไว้

ไม่ได้รับอีเมล ตรวจสอบว่า Tell me ไม่ได้ตั้งเป็น Never และดูในโฟลเดอร์สแปมของคุณ หาก Perch ส่งอีเมลไม่ได้ในขณะนั้น หน้าของรูทีนจะแจ้งไว้