Important
Microsoft Agent 365の早期アクセスを得るには、Frontierプレビュープログラムに参加する必要があります。 Frontierはマイクロソフトの最新のAIイノベーションと直接つながります。 Frontierプレビューは既存の顧客契約のプレビュー条件の対象となります。 これらの機能はまだ開発段階であるため、利用可能性や機能は時間とともに変化する可能性があります。
このガイドを使って、Agent 365の開発ライフサイクル全体にわたる問題を診断し解決しましょう。 この記事をトラブルシューティングの出発点として使い、その後詳細な解決策については特定のセクションをご覧ください。
トラブルシューティングの手順
この表の各リンクは、特定のエリアのトラブルシューティング手順を示しています。 コンテンツは Agent 365 SDKの開発ライフサイクルの段階ごとにグループ化されています。
| 段階 | トラブルシューティング コンテンツ |
|---|---|
| ビルド・アンド・ラン・エージェント |
Agent 365 CLI Agent 365 CLI用のカスタムクライアントアプリ登録 モックツールサーバー エージェントの観察可能性 試験剤 Devトンネルを使ったエージェントのテスト |
| セットアップエージェント365の設定 |
Agent 365の設定を設定してください ツールの追加と管理 |
| セットアップエージェントブループリント | セットアップエージェントの設計図 |
| Deploy |
Deploy agent to Azure Amazon Web Services(AWS)へのエージェント展開 Google Cloud Platform (GCP)へのエージェント展開 |
| Microsoft 365管理センターへのPublish agent | Publish agentからMicrosoft管理センターへ |
| エージェントインスタンスの作成 | エージェントインスタンスの作成 |
診断コマンド参照
具体的な問題に入る前に、以下のコマンドを使ってAgent 365のセットアップの状態を確認してください:
CLIと設定を必ず確認してください
これらのコマンドを使ってCLIや設定を検証してください。
# Verify CLI is installed and check version
a365 --version
# Display current configuration
a365 config display
# Display generated configuration (after setup)
a365 config display -g
Verify Azure resources
これらのコマンドを使って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
a365 config display -g | Select-String "agentBlueprintId"
Microsoft EntraでBlueprintを検証する
- https://entra.microsoft.com > アプリ登録>すべての応募へ。
-
agentBlueprintIdを探してください。
予防のベストプラクティス
これらの推奨事項を活用して、よくある問題を防ぎトラブルシューティングを効率化しましょう。
開始する前に
前提条件チェックリスト:
✅ .NET 8.0 SDK インストール済み
✅ Azure CLIがインストール・認証済み
✅ Entraの必要権限割り当て
✅ カスタムクライアントアプリの作成・設定
✅ Tenant enabled for 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 --prerelease
段階的にテストする:
- 主要なステップごとにテストを行ってください。
- 次に進む前に成功を確認しましょう。
- 動作設定を続けましょう。
デプロイ前
展開前のチェックリスト:
✅ エージェントは地元でAgents Playgroundと協力しています。
✅ すべての環境変数はドキュメント化されています。
✅ 設定ファイルはソース管理にコミットされています。
✅ MCPサーバーの設定とテスト完了。
✅ 観測可能性が有効化され、検証済みです。
追加の支援を受けてください
サンプルコードの確認、問題報告、既存の問題の検索は、以下のリポジトリを使用してください: