エージェントインスタンスの作成

エージェントを公開し、Microsoft管理センターで利用可能にした後、エージェントインスタンスやエージェントユーザーを作成できます。 これらのインスタンスとユーザーは、あなたが作成したエージェントブループリントとエージェントコードを使用します。

この記事では、このプロセスを主に3つのステップに分けて説明します。

1. Teamsの開発者ポータルでエージェントを設定する
2. エージェントインスタンスを作成する
3. デプロイしたエージェントをテストしてください

問題が発生した場合は、「トラブルシューティング」セクション を 参照してください。

前提条件

• エージェントブループリントのセットアップ手順の説明に従って 、エージェントブループリントが正しく設定されました。
• 「 エージェントを Microsoft 管理センターに発行する」の説明に従って、エージェント アプリケーションが正しく発行されました。

1. Teams開発者ポータルでエージェントを設定する

発行後、Teams 開発者ポータルでエージェント ブループリントを構成して、エージェントを Microsoft 365 メッセージング インフラストラクチャに接続します。 この構成がないと、エージェントは Teams、電子メール、またはその他のMicrosoft 365 サービスからメッセージを受信しません。

1. 設計図IDを取得しましょう

   作業ディレクトリで a365.generated.config.json を開き、 agentBlueprintId の値をコピーします。

2. 開発者ポータルへ移動

   ブラウザを開き、設定ページに移動します:

   https://dev.teams.microsoft.com/tools/agent-blueprint/<your-blueprint-id>/configuration
   

   <your-blueprint-id>をコピーしたagentBlueprintId値に置き換えてください。

   Note

   開発者ポータルにアクセスできない場合は、テナント管理者に連絡してアクセス権を付与するか、この設定をあなたの代わりに完了させてください。

3. エージェントの設定

   開発者ポータルでは:

   1. エージェントの種類を API ベースに設定する

   2. 通知 URL をエージェントのメッセージング エンドポイントに設定します。 messagingEndpointでa365.generated.config.json値を見つけます。

   3. 保存を選びます。

   

この設定は、Teamsでエージェントインスタンスを作成する前に必要です。

エージェント ID ブループリントと開発者ポータルの構成の詳細について説明します。

2. エージェントインスタンスを作成する

今ではTeamsからエージェントの設計図のインスタンスをリクエストできます。 エージェントの発掘、作成、オンボーディングの方法について詳しく学びましょう。

エージェントインスタンスをリクエストすると、Teamsはそのリクエストをテナント管理者に送信し、承認を得ます。 管理者は Microsoft管理センターの「Requested Agents 」ページからリクエストを確認・承認できます。

管理者がリクエストを承認した後、Teamsはあなたのエージェントインスタンスを作成し、Teamsで利用可能にします。

3. 展開したエージェントをテストする

エージェント インスタンスを作成した後、Microsoft 365でテストして、運用環境で正しく動作することを確認します。

デプロイ後、エージェント 365 SDK でエージェント通知を有効にすると、エージェントは Microsoft 365 サービスと統合されます。 チャット、チャネル、会議用の Teams と連携します。送信、受信、およびスケジュールのための電子メールとカレンダー。ドキュメントアクセスとファイル共有のためのSharePointとOneDrive。 また、組織のプレゼンス、プランナーのタスク、ドキュメントコメントなどのコラボレーション機能もサポートしています。

Important

通常のユーザーと同様に、エージェント ユーザーもサービスにアクセスするために適切なMicrosoft 365 ライセンスを必要とします。 一般的なライセンスにはMicrosoft 365 E5、Teams Enterprise、Microsoft Copilotがあります。

管理センターでデプロイ済みエージェントを表示

エージェントを公開した後、Microsoft管理センターで採用情報が表示されます。 繁殖には時間がかかるかもしれません。

Microsoft 365管理センター - エージェントに移動して、次の手順を実行します。

• 公開済みエージェントを表示する
• エージェントの設定を管理します
• エージェントの使用状況を監視する
• 権限の構成

Teams でエージェントをテストする

エージェント ブループリントをデプロイ、発行、構成し、エージェント ユーザーを作成したら、Microsoft Teamsでエージェント ユーザーを直接テストします。

テストを始めてください

1. Teamsで新しいエージェントユーザーを検索してください。

   Note

   エージェント ユーザー作成プロセスは非同期です。 作成後、エージェント ユーザーが検索可能になるまでに数分から数時間かかる場合があります。

2. 新しく作成したエージェントインスタンスで新しいチャットを開始してください。

3. エージェントの機能を確認するためにテストメッセージを送信します。

テストメッセージの例

エージェントをメールで設定している場合は、メール機能のテストのためにこのメッセージを送信してください。 受信者 recipient@contoso.com メールの金額を更新してください。

Send an email to <recipient@contoso.com> with subject "Hello from Teams" and message "This is a test message from my agent!"

エージェントはリクエストを処理し、追加の確認を要求せずにメールを送信します。

検証チェックリスト

エージェントインスタンスを作成した後、Teamsで正しく動作しているか確認してください。

✅ 開発者ポータルの設定が保存されています
✅ エージェントはTeamsアプリの検索に現れます
✅ Teamsのインスタンスエージェントを作成できます
✅ エージェントインスタンスが作成されました
✅ エージェントユーザーが組織に現れます
✅ エージェントがメッセージに応答します
✅ エージェントは以下のアクションを実行できます
✅ アプリケーションログにはエラーが見られません
✅ 管理センターでのオブザーバビリティの機能

エージェントインスタンスが期待通りに動作しない場合は、一般的な問題の詳細な解決策については トラブルシューティングセクション をご覧ください。

開発者ポータルの設定が保存されているか確認してください

次の場所に移動します: https://dev.teams.microsoft.com/tools/agent-blueprint/<your-blueprint-id>/configuration

✅ [エージェントの種類] が表示されます。API ベース✅Notification URL は、エージェントのメッセージング エンドポイントと一致✅正常に保存されたメッセージを表示します

Teamsにエージェントが表示されることを確認する

1. オープンチーム >アプリ

2. 代理店名を検索してください

   ✅ 検索結果にエージェントが表示される ✅ エージェントアイコンと説明が表示されます

Teamsにインスタンスエージェントを作成できるか確認してください

Teamsアプリでエージェントを選択します

✅ [インスタンスの要求]/[インスタンスの作成 ] ボタンが有効になっている ✅ エラーなしでインスタンスを要求できます

エージェントインスタンスの作成を確認してください

リクエストインスタンスを選択した後:

✅ リクエストが管理者に正常送信

エージェントユーザーが組織に表示されているか確認してください

Microsoft 365管理センターで次の手順を実行します。

1. https://admin.cloud.microsoft/#/agents/all に移動します
2. 全エージェントの リクエスト タブへ移動

✅ユーザーが Teams からインスタンスを作成して名前を付けることができる✅、管理者がエージェント インスタンスの使用を承認できる✅、エージェント インスタンス要求が保留中のレビューとして状態と共に一覧表示されます。

Verify agentがメッセージに応答します

担当者とのTeamsチャットで - テストメッセージを送信する: Hello!

✅ エージェントは入力中のインジケーターを示します ✅ エージェントは数秒以内に応答します ✅ 応答は一貫性があり、関連性があります

エージェントがアクションを実行できるかどうか確認する

ツールを構成する場合は、ツールの機能をテストします。 たとえば、Mail MCP サーバーを追加する場合は、テスト 電子メールを自分に送信します。

エージェントは以下のことをすべきです:

✅ 要求を確認 ✅ ツール呼び出しを実行 ✅ 正常に完了したことを確認します

メールが受信箱に届いているか必ず確認してください。

機能を確認する

以下のチェックリストは、エージェント向けの体系的なテストアプローチを提供します:

基本機能:

✅ エージェントは簡単な挨拶に応じる。 ✅ エージェントは多段階の会話を担当します。 ✅ エージェントは関連する回答を提供します。

ツールの機能:

MCPサーバーの設定によります

✅ メールを送ることも可能です。 ✅ カレンダーにアクセスできます。 ✅ 文書を検索できます。 ✅ 設定されたアクションを実行できます。

エラー処理:

✅ 無効なリクエストもスムーズに処理します。 ✅ 役立つエラーメッセージを提供します。 ✅ 予期せぬ入力でクラッシュしません。

パフォーマンス:

✅ 数秒以内に返信します。 ✅ タイムアウトエラーもありません。 ✅ 一貫した対応時間。

申請ログの確認

エージェントの実行内容を確認するには、 az webapp log tail コマンドを使用してアプリケーション ログを確認します。

# Real-time logs from Azure
az webapp log tail --name <your-web-app> --resource-group <your-resource-group>

ログで注意すべき点:

✅ Teams からの受信要求 ✅ 成功した認証 ✅ エラー メッセージまたは例外 ✅ 送信された応答 ❌ ツール呼び出し

管理センターで観測可能性を検証する

エージェントが稼働を開始した後:

1. 移動: https://admin.cloud.microsoft/#/agents/all.

2. エージェントを選択し、「 アクティビティ 」タブを開きます。

   次のような結果が表示されます。

   ✅ セッションが表示される。 ✅ 各セッションはトリガーやアクションを表示します。 ✅ ツール呼び出しはタイムスタンプで記録されます。

次のステップ

これで、エージェントはクラウドに住み、Microsoft 365でチームと一緒に作業する準備ができました。 ローカル コードとして開始されたのは、ユーザーが組織全体でエージェント インスタンスを作成できる、エンタープライズ対応の登録済みアシスタントになりました。

エージェントの開発ライフサイクルは完了しましたが、その影響はこれから始まったばかりです。 エージェント 365 開発者ライフサイクルで構築したものの多くはオープンソースであり、コミュニティへの貢献を歓迎します。 バグの提出、機能リクエスト、プルリクエスト:

• エージェント365サンプル:面白くて楽しいサンプルエージェントはありますか? ここでエージェント コードを オープンソース コミュニティと共有します。
• Node.js SDK: Node.jsの Agent 365 SDK。
• Python SDK: Python の Agent 365 SDK。
• .NET SDK: C# (.NET) のエージェント 365 SDK。
• Agent 365 DevTools CLI: Agent 365 開発ライフサイクル全体を支援する CLI。

Troubleshooting

このセクションでは、エージェントインスタンスの作成およびテスト時によくある問題について説明しています。

Tip

Agent 365トラブルシューティングガイドには、Agent 365 の開発ライフサイクルの各段階に対応した高レベルのトラブルシューティング推奨事項、ベストプラクティス、トラブルシューティングコンテンツへのリンクが含まれています。

エージェントはTeamsに表示されません

症状： エージェントは管理センターに表示されますが、Teams Apps では見つかりません。

根本原因: 開発者ポータルの設定がありません。

Solution:

1. a365.generated.config.jsonからブループリント ID を取得します。agentBlueprintIdを探します。

2. 開発者ポータルで設定:

   1. https://dev.teams.microsoft.com/tools/agent-blueprint/<your-blueprint-id>/configuration に移動します

   2. エージェントの種類を API ベースに設定する

   3. 通知 URL をエージェントのメッセージング エンドポイントに設定します。 messagingEndpointでa365.generated.config.json値を見つけます。

   4. 保存を選びます。

3. 発芽まで5〜10分待ちます。

検証:

• Teams > Apps > Search を開いてエージェントを検索します。
• エージェントが表示され、追加できます。

Teamsでエージェントインスタンスを作成できません

症状： エージェントは Teams に表示されますが、インスタンスを追加または作成することはできません。 [インスタンスの要求] ボタンが機能しません。

根本原因: Microsoft Agent 365 Frontierはテナントで有効になっていません。

ソリューション： テナント管理者に問い合わせて、テナントに対して Microsoft Agent 365 Frontier が有効になっていることを確認してください。

フロンティアの詳細については、こちらをご覧ください。

検証:

Frontier 機能は、ライセンスと管理者設定で許可されると、Microsoft Copilot および Microsoft 365 アプリ内に表示されます。

エージェントがメッセージに応答しない

症状： エージェント インスタンスを作成しても、メッセージに応答しません。 アプリケーションにログは表示されません。

根本原因: 原因は複数考えられます。メッセージングエンドポイントの問題、認証の問題、設定エラーなどです。

基本的なトラブルシューティング

1. ウェブアプリが動いているか確認してください:

   az webapp show --name <your-app-name> --resource-group <your-resource-group> --query state
   # Should be: "Running"
   

2. メッセージングエンドポイントを確認してください:

   • それは次のようになります: https://<your-app-root-url>/api/messages
   • a365.config.jsonとa365.generated.config.jsonで確認してください。

3. エンドポイントを直接テストする:

   curl https://<your-app-root-url>/api/messages
   # Should not return 404
   

4. 申請履歴を確認してください:

   az webapp log tail --name <your-app-name> --resource-group <your-resource-group>
   # Look for incoming requests and errors
   

高度な診断

1. 認証確認:

   • トークンが期限切れかどうか確認してください。 必要なら更新してください。
   • Webアプリの設定で認証情報を確認してください。

2. ツール/MCPの設定を確認してください:

   • MCPサーバーが設定されているか確認してください。
   • 許可が与えられているか確認してください。

3. 地元でのテスト:

   • 同じ構成でローカルでエージェントを動かしてください。
   • エージェント・プレイグラウンドでテスト。
   • ローカルでは動作しますが、クラウドでは展開の問題があります。

一般的な解決方法

• メッセージング エンドポイントが正しくありません。 Azure portal と開発者ポータルで更新します。
• Web アプリが停止しました: Azure portal または CLI を使用して起動します。
• トークンの有効期限が切れています。 Web App 環境変数のトークンを更新します。
• 不足している環境変数: Azure portal で [アプリの設定] を確認します。
• MCP サーバーの問題: サービス プリンシパルとアクセス許可を確認します。
• コード エラー: アプリケーション ログで例外を確認します。

Verification

Teamsでエージェントにメッセージを送り、申請履歴でリクエストが入っているか確認してください。

また、以下の方法も試してみると良いでしょう:

• Amazon Web Services へのエージェントのデプロイに関するトラブルシューティングを行います。
• Google Cloud Platform へのエージェントのデプロイに関するトラブルシューティングを行います。

ツール呼び出しの失敗

症状： エージェントはメッセージに応答しますが、ツール呼び出しは失敗します。 許可が拒否されたりタイムアウトエラーが表示されたりします。

根本原因: MCPサーバー権限の欠如、サービスプリンシパルの設定未完成、ネットワーク接続の問題、またはツール設定の誤り。

Solutions

ツール呼び出しが失敗した場合、以下の解決策を試してみてください:

• 管理センターで権限を確認する

  必要なMCPサーバー権限を確認し承認する:

  • https://admin.cloud.microsoft/#/agents/all に移動します
  • エージェントを選択してください > 権限
  • リストに必要なMCPサーバーが含まれ、承認していることを確認してください

• チェックサービスプリンシパル

  以前に実行していない場合は、一度限りのセットアップスクリプトを実行してください。

  # Download and run:
  # https://github.com/microsoft/Agent365-devTools/blob/main/scripts/cli/Auth/New-Agent365ToolsServicePrincipalProdPublic.ps1
  

• MCPエンドポイント設定の検証

  本番のMCPエンドポイントを使用していることを確認してください:

  # Should be production endpoint, not mock
  MCP_PLATFORM_ENDPOINT=https://agent365.svc.cloud.microsoft
  

• 管理型IDのチェック

  ウェブアプリでマネージドIDが有効になっているか確認してください:

  # Verify managed identity is enabled
  az webapp identity show --name <your-app-name> --resource-group <your-resource-group>
  

Verification

テストツールはTeamsを通じて呼び出し、ログで成功した実行を確認します。

次の手順を試すこともできます。

• トラブルシューティングツール
• モックツールサーバーのトラブルシューティング

ライセンス譲渡の失敗

症状： エージェント ユーザーにライセンスを割り当てることはできません。 管理センターにライセンス エラーが表示されます。

根本原因: 利用可能なライセンスが不十分、ライセンスの種類が誤っている、または権限の問題。

Solutions

ライセンス譲渡が失敗した場合、以下の解決策を試してください:

1. ライセンスの確認は以下の通りです:

   • Microsoft 365 管理センター >Billing>Licenses を確認します。
   • テナントに対して Microsoft Agent 365 Frontier が有効になっていることを確認します。

2. 手動でライセンスを割り当てる:

   • Microsoft 365 管理センター >Users に移動します。
   • エージェント ユーザーを見つけます。
   • 適切なライセンスを割り当てます。

3. フル機能に必要なライセンス:

   • Microsoft 365 E5 (または同等)。
   • Teams Enterprise。
   • Microsoft Copilot（Copilot 機能向け）。

Verification

管理センターのユーザー プロファイルに割り当てられたライセンスが表示されていることを確認します。