JA
NexCMP を無料で入手
NexCMP 1.6.1 に適用·更新日 ·Markdownとして表示

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で接続し、「システムの状態を確認する」、「Dockerをインストールする」、「最近のエラーを見つける」、「ディスク空き容量を増やす」といった平易な言葉で記述されたタスクを実行します。提案するすべてのコマンドとその出力が表示されます。読み取り専用コマンドは自動実行できますが、サーバーを変更する操作は、お客様が 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ターミナルは必要ありません。オプションの web SSH 機能 (feature_ssh_web) が有効化され、ssh-proxy サービスがインストールされている場合のみ、エージェントは ssh-proxy を経由します。
ネットワークパネルサーバーからVMのIPのSSHポート（デフォルトでは22）に到達できる必要があります。パネルとゲストネットワーク間のファイアウォールとセキュリティグループを確認してください。
VMお客様所有で、実行中、ロックされておらず、パブリックまたは到達可能なIPアドレスを持つLinux（Windows VMは拒否されます）。
SSH認証情報NexCMPによって保存されたVMのログインユーザーとパスワード（VMの作成時またはパスワードのリセット時に暗号化して保存）、またはインストールされている場合はパネルのオペレーションキー。どちらも存在しない場合、エージェントはログインできないことを伝えます。

インフラストラクチャの準備 ​

  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 での接続 ​

  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 クライアントを使用し、1回に1つの非対話型コマンドを実行します。ターゲットはリクエストからではなく常にデータベースからのVMのIPであり、所有者自身の実行中でロックされていないVMのみに到達可能です。

  • 認証: 保存されたパスワードは、プロセス環境内のワンショット SSH_ASKPASS ヘルパーを介して渡されます。ディスクへの書き込みやコマンドラインへの配置は行われません。ホストキーのピン留めは行われません（VMは新しいキーで再インストールされます）。コマンドごとの出力は最大200 KBに制限され、各コマンドには制限時間（60秒）があります。

  • エージェントループ: AIがコマンドを提案して出力を読み取ります。1ターンの終了は最大10ステップです。

  • モード:

    モード動作
    Confirmすべてのコマンドが Run を待ちます。
    Auto厳格な読み取り専用の許可リストを通過するコマンドのみが自動的に実行されます（例: 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）。

制限と注意事項 ​

  • 日次制限: 顧客1人あたり1日（UTC）300回のAI呼び出し。00:00 UTCにリセットされます。使い切ると、エージェントは "Daily AI quota reached" と返答します。
  • 同時実行数: 顧客あたり同時に最大2つのエージェント実行。セッションは一度に1ターンを実行します。
  • セッション: セッションあたり最大100メッセージ、1メッセージあたり4,000文字。セッションは1つのVMに属し、VMが削除または転送されると、古いセッションは読み取り専用になります。
  • ロック中または停止中のVM、あるいはWindows: VMは Locked、Stopped、Windows または No address として表示され、選択できません。
  • なりすまし: 顧客になりすましている管理者は、エージェントの資格情報機能を使用できません（Log in as a customerを参照）。
  • 責任: エージェントはミスをする可能性があります。ポータルでは、実行前にコマンドを確認するよう顧客に伝えます。承認したコマンドの責任は顧客にあることを利用規約に記載してください。
  • AIモジュールをオフにすると、エージェントのエントリが削除され、ルートは404を返します module_disabled。

トラブルシューティング ​

症状原因対処法
"パネルサーバーにsshクライアントがインストールされていません (apt install openssh-client)"ssh バイナリが存在しないsudo apt-get install -y openssh-client.
"エージェントがログインできませんでした" / ssh: no saved credentials for this VM保存されたパスワードと操作キーがないポータルでVMのパスワードをリセットして再度保存するか、操作キーをインストールします。
"サーバーが時間内に応答しませんでした"ファイアウォール、SSHがリッスンしていない、VMがビジーパネルサーバーから nc -vz <ip> 22 をテストします。VMで sshd を開始します。
"このサーバーのSSHに接続できませんでした"ルーティングまたはセキュリティグループパネルサーバーからポート 22 で VM に到達できるようにします。
"VMが実行されていません" / "アクセス権限がありません"VMが停止中、ロック中、削除済み、または別のお客様のものです起動するか、ロックを解除するか、別のものを選択します。
"利用できません: N (停止中、ロック中、またはWindows)"上記の理由VMは Linux で、実行中である必要があります。
"SSHゲートウェイは一時的に利用できません"Web SSH機能が有効ですが、ssh-proxyが停止していますssh-proxyを起動するか、内蔵 SSH を使用するために Web SSH機能をオフにします。
"AIの応答が遅すぎます (90秒以上)"プロバイダーの応答が遅いより高速なモデルを使用するか、Reasoning effortを下人にしてください。
"一日のAI利用枠に達しました"300 回の呼び出しが使用されました00:00 UTC まで待ちます。
"このセッションはまだ実行中です"別のターンが進行中です待つか、Stopを押します。