---
title: AI Agent
description: ग्राहकों को सादी भाषा में कोई कार्य बताकर अपने Linux VM को प्रबंधित करने दें — एजेंट SSH के माध्यम से कैसे कनेक्ट होता है, यह अपने आप क्या चला सकता है, और आपके पास क्या होना चाहिए।
url: https://nexcmp.com/hi/docs/ai/ai-agent/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# AI Agent {#ai-agent}

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

## यह क्या करता है {#what-it-does}

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

## आवश्यकताएं {#requirements}

| आइटम | आवश्यकता |
|---|---|
| AI मॉड्यूल और प्रदाता | **AI** मॉड्यूल चालू है और एक काम करने वाला [AI provider](https://nexcmp.com/hi/docs/ai/ai-providers/) है। एजेंट को ऐसे मॉडल की भी आवश्यकता है जो टूल कॉलिंग का समर्थन करता हो। |
| पैनल सर्वर पर `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 बनाए जाने पर या उसका पासवर्ड रीसेट होने पर सहेजा गया, एन्क्रिप्टेड), या पैनल की ऑपरेशन कुंजी यदि इंस्टॉल की गई है। यदि दोनों में से कोई भी मौजूद नहीं है तो एजेंट कहता है कि वह लॉगिन नहीं कर सकता। |

## बुनियादी ढांचा तैयार करें {#prepare-the-infrastructure}

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

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

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

   ```bash
   nc -vz 198.51.100.10 22
   ```

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

## NexCMP में कनेक्ट करें {#connect-in-nexcmp}

1. पूर्ण [AI provider](https://nexcmp.com/hi/docs/ai/ai-providers/): मॉड्यूल चालू, प्रदाता सहेजा गया, **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*)।



## यह कमांड्स कैसे चलाता है {#how-it-runs-commands}

- **कहाँ से:** पैनल सर्वर से, सिस्टम `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** दिखाती हैं।
- **अविश्वसनीय आउटपुट:** कमांड आउटपुट को मॉडल को अविश्वसनीय डेटा के रूप में दिखाया जाता है; इसके अंदर के निर्देशों का पालन नहीं किया जाता है।

## सत्यापित करें {#verify}

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

## Limits & notes {#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](https://nexcmp.com/hi/docs/customers/login-as/))।
- **जिम्मेदारी:** Agent गलतियाँ कर सकता है। पोर्टल ग्राहकों को कमांड चलाने से पहले उनकी समीक्षा करने के लिए कहता है। अपने नियमों (terms) में ग्राहकों को बताएं कि वे अपने द्वारा स्वीकृत कमांड के लिए स्वयं जिम्मेदार हैं।
- AI मॉड्यूल को बंद करने से Agent प्रविष्टियाँ हट जाती हैं और रूट 404 `module_disabled` उत्तर देते हैं।

## ट्रबलशूटिंग {#troubleshooting}

| लक्षण | कारण | सुधार |
|---|---|---|
| "पैनल सर्वर पर 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** दबाएँ। |