AI Agent

एडमिन में कहाँ: System › Settings › AI provider (/settings/ai) — मॉड्यूल स्विच और प्रदाता; System › Admin › License & updates (/license) — मॉड्यूल स्विच। पोर्टल में कहाँ: AI Agent (/ai/agent) और पृष्ठ /chat/agent, या चैट के भीतर मोड Agent।

यह क्या करता है

AI Agent किसी ग्राहक के अपने Linux VM से SSH पर कनेक्ट होता है और सादी भाषा में बताए गए कार्यों को पूरा करता है: "check system health", "install Docker", "find recent errors", "free up disk space"। यह अपने द्वारा सुझाए गए प्रत्येक कमांड और उसके आउटपुट को दिखाता है। केवल पढ़ने वाले कमांड अपने आप चल सकते हैं; सर्वर को बदलने वाली किसी भी चीज़ के लिए ग्राहक को Run दबाना होता है।

आवश्यकताएं

आइटम	आवश्यकता
AI मॉड्यूल और प्रदाता	AI मॉड्यूल चालू है और एक काम करने वाला AI provider है। एजेंट को ऐसे मॉडल की भी आवश्यकता है जो टूल कॉलिंग का समर्थन करता हो।
पैनल सर्वर पर openssh-client	एजेंट पैनल के अपने ssh प्रोग्राम (/usr/bin/ssh) के साथ कमांड चलाता है। इंस्टॉलर openssh-client इंस्टॉल करता है; ssh -V से जांच करें। इसके बिना एजेंट "ssh client is not installed on the panel server" रिपोर्ट करता है।
कोई अलग SSH गेटवे नहीं	डिफ़ॉल्ट इंस्टॉलेशन में अंतर्निहित SSH का उपयोग किया जाता है और ssh-proxy वेब टर्मिनल की आवश्यकता नहीं होती है। केवल जब वैकल्पिक web SSH फ़ीचर (feature_ssh_web) सक्षम किया गया हो और ssh-proxy सेवा इंस्टॉल की गई हो, तब एजेंट इसके बजाय ssh-proxy के माध्यम से जाता है।
नेटवर्क	पैनल सर्वर को अपने SSH पोर्ट (डिफ़ॉल्ट रूप से 22) पर VM के IP तक पहुँचना चाहिए। पैनल और गेस्ट नेटवर्क के बीच फ़ायरवॉल और सुरक्षा समूहों की जाँच करें।
VM	ग्राहक के स्वामित्व वाला, चल रहा, लॉक नहीं, Linux (Windows VM अस्वीकार किए जाते हैं), सार्वजनिक या पहुँच योग्य IP पते के साथ।
SSH क्रेडेंशियल्स	NexCMP द्वारा संग्रहीत VM का लॉगिन उपयोगकर्ता और पासवर्ड (VM बनाए जाने पर या उसका पासवर्ड रीसेट होने पर सहेजा गया, एन्क्रिप्टेड), या पैनल की ऑपरेशन कुंजी यदि इंस्टॉल की गई है। यदि दोनों में से कोई भी मौजूद नहीं है तो एजेंट कहता है कि वह लॉगिन नहीं कर सकता।

बुनियादी ढांचा तैयार करें

1. पैनल सर्वर पर SSH क्लाइंट की जाँच करें:

   ssh -V
   sudo apt-get install -y openssh-client   # only if missing

2. जाँच करें कि पैनल सर्वर गेस्ट VM पर SSH खोल सकता है:

   nc -vz 198.51.100.10 22

   पते को किसी परीक्षण VM के IP से बदलें। यदि यह विफल हो जाता है, तो पहले रूटिंग या फ़ायरवॉल को ठीक करें।

3. सुनिश्चित करें कि गेस्ट NexCMP द्वारा संग्रहीत उपयोगकर्ता के लिए पासवर्ड लॉगिन की अनुमति देता है (कुछ क्लाउड इमेज इसे अक्षम करती हैं), या पैनल की ऑपरेशन कुंजी गेस्ट पर इंस्टॉल है।

NexCMP में कनेक्ट करें

