การแก้ไขปัญหา ReplyRabbit
ปัญหาส่วนใหญ่ของ ReplyRabbit มาจากหนึ่งในสามสิ่ง: คีย์ API ที่หายไปหรือผิด การใช้ผู้ให้บริการที่แพ็กเกจของคุณไม่อนุญาต หรือแคช FreeScout ที่ล้าสมัย ไล่ตามส่วนที่ตรงกันด้านล่าง ซึ่งแต่ละปัญหาจะแสดงอาการก่อนแล้วจึงแสดงวิธีแก้ไข
ไม่มีการสร้างฉบับร่าง
อาการ: คุณเปิดบทสนทนา แต่ไม่มีร่าง AI ปรากฏขึ้นและดูเหมือนว่าไม่มีอะไรเกิดขึ้น
แก้ไข: เปิดการตั้งค่า ReplyRabbit ของกล่องจดหมาย (กล่องจดหมาย > การตั้งค่า > ReplyRabbit) และยืนยันว่าเลือกผู้ให้บริการแล้วและตั้งค่าคีย์ API แล้ว ในแพ็กเกจฟรี ผู้ให้บริการเดียวที่ใช้ได้คือ OpenAI ดังนั้นหากคุณเลือกอื่น ให้สลับกลับไป OpenAI หรืออัปเกรด จากนั้นตรวจสอบว่า ReplyRabbit เปิดใช้งานสำหรับกล่องจดหมายที่คุณกำลังทำงานอยู่ เนื่องจากร่างจะสร้างเฉพาะกล่องจดหมายที่เปิดใช้งาน
ข้อผิดพลาดคีย์ API ไม่ถูกต้องหรือผู้ให้บริการ
อาการ: คุณเห็นข้อผิดพลาดที่กล่าวถึงคีย์ไม่ถูกต้อง ความล้มเหลวในการรับรองความถูกต้อง หรือผู้ให้บริการที่ไม่สามารถเข้าถึงได้
แก้ไข: ตรวจสอบคีย์อีกครั้งว่ามีการพิมพ์ผิดหรือมีช่องว่างเกินมา ยืนยันว่าเป็นคีย์สำหรับผู้ให้บริการที่คุณเลือกจริง (คีย์ OpenAI จะใช้กับ Anthropic ไม่ได้) และตรวจสอบว่าคีย์ยังมีเครดิตและการเข้าถึงในแดชบอร์ดของผู้ให้บริการ คีย์ที่มียอดคงเหลือไม่เหลือหรือถูกเพิกถอนการเข้าถึงจะให้ข้อผิดพลาดเดียวกัน
ข้อผิดพลาดหลังอัปเกรด PHP
อาการ: หลังการอัปเกรดเซิร์ฟเวอร์ (เช่น เป็น Ubuntu 26.04 กับ PHP 8.5) ทดสอบการเชื่อมต่อ ล้มเหลวหรืองานเบื้องหลังหยุด และบันทึก FreeScout แสดงข้อความที่ลงท้ายด้วย is deprecated since 8.5.
แก้ไข: อัปเดต ReplyRabbit และโมดูลอื่นๆ ของคุณให้ทันสมัยจาก จัดการ > โมดูล, จากนั้นรัน php artisan freescout:clear-cache และ php artisan queue:restart. ReplyRabbit รองรับ PHP 8.0 ถึง 8.5 ดู แก้ไขข้อผิดพลาด "deprecated since 8.5" ใน FreeScout เพื่อค้นหาว่าข้อความมาจากโมดูลใด
เมนู ReplyRabbit หายไป
อาการ: ReplyRabbit ไม่ปรากฏในเมนูหรือการตั้งค่าของ FreeScout หลังจากติดตั้ง
แก้ไข: ก่อนอื่นตรวจสอบให้แน่ใจว่าโมดูลถูกเปิดใช้งานภายใต้ จัดการ > โมดูล. จากนั้นล้างแคชจากราก FreeScout ของคุณ:
php artisan freescout:clear-cacheหากยังคงไม่พบ ให้ตรวจสอบสิทธิ์ของผู้ใช้: ผู้ใช้ที่ไม่สามารถเข้าถึงกล่องจดหมายที่เกี่ยวข้องหรือการตั้งค่าผู้ดูแลระบบจะไม่เห็นตัวเลือก ReplyRabbit
ร่างหยุดลงหลังจากผ่านไประยะหนึ่ง
อาการ: ฉบับร่างทำงานในตอนแรก แล้วหยุดสร้างในภายหลังของเดือน
แก้ไข: ระดับฟรีอนุญาต 10 ฉบับร่างต่อเดือน เมื่อถึงขีดจำกัดนั้น ฉบับร่างจะหยุดชั่วคราวจนถึงเดือนถัดไป Pro และ Team ไม่มีขีดจำกัดฉบับร่าง ในทุกแผน ฉบับร่างจะหยุดชั่วคราวด้วยหาก งบประมาณโทเค็นรายเดือน ถูกใช้หมดแล้ว ดังนั้นตรวจสอบการตั้งค่านั้นด้วย (0 หมายถึงไม่มีงบประมาณ)
การแคชพรอมต์ไม่เปลี่ยนจำนวนโทเค็นรายเดือน
อาการ: ฉบับร่างที่ซ้ำกันดูเหมือนจะมีสิทธิ์ใช้แคชพรอมต์ของผู้ให้บริการ แต่การใช้โทเค็นของ ReplyRabbit ยังคงแสดงยอดรวมอินพุตและเอาต์พุตเต็มจำนวน
แก้ไข: นี่เป็นเรื่องที่คาดไว้ ReplyRabbit เก็บงบประมาณรายเดือนแบบอนุรักษ์นิยมและนับโทเค็นทั้งหมด แม้เมื่อผู้ให้บริการเรียกเก็บค่าอินพุตที่แคชไว้ต่างออกไป การประหยัดแคชของผู้ให้บริการขึ้นอยู่กับผู้ให้บริการ โมเดล คำนำหน้าพรอมต์ที่ซ้ำกัน และการรายงานของผู้ให้บริการ การควบคุมแคชของ Anthropic ใช้เฉพาะกับงานฉบับร่างที่ซ้ำกันซึ่งมีสิทธิ์ และจะถอยกลับไปใช้การสร้างแบบปกติเมื่อไม่รองรับ
ตั๋ว Linear ไม่ถูกสร้าง
อาการ: ตรวจพบการดำเนินการถัดไป แต่ไม่มีตั๋ว Linear ถูกสร้าง
แก้ไข: ในการตั้งค่า ReplyRabbit ตรวจสอบคีย์ Linear API ทีมที่เลือก และไม่ว่าตั๋วจะอยู่ในสถานะรอดำเนินการรอการยืนยันหรือไม่ ยืนยันด้วยว่าแผนของคุณรวม Linear: การสร้างตั๋ว Linear ด้วยตนเองเป็นคุณสมบัติ Pro และการสร้างตั๋วอัตโนมัติเป็นคุณสมบัติ Team
ปัญหา Jira ไม่ถูกสร้าง
อาการ: บทสนทนาต้องการงานวิศวกรรม แต่ไม่มี issue Jira ถูกสร้างขึ้น
แก้ไข: ในการตั้งค่า ReplyRabbit ยืนยันว่าเลือก Jira เป็นตัวติดตามปัญหาของกล่องจดหมาย ตรวจสอบ URL ไซต์ Jira Cloud อีเมลบัญชี โทเค็น API โปรเจกต์เริ่มต้น และประเภทปัญหาเริ่มต้น ยืนยันด้วยว่าแผนของคุณรวมการสร้างปัญหา: การสร้างปัญหา Jira ด้วยตนเองเป็นคุณสมบัติ Pro และการสร้างปัญหาอัตโนมัติเป็นคุณสมบัติ Team สำหรับเส้นทางการตั้งค่าแบบเต็ม ดู การเชื่อมต่อ Jira.
แท็กเวิร์กโฟลว์ไม่ถูกนำไปใช้
อาการ: คุณคาดหวังแท็กเช่น rr_priority_critical, rr_no_reply_needed, หรือ rr_linear_issue_created, แต่บทสนทนาไม่มีแท็ก ReplyRabbit
แก้ไข: เปิดการตั้งค่า ReplyRabbit ของกล่องจดหมายและยืนยัน เปิดใช้งานการซิงค์เวิร์กโฟลว์ และ ใช้แท็ก FreeScout เปิดอยู่ใน แท็กเวิร์กโฟลว์ ส่วน หากแท็กสัญญาณหายไป โปรดยืนยัน สัญญาณ AI เปิดอยู่และบทสนทนาได้รับการวิเคราะห์แล้ว หากแท็ก Linear หายไป ยืนยันว่าบทสนทนามีปัญหาที่สร้างโดย ReplyRabbit Linear
หากสูตร FreeScout Workflows ไม่ทำงาน ก่อนอื่นให้ยืนยันว่า ReplyRabbit กำลังเพิ่มแท็ก FreeScout ที่คาดไว้ จากนั้นทดสอบว่าโมดูล Workflows ที่ติดตั้งไว้ตอบสนองต่อการเปลี่ยนแปลงแท็กแบบโปรแกรมหรือไม่ ReplyRabbit สามารถใช้แท็กได้ แต่โมดูล Workflows ควบคุมว่าสูตรจะทำงานจากการเปลี่ยนแปลงแท็กนั้นหรือไม่
แหล่งความรู้: ร่างไม่ได้ใช้หน้าช่วยเหลือ ฐานความรู้ ผลิตภัณฑ์ หรือคำตอบก่อนหน้า
อาการ: ร่างไม่สนใจข้อมูลที่คุณรู้ว่ามีอยู่ในหน้าช่วยเหลือ ฐานความรู้ รายการสินค้า หรือการตอบกลับก่อนหน้า
แก้ไข: เริ่มจากบรรทัดใต้ฉบับร่างในตัวแก้ไขการตอบกลับ มันแสดงรายการสิ่งที่ฉบับร่างใช้ เช่น "Included: 2 help pages, 1 Knowledge Base article, 3 earlier replies to this customer" คลิกเพื่อดูลิงก์ พร้อมบันทึกสำหรับแต่ละแหล่งที่เปิดใช้งานซึ่งไม่ได้เพิ่มอะไรเลย:
- เปิดใช้งานแล้วแต่ยังไม่ได้จัดทำดัชนี: การจัดทำดัชนียังไม่เสร็จ ตรวจสอบผู้ปฏิบัติงานคิว (ดูด้านล่าง) จากนั้นรอให้การจัดทำดัชนีเสร็จสมบูรณ์
- ไม่พบรายการที่ตรงกันสำหรับข้อความนี้: แหล่งข้อมูลนั้นใช้ได้ แต่ไม่มีสิ่งใดในนั้นที่ตรงกับข้อความของลูกค้ารายนี้ใกล้เคียงพอ เพิ่มหรือปรับปรุงเนื้อหาที่ตอบคำถามประเภทนี้
- ดัชนีเกินขีดจำกัดการค้นหา: เมื่อดัชนีเกิน 6,000 ส่วนที่จัดทำดัชนี จะมีการจับคู่คำสำคัญเท่านั้นที่ทำงาน ไม่ใช่การจับคู่ตามความหมาย ลบแหล่งที่มาที่คุณไม่ต้องการเพื่อนำกลับมาอยู่ภายใต้ขีดจำกัด
- แพ็กเกจของคุณไม่รวมสิ่งนี้: แหล่งข้อมูลนั้นไม่พร้อมใช้งานในแผนปัจจุบันของคุณ
- โมดูลฐานความรู้ไม่ได้ติดตั้งหรือเปิดใช้งาน: ติดตั้งหรือเปิดใช้งานภายใต้ จัดการ > โมดูล.
คำเตือนสถานะการตั้งค่า
แบนเนอร์สถานะการตั้งค่าในการตั้งค่ากล่องจดหมายตอนนี้จะเตือนเมื่อ:
- ดูเหมือนว่า worker ของคิวไม่ได้ทำงาน การจัดทำดัชนีและฉบับร่างอัตโนมัติจะไม่มีวันเสร็จสิ้นหากไม่มีมัน FreeScout รันคิวผ่านงาน cron
php artisan schedule:runหรือqueue:workกระบวนการ ดังนั้นโปรดตรวจสอบว่าได้ตั้งค่าหนึ่งในนั้นไว้แล้ว - ยังไม่ได้เปิดแหล่งความรู้ใดๆ เปิดอย่างน้อยหนึ่งรายการในการตั้งค่ากล่องจดหมาย แหล่งความรู้
- แหล่งข้อมูลเปิดอยู่แต่ยังไม่ได้จัดทำดัชนี ให้การจัดทำดัชนีเสร็จสิ้น
แหล่งเว็บไซต์
- การรวบรวมข้อมูลหยุดที่ 200 หน้าโดยค่าเริ่มต้น และแหล่งข้อมูลตอนนี้ระบุเช่นนั้น พร้อมปุ่มเพื่อเพิ่มขีดจำกัด บันทึกการตั้งค่าของคุณหลังจากนั้น แล้วรวบรวมข้อมูลอีกครั้ง
- หน้าที่อ่านไม่ได้จะถูกนับพร้อมเหตุผล เช่น ถูกบล็อกโดยไซต์ (403) ไม่พบ (404) คำขอมากเกินไป (429) ข้อผิดพลาดเซิร์ฟเวอร์ ใหญ่เกินไป หรือไม่มีข้อความที่อ่านได้ (มักเป็นหน้าที่สร้างด้วย JavaScript) ขอให้โฮสต์ของคุณอนุญาตตัวรวบรวมข้อมูล หรือชี้แหล่งข้อมูลไปยังหน้าที่ไม่ต้องใช้ JavaScript
- หน้าที่ยาวมากจะถูกย่อให้เหลือประมาณ 24,000 ตัวอักษร เมื่อการจับคู่เชิงความหมายเปิดอยู่ แหล่งที่มาจะแสดงจำนวนหน้าที่ถูกย่อ แยกหน้าที่อยู่นานหากส่วนที่คุณต้องการอยู่ใกล้ตอนท้าย
โครงร่างและการจับคู่ตามความหมาย
- การซิงค์ Outline หยุดที่ 1,000 เอกสาร เอกสารเกินกว่านั้นจะไม่ถูกซิงค์
- การจับคู่ตามความหมาย (เชิงความหมาย) ต้องใช้ผู้ให้บริการ embeddings โมเดล embedding บางตัวยังไม่ได้ปรับเทียบสำหรับการจับคู่ตามความหมายเท่านั้นและแสดงคำเตือน ดังนั้นเปลี่ยนไปใช้โมเดล embedding อื่นหากคุณเห็นคำเตือนนั้น
ยังติดอยู่หรือไม่