การแก้ไขปัญหา

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

คำขอถูกบล็อก

ทุกคำขอล้มเหลวด้วยข้อผิดพลาด 402 insufficient_credits

สาเหตุ: ยังไม่ได้เปิดใช้โมดูลสำหรับสถานที่นี้ หรือยอดเงินแบบชำระล่วงหน้าหมดแล้ว (แท็บ Overview จะแสดงข้อความ "Your balance is depleted. Inference requests will be blocked until you top up.") สำหรับคีย์ API สถานที่ที่ยังไม่ได้เปิดใช้ Model Router จะส่งคืนข้อผิดพลาด 403 "Model Router is not enabled for this facility" แทน

วิธีแก้ไข: เปิดใช้ Model Router จากหน้า Welcome to Model Router (ดูเริ่มต้นใช้งาน) จากนั้นเติมเงินที่ Budgets & Limits → Balance & Top-up คำขอจะกลับมาทำงานได้ภายในไม่กี่วินาทีหลังจากยอดเงินเข้าบัญชี เพื่อป้องกันไม่ให้เกิดซ้ำ ให้เปิดใช้การเติมเงินอัตโนมัติ ดูงบประมาณและการเติมเงิน

คำขอล้มเหลวด้วยข้อผิดพลาด 402 budget_exceeded

สาเหตุ: ถึงขีดจำกัดการใช้จ่ายแล้ว ข้อความแสดงข้อผิดพลาดจะระบุช่วงเวลา (รายวัน / รายเดือน / ตลอดอายุการใช้งาน) และสำหรับรายวันและรายเดือนจะระบุเวลาที่รีเซ็ตอย่างชัดเจนตามเขตเวลาของสถานที่ของคุณ ขีดจำกัดนี้อาจเป็นขีดจำกัดระดับบัญชี หรือขีดจำกัดของคีย์หรือบริการที่เชื่อมต่อนั้น ๆ (ข้อความจะระบุว่า "This key's" / "This agent's" เมื่อเป็นขีดจำกัดเฉพาะ)

วิธีแก้ไข: รอจนถึงเวลารีเซ็ตที่ระบุ เพิ่มขีดจำกัด (Budgets & Limits → Spend Limits หรือการกำหนดค่าของคีย์หรือบริการ) หรือสำหรับขีดจำกัดสูงสุดตลอดอายุการใช้งาน ให้ใช้ Reset hard cap หน้า Spend Limits จะแสดงอย่างชัดเจนว่าขีดจำกัดใดอยู่ในสถานะ "Limit reached"

คำขอล้มเหลวด้วยข้อผิดพลาด 403 content_policy_violation

สาเหตุ: พรอมต์ตรงกับตัวกรองเนื้อหาในโหมด block หรือตัวป้องกันการแทรกพรอมต์ (prompt-injection shield)

วิธีแก้ไข: ตรวจสอบ Settings → Guardrails หากการผสานรวมใดจำเป็นต้องใช้กฎที่แตกต่างออกไปอย่างสมเหตุสมผล ให้ใช้สวิตช์ Override facility guardrails ของการผสานรวมนั้น แทนการผ่อนปรนนโยบายระดับสถานที่ทั้งหมด ดู Guardrails

คำขอล้มเหลวด้วยข้อผิดพลาด 429

สาเหตุ: คีย์หรือบริการที่เชื่อมต่อใช้งานเกินขีดจำกัดอัตรา Requests / min หรือ Tokens / min

วิธีแก้ไข: ลดความถี่แล้วลองใหม่ หรือเพิ่มขีดจำกัดอัตราในการกำหนดค่าของคีย์หรือบริการ (เว้นว่าง = ไม่จำกัด) ดูคีย์ API

โมเดลหนึ่งส่งคืนข้อผิดพลาด แต่โมเดลอื่นทำงานได้

สาเหตุ: โมเดลนั้นอาจถูกปิดใช้งานสำหรับสถานที่ของคุณ ถูกตัดออกโดยการจำกัดโมเดลของคีย์ หรือผู้ให้บริการอาจกำลังมีปัญหา

วิธีแก้ไข: ตรวจสอบ Settings → Models (เปิดใช้งานโมเดลแล้วหรือไม่) รายการ Restrict models ของคีย์ และ Activity → Performance → Reliability & performance by model เพื่อดูอัตราข้อผิดพลาดของโมเดลในช่วงเวลาต่าง ๆ

ปัญหาเกี่ยวกับคีย์ API

401 Unauthorized

สาเหตุ: หากมีรหัส invalid_api_key ("Missing or invalid API key") แสดงว่าส่วนหัว Authorization: Bearer … หายไปหรือมีรูปแบบไม่ถูกต้อง หากไม่มีรหัส ("Invalid API key") แสดงว่าระบบไม่รู้จักคีย์นั้น (พิมพ์ผิด หรือเป็นข้อมูลลับเก่าหลังจากการ rotate) หรือคีย์ถูก revoke แล้ว

วิธีแก้ไข: ตรวจสอบรูปแบบของส่วนหัว และตรวจสอบสถานะของคีย์ใน Settings → Service Access & API Keys เปิดใช้งานคีย์ที่ถูกเพิกถอนอีกครั้ง หรืออัปเดตบริการของคุณให้ใช้ข้อมูลลับใหม่หากคีย์ถูกหมุนเวียนแล้ว

ข้อมูลลับของคีย์สูญหาย

ข้อมูลลับจะแสดงเพียงครั้งเดียวเมื่อสร้างคีย์และไม่สามารถกู้คืนได้ ให้ใช้ Rotate ระบบจะออกข้อมูลลับใหม่ (แสดงเพียงครั้งเดียว) โดยคีย์ยังคงป้ายชื่อ ขีดจำกัด และประวัติไว้เหมือนเดิม อัปเดตทุกบริการที่ใช้คีย์นี้: "You will need to reconfigure any services still using the old key."