1. पूर्ण AI provider: मॉड्यूल चालू, प्रदाता सहेजा गया, Test connection हरा।
2. एडमिन साइड पर कुछ और कॉन्फ़िगर नहीं किया गया है। मॉड्यूल स्विच से ग्राहक पोर्टल में AI Agent प्रविष्टियाँ दिखाई देने लगती हैं।
3. एक ग्राहक के रूप में: AI Agent खोलें, एक चल रहे सर्वर को चुनें और Choose server पर क्लिक करें। पृष्ठ पहले एक निश्चित हानिरहित कमांड के साथ SSH की जाँच करता है (कोई AI कॉल उपयोग नहीं किया जाता है) और SSH connected या इसके विफल होने का कारण दिखाता है।
4. कोई टास्क टाइप करें या कोई क्विक स्टार्ट चुनें (Check system health, Install Docker, Install Nginx, Find recent errors, Security check, Free up disk space)।

यह कमांड्स कैसे चलाता है

• कहाँ से: पैनल सर्वर से, सिस्टम ssh क्लाइंट के साथ, एक बार में एक नॉन-इंटरैक्टिव कमांड। टारगेट हमेशा डेटाबेस से VM का IP होता है, अनुरोध (request) से नहीं; केवल मालिक की अपनी चल रही, अनलॉक VM तक ही पहुँचा जा सकता है।

• प्रमाणन (Authentication): संग्रहीत पासवर्ड को प्रोसेस एनवायरनमेंट में एक वन-शॉट SSH_ASKPASS हेल्पर के माध्यम से पास किया जाता है — इसे डिस्क पर नहीं लिखा जाता और न ही कमांड लाइन पर रखा जाता है। होस्ट की पिन नहीं किए जाते हैं (VM को नए की के साथ रीइंस्टॉल किया जाता है)। प्रति कमांड आउटपुट 200 KB तक सीमित है और प्रत्येक कमांड की समय सीमा (60 सेकंड) होती है।

• Agent लूप: AI कमांड का प्रस्ताव रखता है और आउटपुट पढ़ता है; एक टर्न अधिकतम 10 चरणों के बाद समाप्त होता है।

• मोड:

  मोड	व्यवहार
  Confirm	हर कमांड Run का इंतज़ार करती है।
  Auto	केवल वे कमांड जो एक सख्त रीड-ऑलरेडी अनुमति-सूची (allow-list) को पास करती हैं, अपने आप चलती हैं (उदाहरण के लिए df -h, ps, journalctl)। इसके अलावा कुछ भी, और ऐसा कुछ भी जिसे पार्सर निश्चितता के साथ विश्लेषण नहीं कर सकता (वेरिएबल, कमांड सबस्टीट्यूशन, फ़ाइलों के रिडायरेक्ट), Run का इंतज़ार करता है।

• रिस्क लेबल: जो कमांड फ़ाइलों को ओवरराइट या डिलीट करती हैं, डिस्क पर लिखती हैं, अकाउंट या SSH की बदलती हैं, किसी बाहरी सर्वर को डेटा भेजती हैं, रॉ नेटवर्क कनेक्शन खोलती हैं, ओफ़्फ़स्केटेड कोड चलाती हैं, कोई स्क्रिप्ट डाउनलोड करके चलाती हैं, मशीन को बंद या पुनरारंभ करती हैं, या अन्य सर्वरों तक पहुँचती हैं, वे Auto मोड में भी हमेशा Needs_confirmation दिखाती हैं।

• अविश्वसनीय आउटपुट: कमांड आउटपुट को मॉडल को अविश्वसनीय डेटा के रूप में दिखाया जाता है; इसके अंदर के निर्देशों का पालन नहीं किया जाता है।

सत्यापित करें

1. चल रही कोई टेस्ट VM चुनें। पेज पर SSH connected दिखाई देता है।
2. "Check CPU, RAM and disk" पूछें। Auto मोड में रीड-ऑलरेडी कमांड चलती हैं और उत्तर उनका सारांश देता है।
3. "Install Nginx" पूछें। इंस्टॉल कमांड Run और Skip के साथ दिखाई देती है; जब तक आप Run नहीं दबाते, कुछ नहीं चलता।
4. शीर्ष पर काउंटर आज उपयोग की गई AI कॉल की संख्या दिखाता है (उदाहरण के लिए 3/300)।

