सामग्री पर जाएं
HI
NexCMP मुफ़्त प्राप्त करें

गाइड

CloudStack क्लाउड में AI सपोर्ट चैटबॉट और SSH एजेंट कैसे जोड़ें

NexCMP, Apache CloudStack और Proxmox VE के लिए एक सेल्फ-होस्टेड बिलिंग और ग्राहक पोर्टल है, और वर्शन 1.2.0 में दो AI मॉड्यूल शामिल हैं: AI Chat, जो ग्राहक पोर्टल के भीतर एक असिस्टेंट है, और AI Agent, जो SSH के ज़रिए ग्राहक के अपने VM पर कार्य करता है। यह गाइड ग्राहक पोर्टल और एडमिन कंसोल के स्क्रीनशॉट का उपयोग करके, दोनों को OpenAI-कंपैटिबल API key के साथ सेट अप करना सिखाती है।

NexCMP मुफ़्त प्राप्त करेंडेमो देखें

आवश्यक समय: मौजूदा NexCMP इंस्टॉलेशन पर लगभग 15 मिनट।

स्टैक

चार हिस्से, जिनमें से तीन आप शायद पहले से ही चला रहे हैं।

  • NexCMP 1.2.0

    वह पैनल जिसका उपयोग आपके ग्राहक पहले से ही करते हैं, Ubuntu 22.04 या 24.04 पर इंस्टॉल किया गया। AI Chat और AI Agent लाइसेंस का हिस्सा हैं — कोई अतिरिक्त शुल्क नहीं।

  • एक OpenAI-कम्पैटिबल एंडपॉइंट

    कोई भी चैट-कम्प्लीशन API जो टूल (फ़ंक्शन) कॉलिंग का समर्थन करती हो: एक होस्टेड प्रोवाइडर, या एक प्रॉक्सी जिसे आप कई प्रोवाइडर्स के आगे चलाते हैं।

  • खर्च सीमा वाली की

    पैनल को उसकी अपनी की दें और प्रोवाइडर पर या अपने प्रॉक्सी में उस पर एक मासिक बजट सेट करें, ताकि उपयोग कभी सीमा से बाहर न जाए।

  • आपके CloudStack VMs

    AI Agent ग्राहक द्वारा उस VM के लिए सहेजे गए लॉगिन के साथ, पैनल सर्वर से SSH के ज़रिए ग्राहक के VM तक पहुँचता है।

चरण-दर-चरण

  1. पैनल को 1.2.0 में अपडेट करें

    एडमिन कंसोल में License खोलें और Update दबाएँ, या सर्वर पर sudo nexcmp update चलाएँ। अपडेट इंस्टॉल होने से पहले साइन और चेक किया जाता है।

  2. खर्च सीमा वाली API की बनाएँ

    अपने AI प्रोवाइडर पर (या अपने प्रॉक्सी में) सिर्फ़ इस पैनल के लिए एक की बनाएँ और इसे एक मासिक बजट दें। सपोर्ट चैट के लिए एक तेज़, कम लागत वाला मॉडल पर्याप्त है।

  3. इसे Admin › Settings › AI provider में दर्ज करें

    एंडपॉइंट URL, की और मॉडल का नाम पेस्ट करें, फिर Test connection दबाएँ। की पैनल के डेटाबेस में एन्क्रिप्टेड स्टोर होती है और फिर कभी दिखाई नहीं जाती है।

  4. AI मॉड्यूल चालू करें

    License › Modules में AI चालू करें। पेज रीलोड होने के बाद कस्टमर पोर्टल मेनू में AI Chat और AI Agent दिखाई देते हैं; मॉड्यूल बंद करने पर वे फिर से छिप जाते हैं।

  5. ग्राहक AI Chat से सवाल पूछते हैं

    AI Chat आपके प्लान्स और कीमतों के साथ-साथ ग्राहक की अपनी सेवाओं के बारे में सवालों के जवाब देता है। जब किसी सवाल के लिए किसी व्यक्ति की आवश्यकता होती है, तो ग्राहक बातचीत आपकी सपोर्ट टीम को सौंप सकता है।

    कस्टमर पोर्टल, AI Chat ग्राहक के सर्वरों के बारे में पूछे गए प्रश्न का उत्तर देते हुए

  6. ग्राहक किसी VM पर AI Agent चलाते हैं

    ग्राहक अपनी किसी VM को चुनता है और सामान्य भाषा में कार्य का विवरण देता है। एजेंट SSH के माध्यम से कमांड चलाता है और प्रत्येक कमांड को उसके आउटपुट के साथ दिखाता है।

    ग्राहक पोर्टल, AI Agent जो VM पर कमांड चला रहा है और उनका आउटपुट दिखा रहा है

  7. उपयोग पर नज़र रखें

    उपयोग का बिल आपके AI प्रदाता द्वारा लिया जाता है, NexCMP द्वारा नहीं। प्रदाता या प्रॉक्सी के डैशबोर्ड पर खर्च देखें और जैसे-जैसे आपके ग्राहक इस सुविधा को अपनाते हैं, key का बजट समायोजित करें।

