エージェント評価CLI のトラブルシューティング

この記事では、Microsoft 365 Copilot エージェント評価 CLI のトラブルシューティング情報を提供します。 問題は、影響を受けるワークフローのステージ (セットアップ、認証、ランタイム、環境) によってグループ化されています。

セットアップの問題

インストール中または初めて CLI を実行したときに発生した問題。

インストールのエラー

失敗した場合 npm install -g @microsoft/m365-copilot-eval :

  • Node.js 24.12.0 以降を実行していることを確認します。 node --version。
  • グローバル npm パッケージをインストールする権限があることを確認します。 Unix/macOS では、 sudo または nvm マネージド ノードのインストールが必要になる場合があります。
  • 企業プロキシを使用している場合は、「 ネットワークまたはプロキシの問題」を参照してください。

runevals コマンドが見つかりません

インストール後に runevals コマンドが認識されない場合:

# Verify the package is installed globally
npm list -g @microsoft/m365-copilot-eval

# Reinstall if missing
npm install -g @microsoft/m365-copilot-eval

パッケージが一覧に表示されてもコマンドが見つからない場合は、npm グローバル bin ディレクトリがPATH上にあるチェックします。

npm bin -g

出力ディレクトリが見つからない場合は、 PATH に追加します。

Python 環境を事前にキャッシュする

このツールは、初回実行時に Python ランタイムと依存関係をダウンロードします。 評価を実行せずに事前に環境を設定するには:

runevals --init-only

これは、次の場合に役立ちます。

  • CI/CD パイプラインでのキャッシュの事前ウォーミング。
  • 評価を実行せずにセットアップをテストする。
  • インストールの問題を評価の問題から切り離す。

セットアップ自体のトラブルシューティングについては、デバッグ ログと組み合わせます。

runevals --init-only --log-level debug

認証に関する問題点

テナント、エージェント、または Microsoft Foundry のアクセスに関する問題。

認証エラー

認証が失敗した場合:

  • TENANT_IDエージェントが展開されているテナントと一致していることを確認します。
  • Windows で実行していることを確認します。 他のオペレーティング システムのサポートは近日公開予定です。
  • 正しい Microsoft 365 アカウントにサインインしていることを確認します。
  • 複数のテナントを使用している場合は、 runevalsを実行する前に他のアカウントからサインアウトします。

テナントの不一致

ツールが接続できるがエージェントを返さない場合、 TENANT_ID はエージェントが展開されているテナントと一致しない可能性があります。 次を実行してテナント ID を確認します。

az account show --query tenantId

「必須の環境変数」の指示に従うこともできます。

Foundry スコアリング エラー

評価スコアリングが 401 エラーまたは 403 エラーで失敗した場合:

  • Microsoft Foundry プロジェクトをホストするテナントに Azure CLI (az login) を使用してサインインしていることを確認します。
  • アカウントに Foundry プロジェクトで Azure AI 開発者ロールがあることを確認します。
  • AZURE_AI_PROJECT_ENDPOINTが正しい Microsoft Foundry プロジェクトを指していることを確認します。
  • gpt-5-mini (または AZURE_AI_MODEL_NAME のモデル セット) が Microsoft Foundry プロジェクトに展開されていることを確認します。

実行時の問題

セットアップが成功した後で評価を実行するときに発生する問題。

エージェントが見つかりません

ツールでエージェントが見つからない場合:

  • M365_AGENT_IDが正しいことを確認します。 Agents Toolkit プロジェクトの場合、CLI は .env.local のM365_TITLE_IDから自動検出するため、代わりにその値をチェックします — 「エージェント ID の取得」を参照してください。
  • エージェントが TENANT_ID で指定されたテナントに展開されていることを確認します。
  • エージェントにアクセスする権限があることを確認します。
  • エージェント ID を明示的に指定してみてください: runevals --m365-agent-id "<your-agent-id>"。

評価エラー

評価が開始されるが実行途中で失敗する場合:

  • 詳細なエラーを確認するには、詳細ログと共に実行します: runevals --log-level debug。
  • 一般エラー カテゴリの終了コードを確認します。 CLI リファレンスの出口 コード を参照してください。

警告

--log-level debug オプションには、コンソール出力に生の API ペイロードと応答データを含めることができます。 マスキングはパターンベースであり、すべての PII またはカスタム資格情報をキャッチしない場合があります。 手動レビューなしにデバッグ レベルの出力を公開しないでください。

環境の問題

キャッシュされた Python ランタイム、キャッシュ ディレクトリ、またはネットワーク接続に関する問題。

キャッシュの問題

評価ツールでは、Python ランタイムと依存関係にローカル キャッシュが使用されます。

# View cache info
runevals cache-info

# Clear and rebuild the cache
runevals cache-clear
runevals --init-only --log-level debug

アクセス許可の問題

キャッシュ操作がアクセス許可エラーで失敗した場合:

# View the cache directory path
runevals cache-dir

# Fix permissions (Unix/macOS)
chmod -R u+w $(runevals cache-dir)

# Fix permissions (Windows PowerShell)
icacls "$(runevals cache-dir)" /grant ${env:USERNAME}:F /T

ネットワークまたはプロキシの問題

企業プロキシの背後で初期化が失敗した場合:

# Set proxy (Unix/macOS)
export HTTPS_PROXY=http://proxy:8080
export HTTP_PROXY=http://proxy:8080

# Set proxy (Windows PowerShell)
$env:HTTPS_PROXY="http://proxy:8080"
$env:HTTP_PROXY="http://proxy:8080"

# Retry initialization with verbose output
runevals --init-only --log-level debug

サポートを受ける

上記のトラブルシューティング手順で問題が解決しない場合は、 M365 Copilot エージェント評価 GitHub リポジトリに問題を提出してください。

問題を提出する前に、次を収集してください。

  • CLI バージョン: runevals --version。
  • 実行したコマンドとまったく同じ。
  • エラー出力 (PII、キー、またはテナント固有の識別子を編集します)。
  • オペレーティング システムと Node.js バージョン: node --version。

問題を提出するには:

関連コンテンツ

  • 最終更新: