次の方法で共有

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

Important

Microsoft Agent 365 の早期アクセスを利用するには、フロンティア プレビュープログラムに参加する必要があります。 フロンティアは、Microsoft の最新の AI イノベーションと直接接続します。 Frontier のプレビューは、お客様の契約書に記載されている既存のプレビュー利用規約に従います。 これらの機能は現在開発中であるため、提供状況や機能は今後変更される可能性があります。

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

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

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

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

[前提条件]

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

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

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

    a365の設定表示コマンドを実行し -g 設定を表示します:

    a365 config display -g

    出力から agentBlueprintId 値をコピーします。

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

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

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

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

    注

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

  3. エージェントの設定

    開発者ポータルでは:

    1. エージェントタイプをボットベースに設定してください
    2. ボットIDをagentBlueprintId値に設定してください
    3. [保存] を選びます。

    Developer Portalの設定ページ(エージェントタイプがBot Baseに設定され、Bot IDフィールドが埋められている)を示すスクリーンショットです。

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

エージェント・アイデンティティ・ブループリントと開発者ポータルの設定について詳しく学びましょう。

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 365 Copilotが含まれます。

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

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

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

  • 公開済みエージェントを表示する
  • エージェントの設定を管理します
  • エージェントの使用状況を監視する
  • アクセス許可を構成する

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

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

注

必要なフロンティア: Microsoft Agent 365 Frontierがテナントで有効になっていること、そして管理者がアクセス権を許可していることを確認してください。 このアクセスは、エージェント インスタンスを作成し、エージェント 365 がプレビューの間に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

✅ エージェントタイプ 表示: ボットベース
✅ ボットIDが あなたのものと一致します agentBlueprintId
✅ 「 成功裏に保存された 」というメッセージが表示されます

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 開発者ライフサイクルで構築したものの多くはopen sourceであり、コミュニティへの貢献を歓迎します。 バグの提出、機能リクエスト、プルリクエスト:

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

トラブルシューティング

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

ヒント

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

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

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

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

Solution:

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

    a365 config display -g
# Copy the agentBlueprintId value

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

    1. 以下に移動します: https://dev.teams.microsoft.com/tools/agent-blueprint/<your-blueprint-id>/configuration
    2. エージェントタイプをボットベースに設定してください
    3. ボットIDをあなたのものに設定してくださいagentBlueprintId
    4. [保存] を選びます。

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

検証:

  • Teams > アプリを開き > エージェントを検索してください
  • エージェントが現れ、追加可能です

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

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

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

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

フロンティアについてもっと知る

検証:

フロンティア機能は、ライセンスと管理者の設定で許可されると、Microsoft 365 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 ポータルと開発者ポータルで更新してください
  • Web アプリが停止しました: Azure ポータルまたは CLI を使用して開始してください
  • トークンの期限切れ: Web App環境変数におけるトークンの更新
  • 環境変数が不足しています： Azure ポータルでアプリの設定を確認する
  • MCPサーバーの問題: サービスプリンシパルと権限の検証
  • コードエラー: アプリケーションログで例外がないか確認してください

検証

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

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

ツール呼び出しの失敗

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

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

ソリューション

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

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

    必要な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>

検証

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

以下のステップも試してみると良いでしょう:

ライセンス譲渡の失敗

症状： エージェントユーザーにライセンスを割り当てられない;管理センターでのライセンスエラー。

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

ソリューション

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

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

    • Microsoft 365 管理センターで>請求書>ライセンスを確認します
    • テナントに対してMicrosoft Agent 365 Frontierが有効であることを確認しましょう

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

    • Microsoft 365管理センター>ユーザー に移動します
    • 能動的なユーザーを見つける
    • 適切なライセンスを割り当ててください

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

    • Microsoft 365 E5 (またはそれと同等)
    • チーム・エンタープライズ
    • Microsoft 365 Copilot (Copilot機能の場合)

検証

管理者センターでユーザープロフィールを確認し、割り当てられたライセンスが表示されます。

  • Last updated on