エージェントを統合した後、デプロイする前にこのAgent 365 SDK検証チェックリストを活用してください。 オンボーディングの最後のステップです: Agent 365 Skills または手動設定で統合が適用されます。 これらのチェックは、各機能が機能していることを確認する助けとなり、自信を持って展開できるようにします。
もしコーディングアシスタントが内部のAgent 365 Validate and Diagnose機能( a365-code-validatorとも呼ばれる)を公開している場合、コードレベルのプリフライトのために このAgent 365統合の検証 を依頼できます。 計測機器、Microsoft Entraのアーティファクト、メッセージング、ツールアクセス、関連設定のギャップをチェックします。 利用可能か、発動はアシスタントとスキルパッケージによって異なります。 チェックリストを使って、ターゲット環境での発見を確認してください。 バリデーターはエンドツーエンドのテストやプラットフォームレビューの代わりにはなりません。
能力セクションは独立しているので、採用していない機能は省略してください。 ビヘイビア、設定、デプロイメントの各セクションはすべての統合に適用されます。
以下のような条件でこのチェックリストを進めてください:
- エージェントをオンボーディングし、展開前に統合を確認したいと思っています。
- すでに統合しているエージェントに機能を追加しました。
- 別のチームからエージェントを引き継ぎ、何が設定されているのか確認する必要があります。
既存の挙動を確認する
SDKはエージェントを拡張するので、統合によってエージェントの動作が変わることはありません。
- エージェントは新たなエラーなしでスタートします。
- エージェントは通常のリクエストに統合前と同様に応答します。
- モデルコール、オーケストレーション、ツール実行は以前と同じように動作します。
Note
コアの挙動が変わった場合は、展開前に調査してください。 生成コード、依存関係の競合、設定、SDKの互換性などが考えられる原因です。 トラブルシューティングに関するページを参照します。
ID を確認する
- エージェント識別設計図はMicrosoft Entraに登録されています。
- その設計図から作られたエージェントのアイデンティティが存在する。
make-a365-agentスキルは標準エージェントパスで作成し、AIチームメイトパスでmake-ai-teammateします。詳細は「クイックスタート:既存エージェントをエージェント365に接続する」を参照してください。 - 少なくとも1人のスポンサーが割り当てられます。
- エージェントがユーザーアカウントを必要とする場合、そのアカウントは存在し、エージェントのアイデンティティに紐づいています。
- エージェントがユーザーアカウントを持っている場合、必要なライセンスが割り当てられ、メールボックスなどの依存リソースがプロビジョニングされます。
- API権限とMicrosoft Graphスコープは正しく付与され、スコープも設定されています。
- エージェントは期待される同一性の下で認証し、行動します。
Important
独自のユーザーアカウントを持つエージェントは、Frontierプレビュープログラムに参加しているテナントのみが利用可能です。 テナントが登録していなければ、ユーザーアカウントのチェックは省略してください。
Note
ライセンスを割り当てた後、ユーザーアカウントのリソースプロビジョニングは通常10〜15分以内に完了しますが、最大24時間かかることもあります。
観測可能性の検証
- テナント内の少なくとも1人のユーザーはMicrosoft 365 E7またはMicrosoft Agent 365のライセンスが割り当てられています。 このライセンスがなければ、テレメトリは取り込みがHTTP 200を返しても終了します。
- 観測性パッケージはインストールされ、設定されます。
- テストリクエストはエージェント呼び出し、ツール実行、推論のためのスパンを生成します。
- このランはルートに有効な
invoke_agentスパンを持ちます。 これがなければ、Defenderの高度な狩猟ではスパンは問い合わせ可能なままですが、3つのサーフェスには届きません。 - テレメトリーはMicrosoft Defender、Microsoft Purview、Microsoft 365 管理センターに搭載されています。
- スパン属性は期待する操作と一致します。
工具の検証
エージェントがモデルコンテキストプロトコル(MCP)サーバーを呼び出す場合は、このセクションを完成させてください。
- テナントにはMicrosoft 365 Copilotライセンスが利用可能です。 Work IQ MCPはプレビュー中で、必須です。
- エージェントはアクセスすべきMCPサーバーを発見します。
- テストツールの呼び出しはエンドツーエンドで成功します。
- エージェントランタイムはツールの故障を検知し、制御されたエラーを返し、引き続き利用可能です。
通知の確認
エージェントが通知を受け取った場合は、このセクションを記入してください。
- エージェントはTeams、Outlook、Wordコメント、メールなど設定済みのソースから通知を受け取ります。
- エージェントは設計通りにテスト通知に応答します。
Important
通知にはエージェントのユーザーアカウントが必要で、これはFrontierプレビュープログラムに参加しているテナントのみが利用可能です。 入居者が登録していない場合はこのセクションを飛ばしてください。
構成の確認
- 認証情報や秘密情報を安全に保存し、ソース管理にコミットさせないようにしましょう。
- 開発、テスト、本番環境は別々に設定されています。
- ターゲットホストで統合が正常に動作していることを確認してください。
展開準備完了を確認します
- すべての該当する検査は合格します。
- 非本番環境で少なくとも1回はエンドツーエンドテストを実行してください。
- 展開後のテレメトリーでエージェントの健康状態を確認してください。
失敗判定の解決
関連するセットアップステップをもう一度実行するか、コーディングアシスタントに特定の機能を完成させるよう依頼してください。
- アイデンティティチェック: エージェントのアイデンティティを参照してください。
- 観察可能性、ツール、通知チェック: Agent 365 Skillsのマッチングスキルを再実行してください。
一般的な症状とその解決については 、「トラブルシューティング」を参照してください。 スキルベースセットアップに特有の症状については、 Quickstartのトラブルシューティング表をご覧ください:既存エージェントをエージェント365に接続する。
関連する質問への回答については、 Agent 365 SDKのよくある質問をご覧ください。