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

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

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

1. Teams 開発者ポータルでエージェントを設定する
2. エージェント インスタンスの作成
3. 展開したエージェントをテストする

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

必要条件

• エージェント ブループリントの設定の手順に従って、エージェント ブループリントが正しく設定されました。
• Microsoft 管理センターへのエージェントの公開に記載されている手順に従い、エージェントの公開が正しく行われました。

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

公開後、Teams Developer Portal でエージェントのブループリントを構成し、エージェントを 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 の値に置き換えます。

   メモ

   Developer Portal にアクセスできない場合は、テナント管理者に連絡してアクセス権の付与を依頼するか、代わりにこの構成を行ってもらうよう依頼してください。

3. エージェントの構成

   Developer Portal で、次の操作を行います。

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

   2. 通知 URL を、エージェントのメッセージング エンドポイントに設定してください。 a365.generated.config.json の中から messagingEndpoint の値を見つけてください。

   3. 保存を選択します。

   

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

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

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

Teams から、エージェント ブループリントのインスタンスをリクエストできるようになりました。 エージェントの発見、作成、オンボーディングの方法について詳しく説明します。

エージェント インスタンスを申請すると、Teams はそのリクエストをテナント管理者に送信し、承認を求めます。 管理者は、Microsoft 管理センターの申請されたエージェントのページから、リクエストを確認、承認できます。

管理者がリクエストを承認すると、Teams によってエージェントインスタンスが作成され、Teams 内で利用可能になります。

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

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

展開後、Agent 365 SDK でエージェント通知を有効にすると、エージェントは Microsoft 365 サービスと連携します。 チャット、チャンネル、会議については Teams と連携し、メールやカレンダーについては送信、受信、スケジュール設定と連携し、SharePointやOneDrive についてはドキュメントへのアクセスやファイル共有と連携します。 また、組織内のオンライン ステータス、Plannerのタスク、ドキュメントへのコメントなどのコラボレーション機能もサポートしています。

重要

一般ユーザーと同様に、エージェント ユーザーもサービスにアクセスするには、適切な Microsoft 365 ライセンスが必要です。 一般的なライセンスには、Microsoft 365 E5、Teams Enterprise、Microsoft 365 Copilot が含まれます。

管理センターで展開されたエージェントを表示する

エージェントを公開すると、Microsoft 管理センターの採用ページに表示されます。 反映されるまでに時間がかかる場合があります。

Microsoft 365 管理センター - エージェント に移動して次のことを行います:

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

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

エージェントのブループリントを展開、パブリッシュ、構成し、エージェントユーザーを作成した後、Microsoft Teams でそのエージェントユーザーを直接テストしてください。

テストを開始します

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

   メモ

   エージェント ユーザーの作成処理は非同期で行われます。 エージェント ユーザーを作成してから、検索対象となるまでには数分から数時間かかる場合があります。

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 ベース✅通知 URL が、エージェントのメッセージング エンドポイントと一致するものを表示します ✅保存に成功した メッセージを表示します

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

1. Teams >アプリを開きます

2. エージェント名で検索します

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

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

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

✅ インスタンスをリクエスト / インスタンスを作成 ボタンが有効になっています ✅ エラーなくインスタンスをリクエストできます

エージェント インスタンスが作成されたことを確認する

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

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

エージェントユーザーが組織内に存在することを確認する

Microsoft 365 管理センターで次を行います:

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

✅ エージェント インスタンスのリクエストは、「審査待ち」の状態として一覧に表示されます ✅ 管理者は、そのエージェントインスタンスの使用を承認できます ✅ ユーザーは Teams からインスタンスを作成して、そのインスタンスに名前を付けることができます。

エージェントがメッセージに応答するかどうかを確認する

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 内でチームと連携する準備が整いました。 当初はローカル用のコードとして始まったものが、現在では登録済みのエンタープライズ向けアシスタントへと進化し、ユーザーは組織全体でエージェント インスタンスを作成できるようになりました。

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

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

トラブルシューティング​​

このセクションでは、エージェント インスタンスの作成とテストを行う際に発生しやすい問題について説明します。

ヒント

Agent 365 トラブルシューティングガイドは、一般的なトラブルシューティングの推奨事項、ベストプラクティス、およびAgent 365開発ライフサイクルの各部分に関するトラブルシューティングコンテンツへのリンクを含んでいます。

エージェントがTeamsに表示されない

症状: エージェントが管理センターには表示されるが、Teams のアプリ一覧には見つからない。

根本原因: 開発者ポータルの構成がされていない。

解決策:

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 を、エージェントのメッセージング エンドポイントに設定してください。 a365.generated.config.json の中から messagingEndpoint の値を見つけてください。

   4. 保存を選択します。

3. 伝達されるまで 5 ～ 10 分待ちます。

検証:

• Teams >アプリ>を開き、エージェントを検索してください。
• エージェントが表示され、追加できるようになります。

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

症状: Teams にエージェントは表示されますが、インスタンスを追加または作成できません。インスタンスのリクエスト ボタンが動作しません。

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

解決策: テナント管理者に連絡して、Microsoft Agent 365 Frontier がテナントで有効になっているか確認してください。

Frontier の詳細。

検証:

ライセンスと管理者設定で許可されている場合、Microsoft 365 Copilot および Microsoft 365 アプリ内に Frontier の機能が利用可能になります。

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

症状: エージェント インスタンスを作成してもメッセージに応答しない。 アプリケーションにログが表示されない。

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

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

1. Web アプリが稼働しているかを確認します:

   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. ローカルでテストします:

   • 同じ構成でエージェントをローカルで実行します。
   • Agents Playground でテストします。
   • ローカルでは動作するがクラウドではしない > 展開の問題

一般的な解決方法

• メッセージング エンドポイントが正しくありません: Azure portal と Developer Portal で更新してください。
• Web アプリが停止しています: Azure portal または CLI で起動してください。
• トークンの期限切れ: Web アプリの環境変数内のトークンを更新してください。
• 環境変数が不足しています: Azure portalでアプリ設定を確認してください。
• MCPサーバーの問題: サービス プリンシパルと権限を確認してください。
• コードエラー: アプリケーション ログで例外を確認してください。

検証

Teams でエージェントにメッセージを送信し、アプリケーション ログで受信リクエストを確認してください。

また、次のことを試してください:

• アマゾン ウェブ サービス へのエージェントの展開に関するトラブルシューティング。
• Google Cloud Platform へのエージェントの展開に関するトラブルシューティング。

ツール コールの失敗

症状: エージェントはメッセージに応答しますが、ツール呼び出しが失敗します。 権限の拒否やタイムアウト エラーが発生します。

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

ソリューション

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

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

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

  • https://admin.cloud.microsoft/#/agents/all に移動します
  • エージェントの > アクセス許可を選択します
  • リストに必要な MCP サーバーがすべて含まれており、承認されていることを確認します

• チェック サービス プリンシパルを確認する

  まだ実行していない場合は、1 回限りのセットアップ スクリプトを実行してください:

  # 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 の確認

  Web アプリでマネージド ID が有効になっていることを確認してください:

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

検証

Teams を介してテスト ツールを呼び出し、ログを確認して正常に実行されたかを確認します。

以下の手順も試してみてください:

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

ライセンスの割り当てが失敗している

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

根本原因: 利用可能なライセンスが不足している、ライセンスの種類が間違っている、または権限に関する問題があります。

ソリューション

ライセンスの割り当てに失敗した場合は、以下の解決策を試してください。

1. ライセンスが利用可能か確認してください:

   • Microsoft 365 管理センター>請求>ライセンスを確認します。
   • テナントで Microsoft Agent 365 Frontier が有効になっていることを確認してください。

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

   • Microsoft 365 管理センター >ユーザー に移動します。
   • エージェント ユーザーを検索します。
   • 適切なライセンスを割り当ててください。

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

   • Microsoft 365 E5 (または同等のもの)。
   • Teams Enterprise。
   • Microsoft 365 Copilot (Copilotの機能用)。

検証

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