このガイドを使って、Agent 365の開発ライフサイクル全体にわたる問題を診断し解決しましょう。 この記事をトラブルシューティングの出発点として使い、その後詳細な解決策については特定のセクションをご覧ください。
トラブルシューティングの手順
この表の各リンクは、特定のエリアのトラブルシューティング手順を示しています。 コンテンツは Agent 365 SDKの開発ライフサイクルの段階ごとにグループ化されています。
| 段階 | トラブルシューティング コンテンツ |
|---|---|
| ビルド・アンド・ラン・エージェント |
エージェント365 CLI認証 エージェント 365 CLI Agent 365 CLI用のカスタムクライアントアプリ登録 モックツールサーバー エージェントの観察可能性 試験剤 Devトンネルを使ったエージェントのテスト ツールの追加と管理 |
| セットアップエージェントブループリント | セットアップエージェントの設計図 |
| Deploy | Amazon Web Services(AWS)へのエージェント展開 Google Cloud Platform (GCP)へのエージェント展開 |
| Microsoft 365 管理センターにエージェントを発行する | Microsoft 管理センターにエージェントを公開 |
| エージェントインスタンスの作成 | エージェントインスタンスの作成 |
診断コマンド参照
具体的な問題に入る前に、以下のコマンドを使ってAgent 365のセットアップの状態を確認してください:
CLIと設定を必ず確認してください
これらのコマンドを使ってCLIや設定を検証してください。
# Verify CLI is installed and check version
a365 --version
# Display current configuration
Get-Content a365.config.json | ConvertFrom-Json
# Display generated configuration (after setup)
Get-Content a365.generated.config.json | ConvertFrom-Json
Azureのリソースを確認する
これらのコマンドを使用して、Azureリソースとアプリの状態を調べます。
# Set these variables with appropriate data for your app
$resource-group = <your-resource-group>
$app-name = <your-app-name>
# Authenticate with Azure
az login
# List resources in your resource group
az resource list --resource-group $resource-group --output table
# Check Web App status
az webapp show --name $app-name --resource-group $resource-group --query state
# View Web App logs (real-time)
az webapp log tail --name $app-name --resource-group $resource-group
エージェントの設計図を検証する
エージェントの設計図が存在し、正しく設定されているかを確認してください。
# Check if blueprint ID is set
Get-Content a365.generated.config.json | Select-String "agentBlueprintId"
Microsoft Entraでブループリントを確認する
- https://entra.microsoft.com > アプリの登録>すべてのアプリケーションに移動します。
-
agentBlueprintIdを探してください。
CLI認証のトラブルシューティング
Agent 365の設定は、利用可能なMicrosoft管理のAgent 365 CLIエンタープライズアプリケーションを使用し、テナント所有のカスタムアプリにフォールバックします。 動作および検証の全手順については、Microsoft Entra認証を参照してください。
| 症状: | Resolution |
|---|---|
| Microsoft管理アプリケーションが見つかりません | CLIを更新して a365 setup requirementsを実行してください。
エンタープライズアプリケーションでアプリケーションID f54280f4-395e-4ea8-9e48-bf2d4952aa14を検索してください。 段階的な展開がテナントに届いていない場合は、 カスタムアプリのフォールバックを使いましょう。 |
AADSTS530035 デバイスコード認証中 |
セキュリティデフォルトまたは条件付きアクセスはデバイスコードをブロックします。 組織のセキュリティポリシーを無効にしないでください。 ネイティブWindowsでCLIを実行してWAMを使うか、アイデンティティ管理者と連携して承認されたテナント所有のカスタムアプリを使うと良いでしょう。 |
AADSTS70007 認証中に |
最新のCLIへのアップデート。 古いバージョンでは、Microsoft管理アプリケーションでサポートされていないブラウザ応答モードを使うことができました。 |
| 必要な委任範囲が欠落しています |
a365 setup requirements をもう一度実行します。 Microsoft管理アプリケーションを改変したり、テナントローカル権限付与を作成したりしないでください。 テナント所有のアプリを使用している場合は、 設定中にCLIの検証が失敗した場合、それに従ってください。 |
予防のベストプラクティス
これらの推奨事項を活用して、よくある問題を防ぎトラブルシューティングを効率化しましょう。
開始する前に
前提条件チェックリスト:
✅ .NET 8.0 SDK がインストールされている
✅ Azure CLI のインストールと認証
✅ Entraの必要な権限割り当て
✅Microsoft管理のAgent 365 CLIエンタープライズアプリが利用可能か、カスタムクライアントアプリの設定も可能です
✅ テナントが Microsoft Agent 365 Frontier で有効になっている
検証コマンド:
# Check .NET
dotnet --version
# Check Azure CLI
az --version
az account show
# Check CLI installation
a365 --version
開発中
設定を保存する:
- 設定ファイルのバックアップを取っておきましょう。
- セットアップの選択を記録しましょう。
- ブループリントIDやマネージドIDIDなどの生成IDを保存します。
CLIの最新情報を保ちましょう:
dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli
段階的にテストする:
- 主要なステップごとにテストを行ってください。
- 次に進む前に成功を確認しましょう。
- 動作設定を続けましょう。
デプロイ前
展開前のチェックリスト:
✅ エージェントは地元でAgents Playgroundと協力しています。
✅ すべての環境変数はドキュメント化されています。
✅ 設定ファイルはソース管理にコミットされています。
✅ MCPサーバーの設定とテスト完了。
✅ 観測可能性が有効化され、検証済みです。
追加の支援を受けてください
サンプルコードの確認、問題報告、既存の問題の検索は、以下のリポジトリを使用してください: