---
title: AIプロバイダー
description: AI ChatおよびAI Agent用のOpenAI互換AIエンドポイントを接続します。AIモジュールのオン、エンドポイントとキーの入力、テスト、制限の設定を行います。
url: https://nexcmp.com/ja/docs/ai/ai-providers/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# AIプロバイダー {#ai-provider}

> **管理画面での位置:** System › Settings › AI provider (`/settings/ai`)。AIモジュールのスイッチはそこおよび System › Admin › License & updates (`/license`) のカード **Module**にあります。

## 動作内容 {#what-it-does}

AI Chat（自動サポートチャット）およびAI Agent（平易な言葉でのVM管理）には、組み込みモデルは付属していません。**独自のプロバイダー**を選択します：**OpenAI互換**の`chat/completions` APIを提供する任意のサービス（OpenAI、OpenRouter、LiteLLMゲートウェイ、または独自のvLLMサーバーなど）を利用できます。NexCMPはエンドポイントとAPIキーを（暗号化して）保存し、すべてのAI機能で使用します。料金はプロバイダーに直接お支払いいただきます。

## 要件 {#requirements}

| 項目 | 要件 |
|---|---|
| Endpoint | OpenAI互換のベースURL（`https://api.openai.com/v1`、`https://ai.example.com/v1`）。NexCMPは、`/chat/completions`で終わるURLには`/v1`を追加し、その他のURLには`/v1/chat/completions`を追加します。すでに`/chat/completions`で終わっているURLはそのまま使用されます。 |
| モデル | **ツール（関数）呼び出し**をサポートするモデル。AI Chatとエージェントの両方がこれに依存します。 |
| API キー | そのエンドポイント用のキー。プロバイダー側で**利用上限（スペンディングキャップ）**が設定されたキー（月額予算付きのLiteLLM仮想キーなど）を推奨します。 |
| ネットワーク | パネルサーバーはHTTP(S)経由でエンドポイントに到達できる必要があります。フォームに入力するURLは、ポート80、443、8080、8443のインターネット宛てのみ許可されます。内部アドレスを使用するには、まずプロバイダーを保存してからテストしてください。 |
| 依存関係 | **AI**モジュールを有効にします。エージェントについては[AI Agent](https://nexcmp.com/ja/docs/ai/ai-agent/#requirements)を参照してください。 |

## インフラストラクチャの準備 {#prepare-the-infrastructure}

1. プロバイダーにサインアップしてAPIキーを作成します。プロバイダーが予算やレート制限をサポートしている場合は、月額制限を設定します。
2. **ベースURL**と正確な**モデル名**（およびオプションで最大4つのフォールバックモデル）をメモします。
3. 入力する前にNexCMPサーバーからテストします:

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

   `choices[0].message.content`を含むJSONの回答は、エンドポイントが機能していることを示します。

## NexCMP での接続 {#connect-in-nexcmp}

1. **System › Settings › AI provider**を開きます。
2. カード**Module AI**でモジュールを**オン**に切り替えます。オンにするまで、お客様はポータルでAI ChatやAI Agentを見ることができません。（**License & updates**でも切り替えることができます。）
3. カード**Connection**で以下を入力します:

   | 項目 | Example | 備考 |
   |---|---|---|
   | このプロバイダーを使用 | on | オンにするには、ベースURL、モデル、キーが必要です。 |
   | 表示名 | `LiteLLM` | 最大60文字。 |
   | ベースURL（OpenAI互換） | `https://ai.example.com/v1` | `http://`または`https://`、最大300文字、スペースなし。 |
   | プロバイダーAPIキー | `sk-XXXX` | 暗号化されて保存され、その後は末尾4文字のみが表示されます。保存されたキーを維持するには空のままにします。 |
   | デフォルトモデル | `gpt-4o-mini` | 文字、数字、および`- _ . / : @`。 |
   | フォールバックモデル | `gemini-2.5-flash` | カンマ区切り、最大4つ。デフォルトモデルが失敗したときに使用されます。 |
   | 推論の度合い | デフォルト（送信しない） | `Minimal`、`Low`、`Medium`、または`High`。推論モデル（Gemini、oシリーズ）の場合、低いレベルにすると応答が大幅に高速化されます。通常のモデルではデフォルトのままにします。 |

4. **Save**をクリックし、次に**Test connection**をクリックします。テストでは短い質問を1つ送信し、`Connected — <model>, <ms> ms`またはプロバイダーから返されたエラーを表示します。

![AIモジュールが有効になり、接続フォームにサンプル値が入力された状態のAI providerページ](https://nexcmp.com/ja/docs/images/ai/ai-providers-01-connection.webp)


### 保存の動作 {#what-saving-does}

- プロバイダーの設定は1つの設定エントリとして保存され、キーはインストールのマスターキーを使用してこの目的にバインドされたAES-256-GCMで暗号化されます。
- サポート設定の**Primary model**と**Fallback model**（AI Chatで使用）は、デフォルトモデルと最初のフォールバックモデルに自動的に設定されます。
- 変更は監査ログに記録されます（エンドポイント、モデル、キーが変更されたかどうか。キー自体は記録されません）。

## 確認 {#verify}

1. **Test connection**が緑色に表示されます。
2. テスト顧客としてポータルにサインインします。メニューに**AI Chat**（またはチャットバブル）と**AI Agent**が表示されます。
3. AI Chatに「残高はいくらですか？」と質問します。実際の残高を引用した回答が表示されれば、プロバイダーがツール呼び出しを正しく処理していることを示します。

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

- **単一のプロバイダー。** NexCMPは、Chat、Agent、およびチケット調査用に、設定された単一のプロバイダーを使用します。フォールバックモデルにより、そのプロバイダー内での耐障害性が向上します。
- **キーの安全性。** 保存されたキーは、保存されたエンドポイントにのみ送信されます。ベースURLを変更する場合は、テストする前にキーを再入力する必要があります。
- **顧客ごとの制限。** AI Chatはログイン中の顧客専用で、分単位およびチャットごとのメッセージ制限があります。AI Agentにはアカウントごとの1日の呼び出し制限があります。[AI Chat](https://nexcmp.com/ja/docs/ai/ai-chat/)および[AI Agent](https://nexcmp.com/ja/docs/ai/ai-agent/)を参照してください。
- **プライバシー。** 顧客からの質問およびAIがその顧客のために読み取るデータ（読み取り専用）はお使いのプロバイダーに送信されます。[プライバシーポリシー](https://nexcmp.com/ja/docs/customers/legal/)にその旨を記載してください。
- **コスト管理。** NexCMPはAIのコストを計測しません。プロバイダーの予算機能を使用してください。
- モジュールはいつでもオフにできます：AIメニュー項目が消え、AIルートは404を返します`module_disabled`。AI Chatの一部バックグラウンドジョブ（チケット調査、遅延返信）はそのパネルの次回の再起動時に変更を反映します。

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

| 症状 | 原因 | 対処法 |
|---|---|---|
| `base_url must be an http(s) URL` | スキームの欠落またはスペース | `https://host/v1` を使用します。 |
| `api_key is required to enable the provider` | キーが保存されていません | キーを入力して保存します。 |
| `base_url and model are required to enable the provider` | 空のフィールド | 両方に入力してください。 |
| "Base URLがブロックされました: パブリックhttp(s)のみ、ポート80/443/8080/8443" | 保存されていない内部アドレスまたは他のポートのテスト | 最初にプロバイダーを保存してからテストしてください。 |
| `api_key is required (enter the key again when you change the endpoint)` | Base URLが保存されているものと異なります | キーを再入力します。 |
| `model: letters, digits and - _ . / : @` | 無効な文字 | プロバイダーの正確なモデルIDを使用してください。 |
| `fallback_models: up to 4 model names` | 多すぎます | 4個以下に維持してください。 |
| 401エラーでテストが失敗する | キーが正しくありません | キーとエンドポイントを確認してください。 |
| 404または「model not found」でテストが失敗する | パスまたはモデルが間違っています | ベースURL（`/v1`）とモデルIDを確認してください。 |
| `Too many tests — wait a minute` (429) | 1分間に10回を超えるテスト | お待ちください。 |
| ポータルにAIメニューが表示されない | モジュールがオフであるか、プロバイダーが「in use」になっていません | モジュールをオンにし、プロバイダーを有効にしてください。 |