PerchAI
การใช้ Perch

เอเจนต์บนคลาวด์

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

เบต้า

เอเจนต์บนคลาวด์เปิดให้ใช้แล้วสำหรับบัญชี Pro ทุกบัญชี ถ้าคุณเห็น Cloud ในเมนูที่ใช้เลือกว่าข้อความจะรันที่ไหน แสดงว่าฟีเจอร์นี้เปิดให้คุณแล้ว

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

เริ่มเซสชันบนคลาวด์

เปิด Perch Terminal บนเว็บ

ไปที่ chat.perchai.app แล้วสลับจาก Perch AI เป็น Perch Terminal หรือเปิด chat.perchai.app/agents/desktop โดยตรง ใช้ได้ในทุกเบราว์เซอร์ รวมถึงบนโทรศัพท์

เลือก Cloud

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

เลือกรีโพ ถ้างานนั้นต้องใช้

สำหรับงานโค้ด ให้เลือกรีโพบน GitHub และ branch จากปุ่มแคปซูลที่อยู่ถัดไป ปล่อยไว้ที่ No repository สำหรับงานวิจัย งานเขียน หรืองานอื่นใดที่ไม่ได้แตะรีโพ

อธิบายงานแล้วส่ง

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

สิ่งที่เกิดขึ้นหลังคุณส่ง

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

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

คุณปิดทุกอย่างได้ การรันไม่ได้ขึ้นอยู่กับว่าอุปกรณ์เครื่องใดของคุณยังเปิดอยู่

บนโทรศัพท์ ให้เพิ่ม Perch ลงในหน้าจอโฮม เมื่อใช้ Pro แล้ว Perch จะแจ้งเตือนคุณได้เมื่อการรันต้องให้คุณยืนยันหรือทำเสร็จแล้ว

ทำงานกับรีโพบน GitHub

ครั้งแรกที่คุณเลือกรีโพ Perch จะขอให้คุณเชื่อมต่อ GitHub

  1. เลือก Connect GitHub ในช่องพิมพ์ข้อความ
  2. Perch จะแสดงรหัสสั้นๆ เลือก Open GitHub ใส่รหัส แล้วอนุมัติการเข้าถึงรีโพ
  3. เมื่ออนุมัติแล้ว Perch จะ clone, commit และ push branch ในรีโพที่คุณมีสิทธิ์ push ได้

ระหว่างการรัน Perch ทำงานใน clone ของ branch ที่คุณเลือก และ push งานไปยัง branch ใหม่ที่ชื่อขึ้นต้นด้วย perch/ ตามด้วย id สั้นๆ ไม่มีอะไรถูก merge ให้คุณ

หากต้องการรีวิวงาน ให้เปิดแผง Changes ของเธรดนั้น แผงนี้แสดงรายการไฟล์ทุกไฟล์ที่เปลี่ยนพร้อม diff จากตรงนั้นคุณกด Create PR หรือ Create draft PR ได้ และเมื่อมี pull request แล้ว View PR จะพาคุณไปที่ pull request นั้นบน GitHub

เครื่องมือที่เชื่อมต่อ

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

ส่วนเซิร์ฟเวอร์ MCP ในเครื่อง ซึ่งก็คือเซิร์ฟเวอร์ที่ตั้งค่าไว้บนคอมพิวเตอร์ของคุณใน ~/.perch/mcp.json ใช้ไม่ได้ เวิร์กสเปซบนคลาวด์เข้าถึงเครื่องของคุณไม่ได้ งานที่ต้องใช้ไฟล์ในเครื่อง แอปในเครื่อง หรือเซิร์ฟเวอร์ในเครื่อง ควรรันบนคอมพิวเตอร์ของคุณแทน

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

Slack

คุณมอบงานให้ Perch ได้โดยไม่ต้องเปิด Perch เลย

  1. ใน Perch Terminal บนเว็บ ไปที่ Settings › Connections แล้วเลือก Add to Slack
  2. ลิงก์บัญชี Slack ของคุณเข้ากับบัญชี Perch เมื่อ Perch ขอให้ทำ
  3. ส่งข้อความส่วนตัวถึง Perch หรือ mention Perch ในแชนเนล

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

ถ้าขั้นตอนใดต้องการการอนุมัติจากคุณ Slack จะบอกให้คุณเปิด Perch เพื่อตอบ ยังไม่รองรับการอนุมัติจากภายใน Slack

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

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

ความปลอดภัย

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

การแก้ปัญหา

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

รีโพของคุณไม่อยู่ในรายการ Perch แสดงรีโพที่บัญชี GitHub ของคุณ push ได้ สำหรับรีโพขององค์กร องค์กรอาจต้องอนุญาตการเข้าถึง GitHub ของ Perch ก่อน เลือก Reconnect GitHub เพื่อลงชื่อเข้าใช้อีกครั้ง

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