शुरू करने से पहले आपको क्या चाहिए

  • NexCMP 1.2.0 या बाद का वर्शन, License › Modules में AI मॉड्यूल के साथ।
  • OpenAI-कम्पैटिबल chat/completions endpoint और टूल (function) कॉलिंग को सपोर्ट करने वाले मॉडल के साथ एक AI प्रदाता: OpenAI, OpenRouter, LiteLLM गेटवे या आपका अपना vLLM सर्वर, ये सभी योग्य हैं।
  • AI Agent के लिए, पैनल सर्वर पर openssh-client (इन्स्टॉलर इसे जोड़ता है) और पैनल सर्वर से प्रत्येक VM के SSH पोर्ट (डिफ़ॉल्ट रूप से 22) तक एक नेटवर्क रूट।
  • AI Agent के लिए, ग्राहक की एक Linux VM जो चालू हो और लॉक न हो, जिसमें संग्रहीत लॉगिन (VM बनाते समय या उसका पासवर्ड रीसेट करते समय सहेजा गया) या पैनल की ऑपरेशन्स key हो। Windows VM अस्वीकार कर दी जाती हैं।
  • AI Chat स्टाफ़ हैंड-ऑफ़ के लिए वैकल्पिक: Settings › Admin alerts के तहत एक Telegram बॉट और चैट ID।
ssh -V
nc -vz 198.51.100.10 22

पहले पैनल सर्वर से endpoint का परीक्षण करें

NexCMP ऐसे URL में /chat/completions जोड़ता है जो /v1 पर समाप्त होता है, और किसी अन्य URL में /v1/chat/completions जोड़ता है; जो URL पहले से /chat/completions पर समाप्त होता है, उसका उपयोग वैसे ही किया जाता है। endpoint दर्ज करने से पहले, NexCMP सर्वर से उसे एक रिक्वेस्ट भेजें। choices[0].message.content वाला JSON उत्तर यह बताता है कि endpoint और मॉडल काम कर रहे हैं।

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"}]}'

AI Agent कमांड कैसे चलाता है, और यह अपने आप क्या नहीं चलाएगा

  • कमांड पैनल सर्वर से उसके अपने ssh क्लाइंट द्वारा चलते हैं, एक बार में एक नॉन-इंटरैक्टिव कमांड। टार्गेट हमेशा डेटाबेस से VM का IP पता होता है, न कि रिक्वेस्ट से लिया गया कोई पता।
  • संग्रहीत पासवर्ड प्रोसेस एनवायरनमेंट में वन-शॉट SSH_ASKPASS हेल्पर के माध्यम से पास किया जाता है: इसे डिस्क पर नहीं लिखा जाता और न ही कमांड लाइन पर डाला जाता है।
  • प्रत्येक कमांड का आउटपुट 200 KB तक सीमित है, एक टर्न अधिकतम 10 चरणों के बाद समाप्त होता है, और एक ग्राहक एक समय में अधिकतम 2 एजेंट रन सक्रिय रख सकता है।
  • Confirm मोड में प्रत्येक कमांड ग्राहक द्वारा Run दबाने की प्रतीक्षा करता है। Auto मोड में केवल एक सख्त रीड-ओनली सूची के कमांड, उदाहरण के लिए df -h, ps या journalctl, अपने आप चलते हैं।
  • फ़ाइलों को ओवरराइट या डिलीट करने वाले, अकाउंट्स या SSH keys बदलने वाले, किसी बाहरी सर्वर पर डेटा भेजने वाले, स्क्रिप्ट डाउनलोड करके चलाने वाले, या मशीन को शट डाउन या रीस्टार्ट करने वाले कमांड Auto मोड में भी हमेशा Needs confirmation दिखाते हैं।
  • कमांड आउटपुट मॉडल को अविश्वसनीय डेटा के रूप में दिखाया जाता है, और इसके अंदर मिले निर्देशों का पालन नहीं किया जाता है।

समस्या निवारण

वे संदेश जो आपको सबसे अधिक देखने को मिल सकते हैं, और क्या जांचना है।

  • Test connection 401 के साथ विफल होता है

    संभावित कारण
    उस endpoint के लिए key गलत है।
    क्या करें
    key और endpoint की जाँच करें, और यदि आपने बेस URL बदला है तो key फिर से दर्ज करें।

  • Test connection 404 या model not found के साथ विफल होता है

    संभावित कारण
    गलत पाथ या मॉडल id।
    क्या करें
    जाँचें कि बेस URL /v1 पर समाप्त होता है और प्रदाता की सटीक मॉडल id का उपयोग करें।

  • पोर्टल में कोई AI मेनू नहीं दिखता है

    संभावित कारण
    मॉड्यूल बंद है, या प्रदाता उपयोग के लिए चालू नहीं है।
    क्या करें
    License › Modules में AI मॉड्यूल चालू करें और प्रदाता को सक्षम करें।

  • Agent लॉग इन नहीं कर सका

    संभावित कारण
    उस VM के लिए कोई सहेजा गया पासवर्ड और कोई ऑपरेशन्स कुंजी नहीं है।
    क्या करें
    पोर्टल में VM पासवर्ड रीसेट करें ताकि यह फिर से सहेज लिया जाए।

  • सर्वर ने समय पर उत्तर नहीं दिया

    संभावित कारण
    फ़ायरवॉल, SSH द्वारा लिसन न किया जाना, या व्यस्त VM।
    क्या करें
    पैनल सर्वर से nc -vz <vm-ip> 22 चलाएं और VM में sshd शुरू करें।

  • AI बहुत धीमी गति से प्रतिक्रिया दे रहा है

    संभावित कारण
    प्रोवाइडर या मॉडल धीमा है।
    क्या करें
    Settings › AI provider में किसी तेज़ मॉडल या कम Reasoning effort का उपयोग करें।

  • AI Chat का उपयोग करने के लिए साइन इन करें

    संभावित कारण
    विज़िटर साइन इन नहीं है।
    क्या करें
    अपेक्षित: AI Chat केवल साइन-इन किए हुए ग्राहकों के लिए है।

