Cloud Exchangeには、プラットフォームの構成と運用を支援する一連のAI機能が含まれています。これらの機能は、モジュールの構成中にプラグインとフィールド値を推奨したり、プラグインのフィールドをRisk Exchangeスキーマにマッピングしたり、プラットフォームのログを読み取って何が問題で何をするべきか説明したりできます。
重要
- AI機能を使用するには、LLMプロバイダー プラグインが設定および有効になっている必要があります。詳細はこちら。
- AI機能によって生成されたすべての結果は提案であり、確認した上で適切に適用してください。AI自体がCloud Exchangeに変更を加えることはありません。AIの応答時間は、質問の複雑さによって異なります。
Cloud ExchangeのAI機能
| 特徴 | それを使う場所 | その機能 |
|---|---|---|
| AI Copilot | すべてのCloud Exchangeページで利用可能なコパイロットアイコン | 現在表示しているページに関する質問に回答し、設定手順をステップバイステップで案内します。また、あらかじめ定義されたルールに基づくスケジュール検知を実行して、注意が必要なプロアクティブアラートを生成します。 |
| CRE Auto-Mapper | Risk Exchange プラグイン設定ウィザード | プラグインエンティティのすべてのフィールドに対して宛先プラットフォームフィールドを提案し、適切なフィールドが存在しない場合は新しいフィールドを提案します。 |
| 態勢評価 | Settings > Logging | 単一のプラットフォームログ、またはフィルタリングされたログセットを分析し、優先順位が付けられた修復計画を含む正常性の判定を返します。 |
動画を見る
再生ボタンをクリックして動画をご覧ください。
プロバイダー構成の管理
Users with ai-write and settings-write access can create the configuration.
ai-write アクセス権を持つユーザーは、編集アイコン（鉛筆）、無効化アイコン（丸に斜線）、または削除アイコン（ゴミ箱）を選択して、作成された構成のオプションを使用して構成の編集、有効化/無効化、または削除を行うことができます。
プロバイダーを無効にするか、最後のプロバイダー設定を削除すると、すべてのAI機能が無効になります。Cloud Exchangeは、AI機能なしで正常に動作し続けます。CopilotチャットはAIプロバイダーが設定されていないことを示し、Posture Assessmentアクションは利用できず、Risk Exchangeプラグイン設定ウィザードはAIプロバイダーが有効になるまでAuto Mapアクションでエラーを返します。
AI機能の権限
AI機能にアクセスするには、ユーザーのロールにai-readまたはai-writeの2つの権限が必要であり、機能が実行されるモジュールに対する権限も必要です。管理者には、すべてのAI機能へのフルアクセス権があります。
| Permission | Grants |
|---|---|
| AI Copilot > 読む | AI Copilotを使ってPosture Assessmentや単一ログ分析を実行し、AI Analyticsダッシュボードを表示します。 |
| AI Copilot > 書き込み & 設定 > 書き込み | LLMプロバイダーとAI Copilotの読み取りアクセス権が付与するすべての権限を設定します。 |
| Risk Exchange > 書き込み | CRE Auto-Mapper を使います。Auto-Mapper は Risk Exchange プラグイン設定の一部であるため、設定された LLM Provider プラグイン以外の追加の AI Copilot 権限は必要ありません。 |
Copilotがユーザーに閲覧権限のないデータを表示することはありません。サインインしているユーザーに読み取り権限があるモジュールのみを読み取ります。ガイド付きセットアップのステップで、ユーザーがアクセスできないページへのアクセスが必要な場合、アクションはブロックされ、その理由が表示されます。権限の割り当ての詳細については、Cloud Exchange Usersに移動してください。
Cloud ExchangeがLLMプロバイダーに送信するもの
AI機能はリクエストに答えるために必要なものだけを送信し、シークレットフィールドはリクエストがデプロイメントを離れる前に削除されます。
- Credentials are never sentプラグインの構成パラメーターは、モデルに到達する前にすべてのパスワード、トークン、APIキー、シークレットから削除されます。コパイロットは、入力するフィールドを教えてくれますが、値を表示したり繰り返したりすることはありません。
- Records are never sent。 CRE Auto-Mapperはデータではなくスキーマを読む。ユーザー、デバイス、またはアプリケーションのレコード値は、Auto-Mapperリクエストには含まれていません。
- Log content is sent only when you ask for it. ポスチャ評価と単一ログ分析は、選択したログを送信します。プロアクティブなアラートは、純粋にあらかじめ定義されたルールに基づいています。LLMプロバイダープラグインは呼び出しませんが、提起された所見の修正についてヘルプを求められた場合は利用できます。
- Grounding is restricted. 選択されたモデルがウェブ検索をサポートしている場合、AI機能はNetskope製品ドキュメントを検索して回答を見つけることができ、各ソースは結果のSourcesの下にリストされます。
環境変数によるAI機能の調整
AI機能は、ほとんどのデプロイメントに適したデフォルト設定で動作します。これらのパラメータを変更すると、AIの応答時間や応答品質が低下する可能性があります。Copilotが返す詳細の量、単一のAIリクエストで許可される作業の量、またはログボリュームのどれだけを評価が読むかを変更する必要がある場合は、Cloud Exchange コア コンテナでこれらの環境変数を設定してください。すべての変数はオプションであり、設定されていない値や認識されない値は表示されているデフォルト値に戻ります。
| Variable | Default | デスクリプション |
|---|---|---|
AI_COPILOT_VERBOSITY | concise | Copilotの回答にどの程度の詳細を含めるか。concise、balanced、またはdetailedを受け入れます（ケースは区別されません）。認識されない値は、conciseにフォールバックします。 |
AI_COPILOT_TURN_MAX_ITERATIONS | 30 | Copilotエージェントが1つのターンで実行できる最大推論ステップ数。すべてのエージェントに適用されます。正の整数を受け付けます。1未満の値は1に引き上げられ、数値以外の値は30にフォールバックされます。複雑なリクエストが途中で中断される場合は、値を増やしてください。 |
AI_COPILOT_MAX_LOG_CAP | 500 | トリアージツールが1回の分析でコンテキストに取り込める最大累積ログ行数。正の整数を受け付けます。1未満の値は1に引き上げられ、数値以外の値は500にフォールバックされます。 |
CE_ATTENTION_SCAN_DISABLED | false | レビューが必要な項目を表面化するバックグランド注意スキャンのキルスイッチ。trueを受け入れると無効になります。設定されていない値を含む他の値を指定すると、有効のままになります。 |
LangfuseでAIアクティビティをトレースする
Cloud Exchange は、オープンソースの LLM 可観測性プラットフォームである Langfuse に AI アクティビティのトレースを送信できます。トレースは、各コパイロットのターンと各評価の背後にあるモデル呼び出し、ツール呼び出し、トークン数を記録します。これは、回答がどのように生成されたかを段階的に確認したり、時間経過に伴う機能間のコストを比較したり、低速なリクエストを調査したりする場合に便利です。
トレースは完全にオプションであり、デフォルトではオフになっています。これはAI機能の動作や結果を一切変更するものではなく、Langfuseエンドポイントに到達できない場合でも、Cloud Exchangeは通常どおり動作し続けます。以下の変数を設定して有効にします。両方のキーが存在するとすぐにトレースがアクティブになります。Langfuseの設定およびキーの取得については、https://langfuse.com/docs を参照してください。
| Variable | Default | デスクリプション |
|---|---|---|
LANGFUSE_PUBLIC_KEY | unset | Langfuse 公開キー。トレースを有効にするために必要です。 |
LANGFUSE_SECRET_KEY | unset | Langfuse シークレットキー。トレースを有効にするために必要です。 |
LANGFUSE_BASE_URL | unset | LangfuseエンドポイントURL。両方が設定されている場合、LANGFUSE_HOSTよりも優先されます。 |
LANGFUSE_HOST | unset | LangfuseエンドポイントURL。LANGFUSE_BASE_URLが設定されていない場合にのみ使用されます。 |
LANGFUSE_TRACING_ENABLED | 未設定 — 両方のキーが存在する場合に有効 | マスタースイッチ。両方のキーが設定されている場合でも、falseまたは0を受け入れてトレースを無効にします。他の値は、キーの存在ルールをそのままにします。 |
AI機能のトラブルシューティング
| Symptom | Resolution |
|---|---|
| コパイロットは、AIプロバイダーが構成されていないか、AIプロバイダーが無効になっていると報告します。 | Settings > LLM Providerに移動し、プロバイダーを構成するか、既存の構成を有効にします。 |
| AIアクションが認証エラーで失敗する。 | APIキーが無効か、期限切れか、プロバイダーで取り消されています。構成を編集して新しいキーを入力します。 |
| レート制限またはサービスビジーエラーによりAIアクションが失敗します。 | プロバイダーがスロットリングしているか、一時的に過負荷になっています。Cloud ExchangeはLLMプロバイダーに基づいて自動的に再試行します。しばらく待ってから操作を再試行してください。 |
| 会話または要求が長すぎるというメッセージとともにAIアクションが失敗します。 | 新しいCopilotチャットを始めるか、姿勢評価を実行する前にログフィルタを絞り込みます。複数のクエリを持つ複雑な質問を、Copilot用に1つのクエリを持つ質問に簡略化します。 |
AIアクティビティは、AI-COPILOTプレフィックスが付いたプラットフォームログに書き込まれます。Settings > Loggingに移動してフィルタリングし、失敗したリクエストで何が報告されたかを確認してください。