คีย์ใช้งานได้ แต่การใช้งานแสดงภายใต้ชื่อที่ไม่ถูกต้อง

คีย์จะระบุด้วย Label ใน Activity และ Logs แก้ไขคีย์และตั้งป้ายชื่อที่สื่อความหมาย และให้แต่ละระบบมีคีย์ของตัวเองแทนการใช้คีย์ร่วมกัน

ปัญหาเกี่ยวกับเอเจนต์

เอเจนต์แสดงสถานะออฟไลน์

สาเหตุ: อุปกรณ์ปิดอยู่หรือไม่มีการเชื่อมต่อ ซึ่งเป็นเรื่องการเชื่อมต่อของอุปกรณ์ ไม่ใช่การตั้งค่าของ Model Router

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

เอเจนต์หยุดตอบสนองต่อคำขอ AI

ตรวจสอบตามลำดับ:

1. ยอดเงินคงเหลือ: ยอดเงินที่หมดจะบล็อกเอเจนต์ทั้งหมด (เอเจนต์จะแสดงสถานะว่าต้องใช้เครดิต) ให้เติมเงิน
2. ขีดจำกัดต่อบริการ: Settings → Service Access & API Keys → Connected Services เอเจนต์แสดงสถานะ "Limit reached" หรือไม่ ให้เพิ่มขีดจำกัดหรือรอจนกว่าจะพ้นช่วงขีดจำกัด
3. ขีดจำกัดของบัญชี: Budgets & Limits → Spend Limits
4. Logs: กรองตามเอเจนต์เพื่อดูข้อผิดพลาดที่เกิดขึ้นจริงกับคำขอของเอเจนต์นั้น

คำถามเกี่ยวกับยอดเงินและการเรียกเก็บเงิน

ตัวเลขการใช้จ่ายดูเหมือนไม่เป็นปัจจุบัน

ตัวเลข Available balance และ Spent today เป็นข้อมูลแบบเรียลไทม์ ส่วน Monthly usage จะกระทบยอดกับยอดเงินของคุณทุก 15 นาที ดังนั้นการใช้จ่ายล่าสุดอาจใช้เวลาสองสามนาทีจึงจะปรากฏที่นั่น ประวัติธุรกรรมจะแสดงเฉพาะการเติมเงินและการปรับยอดเงิน ดังนั้นการใช้งานจะไม่ปรากฏในประวัติธุรกรรมเลย

การเติมเงินอัตโนมัติไม่ทำงาน

ตรวจสอบแบนเนอร์ในหน้า Balance & Top-up ซึ่งอาจแจ้งว่าไม่มีบัตรในระบบ บัตรต้องได้รับการยืนยันตัวตน หรือบัตรถูกปฏิเสธ แก้ไขข้อมูลบัตร (Update card / Edit payment details) หรือเติมเงินด้วยตนเอง ระบบจะตรวจสอบการเติมเงินอัตโนมัติประมาณทุก 15 นาที ดังนั้นเกณฑ์ที่เพิ่งถูกข้ามอาจใช้เวลาสองสามนาทีจึงจะทริกเกอร์การเติมเงิน

การเติมเงินล้มเหลว

"Additional card authentication is required. Please try again." หมายถึงให้ลองอีกครั้ง ธนาคารของคุณอาจขอให้ยืนยันตัวตน "Top-up could not be completed." หมายถึงการเรียกเก็บเงินถูกปฏิเสธ ให้ตรวจสอบบัตรหรือลองใช้จำนวนเงินอื่น ระบบจะไม่เพิ่มเครดิตใด ๆ เว้นแต่การเรียกเก็บเงินจะสำเร็จ

ถูกเรียกเก็บเงินแล้ว แต่ยอดเงินไม่เปลี่ยนแปลง

การเติมเงินจะเข้าบัญชีทันที ให้รีเฟรชหน้า หากยอดเงินยังไม่สะท้อนการเรียกเก็บเงินที่สำเร็จ ให้จด Transaction ID และ Payment reference จากแผงรายละเอียดของธุรกรรม (หรือจากใบแจ้งยอดบัตรของคุณ) แล้วยื่นคำขอความช่วยเหลือ

คำถามเกี่ยวกับบันทึกและการวิเคราะห์

คำขอที่เพิ่งส่งยังไม่ปรากฏใน Logs

เปิดการรีเฟรชแบบ Live (หรือคลิก Refresh now) โดยปกติคำขอจะปรากฏภายในไม่กี่วินาที แต่เมื่อระบบมีภาระงานสูงอาจใช้เวลานานขึ้นเล็กน้อย

Logs แสดงโมเดลที่ไม่ได้ร้องขอ

หากคุณส่ง model: "auto" บันทึกจะแสดงโมเดลที่ Auto Router เลือกใช้ ให้เปิดรายละเอียดของคำขอเพื่อดู Requested model: auto ซึ่งเป็นลักษณะการทำงานปกติ ดู Models

แถวแสดง "No charge"

การตอบกลับที่ล้มเหลวหรือว่างเปล่าซึ่งไม่มีค่าใช้จ่ายจะมีป้าย No charge โดยบันทึกไว้เพื่อความครบถ้วน แต่ไม่ได้ใช้ยอดเงิน

ไฟล์ CSV ที่ส่งออกมีขนาดเล็กกว่าที่คาดไว้

การส่งออกข้อมูลดิบจำกัดไว้ที่ 25,000 แถว ให้จำกัดช่วงวันที่ให้แคบลงหรือใช้การส่งออกแบบสรุป และโปรดทราบว่า "Summaries cover whole days, so a sub-day or graph selection is widened to full days."