गोपनीयता और लागत

ग्राहकों के प्रश्न, और AI द्वारा उस ग्राहक के लिए पढ़ा जाने वाला डेटा (read-only), आपके AI प्रोवाइडर को भेजा जाता है। अपनी गोपनीयता नीति में यह स्पष्ट करें।

NexCMP AI लागत को मीटर नहीं करता है। खर्च को सीमित करने के लिए अपने प्रोवाइडर के बजट फ़ीचर्स का उपयोग करें, और प्रति दिन प्रति ग्राहक AI टर्न सेटिंग (डिफ़ॉल्ट रूप से 40, Customers › Support › Ticket › AI settings के अंतर्गत) को कम करें।

आगे क्या करें

जब तक आप प्रोवाइडर key सेव नहीं करते, AI Chat और AI Agent बंद रहते हैं, इसलिए आपके निर्णय लेने से पहले आपसे कोई शुल्क नहीं लिया जाता और न ही कहीं कुछ भेजा जाता है। विवरण पढ़ें, या अन्य मॉड्यूल देखें।

AI मॉड्यूल के बारे में प्रश्न

कौन-से AI मॉडल काम करते हैं?
OpenAI-संगत chat-completions एंडपॉइंट पर काम करने वाला कोई भी मॉडल जो टूल (फ़ंक्शन) कॉलिंग का समर्थन करता हो। आप Admin › Settings › AI provider में एंडपॉइंट, की और मॉडल सेट करते हैं।
क्या एजेंट अन्य ग्राहकों के सर्वर तक पहुंच सकता है?
नहीं। AI Agent केवल साइन-इन किए हुए ग्राहक के खाते से जुड़े VMs पर ही काम करता है, जिसके लिए उस VM के सहेजे गए लॉगिन का उपयोग किया जाता है।
क्या NexCMP AI के लिए कोई शुल्क लेता है?
नहीं। AI मॉड्यूल लाइसेंस में शामिल हैं। आप जिस की को कॉन्फ़िगर करते हैं, उसके उपयोग के लिए आप अपने AI प्रोवाइडर को भुगतान करते हैं।
मैं AI प्रोवाइडर कनेक्शन का परीक्षण कैसे करूँ?
Admin › Settings › AI provider में Save दबाएं, फिर Test connection। यह एक संक्षिप्त प्रश्न भेजता है और मॉडल के नाम और लगे समय के साथ Connected दिखाता है, या प्रोवाइडर द्वारा दिया गया एरर दिखाता है।
क्या AI Agent को एक अलग SSH गेटवे की आवश्यकता होती है?
नहीं। डिफ़ॉल्ट इंस्टॉलेशन में पैनल अपने स्वयं के ssh क्लाइंट का उपयोग करता है। वैकल्पिक ssh-proxy वेब टर्मिनल का उपयोग केवल तब किया जाता है जब वेब SSH फ़ीचर सक्षम हो।
क्या जो विज़िटर साइन इन नहीं हैं वे AI Chat का उपयोग कर सकते हैं?
नहीं। AI Chat केवल साइन-इन किए हुए ग्राहकों के लिए है; जो विज़िटर साइन इन नहीं है, उसे पहले साइन इन करने के लिए कहा जाता है।
क्या AI Agent Windows VMs पर काम करता है?
नहीं। यह चल रहे Linux VMs पर काम करता है; Windows VMs को अस्वीकार कर दिया जाता है।
क्या मैं इसे बंद कर सकता हूँ?
हाँ। License › Modules में AI मॉड्यूल को बंद करें; AI Chat और AI Agent पोर्टल से हट जाते हैं और उनका API उत्तर देता है कि मॉड्यूल अक्षम है।

संदर्भ

इस गाइड में उल्लिखित विनिर्देश।

अपने क्लाउड में AI जोड़ें

AI Chat और AI Agent हर NexCMP लाइसेंस में शामिल हैं — पहले वर्ष के लिए निःशुल्क, या सोर्स कोड के साथ $499 एकमुश्त।

NexCMP मुफ़्त प्राप्त करेंसेल्स से संपर्क करेंडेमो देखें

अंतिम अपडेट: