ผู้ให้บริการ AI

ตำแหน่งในผู้ดูแล: System › Settings › AI provider (/settings/ai) สวิตช์โมดูล AI อยู่ที่นั่นและบน System › Admin › License & updates (/license) การ์ด Module

What it does

AI Chat (แชทสนับสนุนอัตโนมัติ) และ AI Agent (การดูแลระบบ VM ด้วยภาษาธรรมชาติ) ไม่ได้มาพร้อมกับโมเดลในตัว คุณต้องเลือก ผู้ให้บริการของคุณเอง: บริการใดก็ตามที่มี chat/completions API ที่ รองรับ OpenAI — ตัวอย่างเช่น OpenAI, OpenRouter, เกตเวย์ LiteLLM หรือเซิร์ฟเวอร์ vLLM ของคุณเอง NexCMP จะจัดเก็บเอนด์พอยต์และ API key (แบบเข้ารหัส) และใช้งานสำหรับฟีเจอร์ AI ทุกรายการ คุณชำระเงินให้กับผู้ให้บริการโดยตรง

ข้อกำหนด

Item	Requirement
Endpoint	URL พื้นฐานที่รองรับ OpenAI (https://api.openai.com/v1, https://ai.example.com/v1) NexCMP จะต่อท้าย /chat/completions กับ URL ที่ลงท้ายด้วย /v1 สำหรับ URL อื่นๆ จะต่อท้าย /v1/chat/completions ส่วน URL ที่ลงท้ายด้วย /chat/completions อยู่แล้วจะถูกนำไปใช้ตามนั้น
Model	โมเดลที่รองรับการเรียกใช้งาน tool (function) calling ทั้ง AI Chat และ Agent ต้องอาศัยสิ่งนี้
คีย์ API	คีย์สำหรับปลายทางนั้น ควรใช้คีย์ที่มีการจำกัดวงเงินใช้จ่ายฝั่งผู้ให้บริการ (เช่น คีย์เสมือนของ LiteLLM ที่มีงบประมาณรายเดือน)
Network	เซิร์ฟเวอร์ของแผงควบคุมต้องเข้าถึงปลายทางผ่าน HTTP(S) ได้ URL ที่พิมพ์ในฟอร์มจะอนุญาตให้ชี้ไปยังอินเทอร์เน็ตบนพอร์ต 80, 443, 8080 หรือ 8443 เท่านั้น หากต้องการใช้อีเมลหรือที่อยู่ภายใน ให้บันทึกผู้ให้บริการก่อนแล้วค่อยทดสอบ
Dependencies	เปิดใช้งานโมดูล AI สำหรับ Agent โปรดดูที่ AI Agent

เตรียมโครงสร้างพื้นฐาน

1. ลงทะเบียนกับผู้ให้บริการและสร้าง API key หากผู้ให้บริการรองรับงบประมาณหรืออัตราจำกัด ให้กำหนดขีดจำกัดรายเดือน

2. จดบันทึก base URL และชื่อโมเดลที่แน่นอน (และเลือกเพิ่มโมเดลสำรองได้สูงสุดสี่โมเดล)

3. ทดสอบจากเซิร์ฟเวอร์ NexCMP ก่อนป้อนข้อมูล:

   curl -s https://ai.example.com/v1/chat/completions \
     -H "Authorization: Bearer XXXX" -H "Content-Type: application/json" \
     -d '{"model":"gpt-4o-mini","messages":[{"role":"user","content":"Reply with one word: OK"}]}'

   คำตอบ JSON ที่มี choices[0].message.content หมายความว่าปลายทางทำงานได้

เชื่อมต่อใน NexCMP

1. เปิด System › Settings › AI provider

2. ในการ์ด Module AI ให้สลับเปิดโมเดล on จนกว่าจะเปิด ลูกค้าจะไม่เห็น AI Chat หรือ AI Agent ในพอร์ตัล (คุณยังสามารถสลับเปิดได้ที่ License & updates)

3. ในการ์ด Connection ให้กรอกข้อมูล:

   ฟิลด์	ตัวอย่าง	หมายเหตุ
   Use this provider	on	ต้องระบุ base URL, โมเดล และคีย์ จึงจะสามารถเปิดใช้งานได้
   ชื่อที่แสดง	LiteLLM	สูงสุด 60 ตัวอักษร
   Base URL (OpenAI-compatible)	https://ai.example.com/v1	http:// หรือ https:// สูงสุด 300 ตัวอักษร ห้ามมีช่องว่าง
   Provider API key	sk-XXXX	จัดเก็บแบบเข้ารหัส หลังจากนั้นจะแสดงเฉพาะ 4 ตัวอักษรสุดท้าย เว้นว่างไว้หากต้องการคงคีย์เดิมที่จัดเก็บไว้
   Default model	gpt-4o-mini	ตัวอักษร, ตัวเลข และ - _ . / : @
   Fallback models	gemini-2.5-flash	คั่นด้วยเครื่องหมายจุลภาค สูงสุด 4 โมเดล ใช้เมื่อโมเดลเริ่มต้นล้มเหลว
   Reasoning effort	Default (not sent)	Minimal, Low, Medium หรือ High สำหรับโมเดลการใช้เหตุผล (Gemini, o-series) ระดับต่ำจะตอบกลับได้เร็วกว่ามาก คงค่าเริ่มต้นไว้สำหรับโมเดลปกติ

4. คลิก Save แล้วคลิก Test connection การทดสอบจะส่งคำถามสั้นๆ หนึ่งคำถามและแสดง Connected — <model>, <ms> ms หรือข้อผิดพลาดที่ส่งกลับมาจากผู้ให้บริการ

What saving does

• การตั้งค่าผู้ให้บริการจะถูกบันทึกเป็นรายการกำหนดค่าเดียว และคีย์จะถูกเข้ารหัสด้วย AES-256-GCM สำหรับจุดประสงค์นี้โดยเฉพาะ โดยใช้มาสเตอร์คีย์ของการติดตั้ง
• การตั้งค่าการสนับสนุน Primary model และ Fallback model (ที่ใช้โดย AI Chat) จะถูกตั้งค่าเป็นโมเดลเริ่มต้นและโมเดลสำรองแรกของคุณโดยอัตโนมัติ
• การเปลี่ยนแปลงจะถูกบันทึกในบันทึกการตรวจสอบ (ปลายทาง, โมเดล, คีย์มีการเปลี่ยนแปลงหรือไม่ — แต่จะไม่บันทึกตัวคีย์)

ตรวจสอบ

1. Test connection แสดงเป็นสีเขียว
2. ลงชื่อเข้าใช้พอร์ตัลในฐานะลูกค้าทดสอบ: เมนูจะแสดง AI Chat (หรือปุ่มแชท) และ AI Agent
3. ถาม AI Chat ว่า "ยอดคงเหลือของฉันคือเท่าไหร่?" คำตอบที่แสดงยอดคงเหลือจริงของคุณจะระบุว่าผู้ให้บริการจัดการกับการเรียกใช้เครื่องมือได้อย่างถูกต้อง

ขีดจำกัดและหมายเหตุ

• ผู้ให้บริการรายเดียว NexCMP ใช้ผู้ให้บริการที่กำหนดค่าไว้เพียงรายเดียวสำหรับ Chat, Agent และการตรวจสอบตั๋ว โมเดลสำรองช่วยให้มีความยืดหยุ่นภายในผู้ให้บริการรายนั้น
• ความปลอดภัยของคีย์ คีย์ที่บันทึกไว้จะถูกส่งไปยังปลายทางที่บันทึกไว้เท่านั้น หากคุณเปลี่ยน Base URL คุณต้องพิมพ์คีย์ใหม่อีกครั้งก่อนทำการทดสอบ
• Limits per customer. AI Chat เป็นบริการสำหรับลูกค้าที่เข้าสู่ระบบแล้วเท่านั้น โดยมีขีดจำกัดข้อความต่อนาทีและต่อแชท ตัว Agent มีขีดจำกัดการเรียกใช้งานต่อวันต่อบัญชี ดูข้อมูลเพิ่มเติมที่ AI Chat และ AI Agent.
• Privacy. คำถามของลูกค้าและข้อมูลที่ AI อ่านสำหรับลูกค้านั้น ๆ (แบบอ่านอย่างเดียว) จะถูกส่งไปยังผู้ให้บริการของคุณ โปรดระบุเรื่องนี้ไว้ใน privacy policy ของคุณ.
• Cost control. NexCMP ไม่ได้คิดค่าใช้จ่าย AI ตามการใช้งานจริง โปรดใช้ฟีเจอร์ควบคุมงบประมาณของผู้ให้บริการ
• คุณสามารถปิดใช้งานโมดูลได้ตลอดเวลา: เมนู AI จะหายไป และเราต์ AI จะตอบกลับเป็น 404 module_disabled โดย background job บางตัวของ AI Chat (การตรวจสอบทิกเก็ต, การตอบกลับที่ล่าช้า) จะเริ่มใช้การเปลี่ยนแปลงนี้เมื่อรีสตาร์ท panel ในครั้งถัดไป

การแก้ Problme

อาการ	สาเหตุ	วิธีแก้ปัญหา
base_url must be an http(s) URL	รูปแบบหรือช่องว่างไม่ถูกต้อง	ใช้ https://host/v1
api_key is required to enable the provider	ไม่มีคีย์ที่บันทึกไว้	ป้อนคีย์และบันทึก
base_url and model are required to enable the provider	ช่องว่าง	กรอกทั้งสองช่อง
"Base URL ถูกบล็อก: เฉพาะ public http(s) เท่านั้น, พอร์ต 80/443/8080/8443"	กำลังทดสอบที่อยู่ภายในระบบที่ยังไม่ได้บันทึกหรือพอร์ตอื่น	บันทึกข้อมูลผู้ให้บริการก่อน แล้วจึงทำการทดสอบ
api_key is required (enter the key again when you change the endpoint)	Base URL แตกต่างจากที่บันทึกไว้	พิมพ์คีย์ใหม่อีกครั้ง
model: letters, digits and - _ . / : @	อักขระไม่ถูกต้อง	ใช้รหัสโมเดลที่ถูกต้องของผู้ให้บริการ
fallback_models: up to 4 model names	มีจำนวนมากเกินไป	คงไว้ที่สี่รายการหรือน้อยกว่า
การทดสอบล้มเหลวด้วยรหัส 401	Wrong key	ตรวจสอบคีย์และเอ็นด์พอยต์
การทดสอบล้มเหลวด้วยรหัส 404 หรือ "model not found"	เส้นทางหรือโมเดลไม่ถูกต้อง	ตรวจสอบ base URL (/v1) และรหัสโมเดล
Too many tests — wait a minute (429)	มากกว่า 10 การทดสอบต่อนาที	โปรดรอสักครู่
พอร์ทัลยังคงไม่แสดงเมนู AI	โมเดลปิดอยู่ หรือผู้ให้บริการไม่ได้ตั้งค่าเป็น "in use"	เปิดใช้งานโมดูลและเปิดใช้งานผู้ให้บริการ