Limits & notes

• दैनिक सीमा: प्रति ग्राहक प्रति दिन (UTC) 300 AI कॉल; यह 00:00 UTC पर रीसेट हो जाती है। जब यह समाप्त हो जाती है तो Agent "Daily AI quota reached" उत्तर देता है।
• समवर्तीता (Concurrency): एक ही समय में प्रति ग्राहक अधिकतम 2 Agent रन; एक सत्र एक समय में एक टर्न चलाता है।
• सत्र: प्रति सत्र अधिकतम 100 संदेश, प्रति संदेश 4,000 वर्ण। एक सत्र एक VM से संबंधित है; यदि VM डिलीट या ट्रांसफर कर दी जाती है, तो पुराना सत्र रीड-ऑलरेडी हो जाता है।
• लॉक या बंद VM, या Windows: VM को Locked, Stopped, Windows या No address के रूप में दिखाया जाता है और इसे चुना नहीं जा सकता।
• इम्पोर्नेशन: ग्राहक का रूप धारण करने वाला एडमिनिस्ट्रेटर Agent की क्रेडेंशियल सुविधाओं का उपयोग नहीं कर सकता है (देखें Log in as a customer)।
• जिम्मेदारी: Agent गलतियाँ कर सकता है। पोर्टल ग्राहकों को कमांड चलाने से पहले उनकी समीक्षा करने के लिए कहता है। अपने नियमों (terms) में ग्राहकों को बताएं कि वे अपने द्वारा स्वीकृत कमांड के लिए स्वयं जिम्मेदार हैं।
• AI मॉड्यूल को बंद करने से Agent प्रविष्टियाँ हट जाती हैं और रूट 404 module_disabled उत्तर देते हैं।

ट्रबलशूटिंग

लक्षण	कारण	सुधार
"पैनल सर्वर पर ssh क्लाइंट स्थापित नहीं है (apt install openssh-client)"	कोई ssh बाइनरी नहीं	sudo apt-get install -y openssh-client.
"Agent लॉगिन नहीं कर सका" / ssh: no saved credentials for this VM	कोई संग्रहीत पासवर्ड और कोई ऑपरेशंस की नहीं	पोर्टल में VM पासवर्ड रीसेट करें ताकि यह फिर से सहेज जाए, या ऑपरेशंस की इंस्टॉल करें।
"सर्वर ने समय पर उत्तर नहीं दिया"	फ़ायरवॉल, SSH सुस्त नहीं है, VM व्यस्त है	पैनल सर्वर से nc -vz <ip> 22 का परीक्षण करें; VM में sshd शुरू करें।
"इस सर्वर पर SSH तक नहीं पहुँचा जा सका"	राउटिंग या सुरक्षा समूह	पैनल सर्वर को पोर्ट 22 पर VM तक पहुँचने की अनुमति दें।
"VM नहीं चल रहा है" / "निषिद्ध (Forbidden)"	VM रुका हुआ, लॉक, हटाया गया या ग्राहक का नहीं है	इसे शुरू करें, अनलॉक करें या दूसरा चुनें।
"उपलब्ध नहीं: N (रुका हुआ, लॉक या Windows)"	ऊपर दिए गए कारण	VM Linux और चालू स्थिति में होना चाहिए।
"SSH गेटवे अस्थायी रूप से अनुपलब्ध है"	Web SSH सुविधा सक्षम है लेकिन ssh-proxy बंद है	बिल्ट-इन SSH का उपयोग करने के लिए ssh-proxy को शुरू करें, या Web SSH सुविधा बंद करें।
"AI बहुत धीमी प्रतिक्रिया दे रहा है (90 सेकंड से अधिक)"	प्रदाता धीमा है	तेज़ मॉडल या कम Reasoning effort का उपयोग करें।
"दैनिक AI कोटा समाप्त हो गया"	300 कॉल उपयोग किए गए	00:00 UTC तक प्रतीक्षा करें।
"यह सत्र अभी भी चल रहा है"	एक अन्य टर्न प्रगति पर है	प्रतीक्षा करें या Stop दबाएँ।