---
title: AI Agent
description: お客様が平易な言葉でタスクを記述してLinux VMを管理できるようにします。AI AgentがSSH経由で接続する方法、独自に実行できる処理、および事前準備について解説します。
url: https://nexcmp.com/ja/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で接続し、「システムの状態を確認する」、「Dockerをインストールする」、「最近のエラーを見つける」、「ディスク空き容量を増やす」といった平易な言葉で記述されたタスクを実行します。提案するすべてのコマンドとその出力が表示されます。読み取り専用コマンドは自動実行できますが、サーバーを変更する操作は、お客様が **Run** を押すまで待機します。

## 要件 {#requirements}

| 項目 | 要件 |
|---|---|
| AIモジュールとプロバイダー | **AI**モジュールが有効であり、動作する[AI provider](https://nexcmp.com/ja/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ターミナルは**必要ありません**。オプションの *web SSH* 機能 (`feature_ssh_web`) が有効化され、`ssh-proxy` サービスがインストールされている場合のみ、エージェントは `ssh-proxy` を経由します。 |
| ネットワーク | パネルサーバーからVMのIPのSSHポート（デフォルトでは22）に到達できる必要があります。パネルとゲストネットワーク間のファイアウォールとセキュリティグループを確認してください。 |
| VM | お客様所有で、**実行中**、ロックされておらず、パブリックまたは到達可能なIPアドレスを持つ**Linux**（Windows VMは拒否されます）。 |
| 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/ja/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` クライアントを使用し、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** が表示されます。
- **信頼できない出力:** コマンドの出力は信頼できないデータとしてモデルに表示され、その中にある指示には従いません。

## 確認 {#verify}

1. 実行中のテスト用VMを選択します。ページに *SSH connected* が表示されます。
2. "Check CPU, RAM and disk" と質問します。Autoモードでは読み取り専用のコマンドが実行され、その回答がまとめられます。
3. "Install Nginx" と質問します。インストールコマンドが **Run** および **Skip** とともに表示され、**Run** を押すまで何も実行されません。
4. 上部のカウンターには、その日に使用されたAI呼び出しの数が表示されます（例: `3/300`）。

## 制限と注意事項 {#limits-notes}

- **日次制限:** 顧客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](https://nexcmp.com/ja/docs/customers/login-as/)を参照）。
- **責任:** エージェントはミスをする可能性があります。ポータルでは、実行前にコマンドを確認するよう顧客に伝えます。承認したコマンドの責任は顧客にあることを利用規約に記載してください。
- AIモジュールをオフにすると、エージェントのエントリが削除され、ルートは404を返します `module_disabled`。

## トラブルシューティング {#troubleshooting}

| 症状 | 原因 | 対処法 |
|---|---|---|
| "パネルサーバーに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**を押します。 |