重要
Microsoft Agent 365 の早期アクセスを利用するには、フロンティア プレビュープログラムに参加する必要があります。 フロンティアは、Microsoft の最新の AI イノベーションと直接接続します。 Frontier のプレビューは、お客様の契約書に記載されている既存のプレビュー利用規約に従います。 これらの機能は現在開発中であるため、提供状況や機能は今後変更される可能性があります。
デプロイの前に、Agents Playground を使用してエージェントをローカルでテストします。 このガイドでは、Agents Playgroundテストツールを使った開発環境の設定、認証の設定、エージェントの機能検証について説明します。
エージェントがローカルで動作したら、 エージェント 365 開発ライフサイクル に従って、Teams、Word、Outlook などの Microsoft 365 アプリケーションでテストします。
前提条件
エージェントのテストを始める前に、次の前提条件がインストールされていることを確認してください:
一般的な前提条件
- コード エディター: 選択したコード エディター。 Visual Studio Code をお勧めします。
-
エージェント・プレイグラウンド:以下のいずれかの方法を使ってエージェント ・プレイグラウンドをインストールしてください :
- ウィンドウズ：
winget install agentsplayground - npm:
npm install -g @microsoft/m365agentsplayground
- ウィンドウズ：
- A365 CLI: エージェントの展開と管理に必要です。 Agent 365 CLIをインストールしてください。
-
LLM API アクセス: エージェントの構成または推奨モデル プロバイダーに基づいて、適切なサービスを選択します:
- OpenAI APIキー: OpenAIのAPIキーを入手しましょう。
- Azure OpenAI: Azure OpenAI リソースを作成してデプロイし、API キーとエンドポイントを取得します。
- 開発者ポータルの設定:エージェントを公開した後、インスタンスを作成する前に開発者ポータルでエージェントの設計図を設定しなければなりません。 Developer Portalでエージェントブループリントの設定方法を学びましょう
言語固有の前提条件
- Python 3.11 以降: python.org または Microsoft Store からダウンロードする
-
uvパッケージマネージャー: を使って
pip install uv - インストールを確認する:
python --version
エージェントのテスト環境を構成する
このセクションでは、環境変数の設定方法、開発環境の認証方法、そしてAgent 365搭載エージェントのテスト準備方法を説明します。
このシーケンシャル ワークフローに従って、エージェント テスト環境を設定します。
環境を設定する - 環境設定ファイルを作成または更新する。
LLM 構成 - API キーを取得し、OpenAI または Azure OpenAI 設定を構成します。
認証の設定 - エージェント認証の設定。
環境変数の参照 - 必要な環境変数を構成します:
これらの手順を完了したら、Agents Playground でエージェントのテストを開始する準備ができました。
手順 1: 環境を構成する
構成ファイルを設定します:
cp .env.template .env
注意
必要項目を表示する設定テンプレートについては、 Microsoft Agent 365 SDKサンプルをご覧ください。
手順 2: LLM 構成
ローカル テスト用に OpenAI または Azure OpenAI 設定を構成します。 前提条件からAPIキーやサービスエンドポイント、モデルパラメータを設定ファイルに追加してください。
.env ファイルに追加してください。
# Replace with your actual OpenAI API key
OPENAI_API_KEY=
# Azure OpenAI Configuration
AZURE_OPENAI_API_KEY=
AZURE_OPENAI_ENDPOINT=
AZURE_OPENAI_DEPLOYMENT=
AZURE_OPENAI_API_VERSION=
Python用のLLM環境変数
| 変数 | 説明 | 必須 | 例 |
|---|---|---|---|
OPENAI_API_KEY |
OpenAI サービスの API キー | OpenAI の場合 | sk-proj-... |
AZURE_OPENAI_API_KEY |
Azure OpenAI サービスの API キー | Azure OpenAI の場合 | a1b2c3d4e5f6... |
AZURE_OPENAI_ENDPOINT |
Azure OpenAI サービス エンドポイント URL | Azure OpenAI の場合 | https://your-resource.openai.azure.com/ |
AZURE_OPENAI_DEPLOYMENT |
Azure OpenAI の展開名 | Azure OpenAI の場合 | gpt-4 |
AZURE_OPENAI_API_VERSION |
Azure OpenAI の API バージョン | Azure OpenAI の場合 | 2024-02-15-preview |
ステップ3:エージェントの認証を設定する
エージェントのために、以下の認証方法のいずれかを選択してください:
- エージェント認証 - エージェントユーザーIDが存在する場合の本番シナリオでの利用。
- OBO認証 - エージェントユーザーIDなしでユーザー権限を委譲する必要がある本番環境での使用。
- ベアラートークン認証 - 本番認証の設定前の初期開発およびテストシナリオにのみ使用されます。
エージェント認証
Agent 365のCLI a365 config display コマンドを使って、エージェントのブループリント認証情報を取得してください。
a365 config display -g
このコマンドは、エージェントのブループリント構成を表示します。 次の値をコピーします。
| 価値 | 説明 |
|---|---|
agentBlueprintId |
エージェントのクライアント ID |
agentBlueprintClientSecret |
エージェントのクライアントシークレット |
tenantId |
Microsoft Entra テナント ID |
エージェントでエージェンティック認証を構成するには、次の値を使用します:
プレースホルダー値を実際の認証情報に置き換えて、.env ファイルに次の設定を追加します:
USE_AGENTIC_AUTH=true
CONNECTIONS__SERVICE_CONNECTION__SETTINGS__CLIENTID=<agentBlueprintId>
CONNECTIONS__SERVICE_CONNECTION__SETTINGS__CLIENTSECRET=<agentBlueprintClientSecret>
CONNECTIONS__SERVICE_CONNECTION__SETTINGS__TENANTID=<your-tenant-id>
| 変数 | 説明 | 必須 | 例 |
|---|---|---|---|
USE_AGENTIC_AUTH |
エージェンティック認証モードを有効にする | はい | true |
CONNECTIONS__SERVICE_CONNECTION__SETTINGS__CLIENTID |
a365 config display -g からのエージェントブループリントクライアントID |
はい | 12345678-1234-1234-1234-123456789abc |
CONNECTIONS__SERVICE_CONNECTION__SETTINGS__CLIENTSECRET |
a365 config display -g からのエージェント ブループリント クライアント シークレット |
はい | abc~123... |
CONNECTIONS__SERVICE_CONNECTION__SETTINGS__TENANTID |
a365 config display -g から Microsoft Entra のテナント ID |
はい | adfa4542-3e1e-46f5-9c70-3df0b15b3f6c |
OBO 認証
On-Behalf-Of (OBO) 認証を使用すると、エージェントはエージェント ユーザー ID を必要とせずに、委任されたユーザーアクセス許可を使用して MCP サーバー ツールにアクセスできます。 このフローでは、エージェントはユーザーの委任トークンを受け取り、それを交換してユーザーの代わりにアクションを実行します。
OBO認証は、以下の本番環境に適しています:
- あなたのエージェントはエージェントユーザーIDを持っていません。
- ユーザー固有の権限を持つリソースにアクセスする必要があります。
- エージェントに認証済みユーザーの代理として行動してもらいたいのです。
OBOフローの詳細は 「認証フロー」を参照してください。 完全な実装例については、Microsoft 365 Agents SDKの OBO 承認サンプルを参照してください。
ベアラー トークン認証
本番環境認証が設定されていない初期の開発やテストシナリオでは、ベアラートークン認証を使ってエージェントをテストしてください。 この方法は、インタラクティブなブラウザ認証を用いて委任されたアクセストークンを取得します。 このトークンを使うことで、エージェントはユーザーの権限を使ってMCPサーバーツールを呼び出せます。 このアプローチは、実際のエージェントインスタンスを必要とせずに、エージェントユーザーが本番環境でリソースにアクセスする様子をシミュレートします。
まず、 a365 develop add-permissions を使ってアプリケーションに必要なMCPサーバー権限を追加します:
a365 develop add-permissions
次に、 a365 develop get-token を使ってベアラートークンを取得し設定します:
a365 develop get-token
get-tokenコマンドは自動的に次のようになります:
-
ToolingManifest.jsonファイルで構成されているすべての MCP サーバーのベアラー トークンを取得します。 - プロジェクト構成ファイルを
BEARER_TOKEN環境変数で更新します。
get-tokenを実行する前に、コマンドがトークンを保存する場所を認識できるように、プロジェクト構成ファイルを設定します。
-
.NET:
"BEARER_TOKEN": ""をenvironmentVariablesの各プロファイルのProperties/launchSettings.jsonに追加します。 このコマンドは、このキーが既に定義されているプロファイルのみを更新します。 -
Python/Node.js: 実行する前に、
.envを使用してBEARER_TOKEN=ファイルを作成します。 ファイルが見つからない場合、コマンドは保存をスキップし、ガイダンスを示します。
注意
a365 develop get-token --app-id <id> ファイルなしでa365.config.jsonを実行した場合、トークンは自動的に保存されません。 手動でコピーし、Properties/launchSettings.json (.NET の場合) または .env ファイル (Python/Node.js用) に貼り付けます。
ベアラートークンは約1時間後に期限切れになります。
a365 develop get-tokenを使って期限切れのトークンを更新してください。
手順 4: 環境変数の参照
次の必須環境変数を構成して、環境設定を完了します:
- 認証変数 - エージェンティック認証に必要な設定
- MCP エンドポイント構成 - Agent 365 プラットフォーム エンドポイントを指定する
- 監視変数 - ログと分散トレースを有効にする
- エージェント アプリケーション サーバー構成 - エージェント サーバーが実行されるポートを構成する
認証変数
エージェンティック認証が正常に機能するために必要な認証ハンドラー設定を構成します。
.env ファイルに追加してください。
# Agentic Authentication Settings
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__TYPE=AgenticUserAuthorization
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__SCOPES=https://graph.microsoft.com/.default
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__ALTERNATEBLUEPRINTCONNECTIONNAME=service_connection
# Connection Mapping
CONNECTIONSMAP_0_SERVICEURL=*
CONNECTIONSMAP_0_CONNECTION=SERVICE_CONNECTION
| 変数 | 説明 | 必須 |
|---|---|---|
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__TYPE |
認証ハンドラーの種類 | はい |
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__SCOPES |
Microsoft Graphの認証スコープ | はい |
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__ALTERNATEBLUEPRINTCONNECTIONNAME |
代替ブループリント接続名 | はい |
CONNECTIONSMAP_0_SERVICEURL |
接続マッピングのサービス URL パターン | はい |
CONNECTIONSMAP_0_CONNECTION |
マッピングの接続名 | はい |
MCP エンドポイント構成
エージェントが接続するAgent 365プラットフォームのエンドポイントを指定します。 エージェントの ツールサーバー を定義するツールマニフェストを生成する際には、MCPプラットフォームのエンドポイントを指定します。 このエンドポイントは、Microsoft 365統合機能のために MCP ツール サーバーが接続する環境 (事前プロビジョニング、テスト、または運用) を決定します。
.env ファイルに追加してください。
# MCP Server Configuration
MCP_PLATFORM_ENDPOINT=<MCP endpoint>
| 変数 | 説明 | 必須 | デフォルト | 例 |
|---|---|---|---|---|
MCP_PLATFORM_ENDPOINT |
MCP プラットフォームのエンドポイントURL (本番前、テスト、または本番) | いいえ | 運用エンドポイント |
重要:MCP_PLATFORM_ENDPOINTを指定しなければ、アプリは本番エンドポイントを使用します。
注意
CLIのモックツールサーバーを使っている場合は、使ったポート番号を使ってエンドポイントをhttp://localhost:<port>に設定してください。 デフォルトのポートは5309です。
監視変数
エージェントのログと分散トレースを有効にするには、これらの必須変数を構成します。 観察可能性の特徴やベストプラクティスについて詳しく学びましょう。
注意
監視の構成は、すべての言語で同じです。
| 変数 | 説明 | デフォルト | 例 |
|---|---|---|---|
ENABLE_A365_OBSERVABILITY |
可観測性の有効化または無効化 | false |
true |
ENABLE_A365_OBSERVABILITY_EXPORTER |
監視サービスにトレースをエクスポートする | false |
true |
OBSERVABILITY_SERVICE_NAME |
トレースのサービス名 | エージェント名 | my-agent-service |
OBSERVABILITY_SERVICE_NAMESPACE |
サービス名前空間 | agent365-samples |
my-company-agents |
エージェント アプリケーション サーバーの構成
エージェント アプリケーション サーバーが実行されるポートを構成します。 この設定は省略可能であり、Pythonおよび JavaScript エージェントに適用されます。
.env ファイルに追加してください。
# Server Configuration
PORT=3978
| 変数 | 説明 | 必須 | デフォルト | 例 |
|---|---|---|---|---|
PORT |
エージェント サーバーが実行されているポート番号 | いいえ | 3978 |
3978 |
依存関係をインストールしてエージェント アプリケーション サーバーを起動する
環境設定後、必要な依存関係をインストールし、テストのためにエージェントアプリケーションサーバーをローカルで起動します。
依存関係のインストール
uv pip install -e .
このコマンドは、pyproject.toml で定義されているパッケージの依存関係を読み取り、PyPI からインストールします。 エージェントアプリケーションを一から作成する際は、依存関係を定義するための pyproject.toml ファイルを作成しましょう。
サンプル リポジトリ のサンプル エージェントでは、これらのパッケージが既に定義されています。 必要に応じて、追加または更新できます。
エージェント アプリケーション サーバーを起動する
python <main.py>
<main.py> を、エージェント アプリケーションのエントリ ポイントを含むメイン Python ファイルの名前 (たとえば、start_with_generic_host.py、app.py、main.py) に置き換えます。
またはUVを使うこともできます:
uv run python <main.py>
エージェント サーバーが実行され、Agents Playground または Microsoft 365 アプリケーションから要求を受信する準備ができました。
エージェント プレイグラウンドでエージェントをテストする
Agents Playground は、テナントの完全なセットアップを必要とせずにMicrosoft 365環境をシミュレートするローカル テスト ツールです。 エージェントのロジックとツールの呼び出しを検証する最も速い方法です。 詳細については、エージェント プレイグラウンドでテストする を参照してください。
エージェントのプレイグラウンドをエージェント認証用に設定
注意
この構成は エージェント認証を使用する場合にのみ必要です。 ベアラートークン認証を使っている場合は、このセクションを飛ばして直接Basicテストに進めます。
エージェント認証を使用する場合は、エージェントの詳細を使用して Agents Playground YAML ファイルを構成します。
設定ファイルをセットアップします:Agents Playgroundを実行するフォルダ内の
.m365agentsplayground.ymlファイルを作成または更新してください。 詳細なセットアップ手順については、 Teamsのカスタマイズコンテキストをご覧ください。ボット設定を更新する:
.m365agentsplayground.ymlファイルに以下のボット情報を追加し、プレースホルダーの値を実際のエージェント認証情報に置き換えます。bot: id: <your-agent-email>@<your-tenant>.onmicrosoft.com name: <Your Agent Name> role: agenticUser agenticUserId: <your-agentic-user-id> agenticAppId: <your-agentic-app-id>プロパティ 説明 必須 idエージェントのユーザーのメールアドレスは以下の形式です agentusername@tenant.onmicrosoft.comはい nameエージェントユーザーの表示名 はい roleエージェント認証のために agenticUserに設定される必要がありますはい agenticUserIdエージェントユーザーのオブジェクトIDです。 この値は、エージェント ユーザーのプロファイル ページの Microsoft Entra 管理センターで見つけます。 はい agenticAppIdエージェントユーザーのエージェントIDです。 この値は、エージェント ユーザーのプロファイル ページの Microsoft Entra 管理センターで見つけます。 はい
新しいターミナル (Windows 上の PowerShell) を開き、Agents Playground を起動します。
agentsplayground
このコマンドは、エージェント・プレイグラウンドのインターフェースを持つウェブブラウザを開きます。 ツールには、エージェントにメッセージを送信できるチャット インターフェイスが表示されます。
基本的なテスト
まず、エージェントが正しく構成されていることを確認します。 エージェントにメッセージを送信します:
What can you do?
エージェントは、エージェントのシステムプロンプトや機能に基づいて設定された指示を返信します。 この返信は以下のことを確認しています:
- あなたのエージェントは正しく動作しています。
- エージェントはメッセージを処理し、応答することができます。
- エージェント・プレイグラウンドとエージェント間のコミュニケーションは正常に機能しています。
テスト ツールの呼び出し
toolingManifest.jsonでMCPツールサーバーを設定した後(セットアップ手順はツール参照)、以下の例を使ってツール呼び出しをテストします。
まず、使用できるツールを確認します:
List all tools I have access to
次に、特定のツール呼び出しをテストします。
メール ツール
Send email to your-email@example.com with subject "Test" and message "Hello from my agent"
期待される応答:エージェントがMail MCPサーバーを使ってメールを送信し、メッセージ送信を確認します。
カレンダー ツール
List my calendar events for today
予想される回答:エージェントが当日のカレンダーイベントを取得し表示します。
SharePoint ツール
List all SharePoint sites I have access to
予期される応答: エージェントはSharePointクエリを実行し、アクセス権を持つサイトの一覧を返します。
ツールの呼び出しは、次の方法で表示できます:
- チャット ウィンドウ - エージェントの応答とツール呼び出しを確認します。
- [ログ] パネル - ツールのパラメーターと応答を含む詳細なアクティビティ情報を表示します。
通知アクティビティでテストする
ローカル開発中は、Agents Playgroundの内蔵通知トリガーを使って通知シナリオをテストしてください。
通知活動をテストする前に、以下のことを確認してください:
-
toolingManifest.jsonで必要なMCPツールサーバーを設定しましょう。 ツールの詳細については、こちらを参照してください。 - エージェントへの通知を有効にしてください。 通知を設定する方法について説明します。
- エージェントの代理認証情報を使用して
.m365agentsplayground.ymlファイルを設定し、「エージェント認証の設定」で説明されている手順に従ってください。
テストメール通知
メール通知処理をテストするには:
- エージェントとAgents Playgroundを起動しましょう。
- エージェントのプレイグラウンドで、 モック・アン・アクティビティ>トリガー通知アクティビティを選択します。
- メールの送信を選択します。
- ペイロードダイアログでは、送信者名やメール本文の内容などのモックメールの詳細を必要に応じて更新してください。
- [アクティビティの送信] を選択します。
- チャットチャットとログパネルの両方で結果を確認できます。
エージェントは模擬メール通知を受け取り、通知処理のロジックに従って処理します。 メール通知ペイロード構造の詳細については 、「メール通知ペイロード」をご覧ください。
Wordのメンション通知をテストする
Word ドキュメントのメンション通知をテストするには次の手順を実行してください:
- エージェントとAgents Playgroundを起動しましょう。
- エージェントのプレイグラウンドで、 モック・アン・アクティビティ>トリガー通知アクティビティを選択します。
- Word で Mention を選択します。
- ペイロード ダイアログで、ドキュメント ID やコメント テキストなどのモック コメントの詳細を必要に応じて更新します。
- [アクティビティの送信] を選択します。
- チャットチャットとログパネルの両方で結果を確認できます。
エージェントは、シミュレートされたWordメンション通知を受け取り、通知処理ロジックに従って応答します。 Wordコメント通知ペイロードの構造の詳細については、「Document コメント通知ペイロードを参照してください。
テスト エージェントのインストールとアンインストールのイベント
Agents Playground は、エージェントに接続すると、アクション InstallationUpdateを含むadd アクティビティを自動的に送信します。 インストール ハンドラーを実装すると、接続が確立された直後に、エージェントのウェルカム メッセージがチャットに表示されます。
インストール イベントの処理を確認するには:
- エージェント サーバーを起動します。
- エージェントプレイグラウンドを開きます。 プレイグラウンドはエージェントに接続し、インストール イベントを自動的にトリガーします。
- チャット会話にウェルカム メッセージが表示されたことを確認します。
ハンドラーの実装の詳細については、「 エージェントのインストールイベントとアンインストールイベントを処理する」を参照してください。
監視ログを表示する
ローカル開発中に監視ログを表示するには、監視コード (コード例については、監視 を参照) を使用してエージェントをインストルメント化し、監視変数 で説明されているように環境変数を構成します。 設定が完了すると、コンソールにリアルタイムのトレースが表示され、以下が表示されます:
- エージェント呼び出しトレース
- ツール実行の詳細
- LLM の推論呼び出し
- 入出力メッセージ
- トークンの使用法
- 応答時間
- エラー情報
これらのログは問題のデバッグ、エージェントの挙動理解、パフォーマンス最適化に役立ちます。
次の手順
エージェントをローカルでテストした後、それを Azure にデプロイし、Microsoft 365 に発行します。
Teams、Word、Outlook などの Microsoft 365 アプリケーションでエージェントをテストするには、 エージェント 365 開発ライフサイクルを参照してください。
トラブルシューティング
このセクションでは、エージェントをローカルでテストする際によくある問題の解決策を提供します。
ヒント
Agent 365トラブルシューティングガイドには、Agent 365の開発ライフサイクルの各段階に対する高度なトラブルシューティング推奨事項、ベストプラクティス、トラブルシューティングコンテンツへのリンクが含まれています。
接続と環境の問題
これらの問題は、ネットワーク接続、ポートの競合、およびエージェントが正しく通信できなくなる環境セットアップの問題に関連しています。
エージェント・プレイグラウンド接続の問題
症状:エージェントの遊び場があなたのエージェントに接続できません。
解決策:
- エージェントサーバーが稼働しているか確認してください。
- あなたのエージェントとAgents Playgroundの間でポート番号が一致していることを確認してください。
- ローカル接続をブロックするファイアウォールルールがないか確認してください。
- エージェントとエージェントの遊び場の両方を再起動してみてください。
古いエージェント プレイグラウンドのバージョン
症状:エージェント・プレイグラウンドに予期せぬエラーや機能の抜け。
解決策:Agents Playgroundをアンインストールして再インストールしてください。
winget uninstall agentsplayground
winget install agentsplayground
ポートの競合
症状:ポートがすでに使用中であることを示すエラー。
解決策:
- 「エージェントの他のインスタンスを停止してください。」
- 設定内のポートを変更してください。
- ポートを使っているプロセスはすべて終了させてください。
# Windows PowerShell
Get-Process -Id (Get-NetTCPConnection -LocalPort <port>).OwningProcess | Stop-Process
DeveloperMCPServer を追加できません
現象: Visual Studio Code で DeveloperMCPServer を追加しようとしたときにエラーが発生しました。
解決策: Visual Studio Code を閉じて再度開き、サーバーの追加をもう一度試します。
認証とトークンの問題
これらの問題は、エージェントがMicrosoft 365 サービスで適切に認証できない場合、または資格情報の有効期限が切れたり、正しく構成されていない場合に発生します。
症状：
- 401 未承認のエラー
- 「ベアラートークンの有効期限切れ」メッセージ
- エージェント認証の失敗
根本原因:
- トークンは約1時間後に期限が切れます
- 誤った認証設定
- 資格情報が無効または見つからない
ソリューション
ベアラートークンの満期
トークンをリフレッシュし、環境変数を更新してください。
# Get a new token a365 develop get-token # Update your .env file with the new tokenエージェンティック認証エラー (Python)
.envファイルを確認してください:# Should be (with underscore): AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__ALT_BLUEPRINT_NAME=SERVICE_CONNECTION # Not: AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__ALT_BLUEPRINT_NAME=ServiceConnection資格証明書の欠落について
試験前に必要な資格が揃っているか必ず確認してください。
.envまたはappsettings.jsonに以下が含まれていることを確認してください。- APIキーと秘密
- テナント ID
- クライアントID
- Blueprint ID(エージェント認証を使用している場合)
検証:
エージェント・プレイグラウンドで簡単なリクエストでテストしてください。 401エラーなしの返答が届くはずです。
ツールと通知の問題
これらの問題は、ツール呼び出し、MCPサーバーとの連携、通知配信の問題に関わるものです。
メールが届かない
症状: エージェントはメールが送られたと表示しているが、届かない
解決策:
- 迷惑メールフォルダまたはスパムフォルダを確認してください。
- メールの配信は数分遅れることがあります。 最大5分待つ。
- 受信者のメールアドレスが正しいか必ず確認してください。
- メール送信中にエラーがないかエージェントのログを確認してください。
Wordでコメントの応答が機能しない
問題: 通知サービスは現在、Wordコメントに直接応答できません。 この機能は開発中です。
メッセージがエージェントに届かない
症状:エージェントのアプリケーションがTeamsでエージェントに送られたメッセージを受け取っていない。
考えられる原因:
- Developer Portalはエージェントブループリントで設定されていません。
- Azure Web アプリの問題 (デプロイエラー、アプリが実行されていない、構成エラー)。
- Teamsではエージェントインスタンスが正しく作成されていません。
解決策:
開発者ポータルの設定を確認する:
Developer Portalでエージェントブループリントの設定を必ず完了してください。 Developer Portalでエージェントブループリントの設定方法を学びましょう。
Azure Web App の健全性を確認:
エージェントをAzureにデプロイする場合は、Web アプリが正しく実行されていることを確認します。
- Azure portal に移動します。
- ウェブアプリのリソースにアクセスしてください。
- Overview>Status(「Running」と表示されるはずです)を確認してください。
- 監視のログストリームでランタイムエラーを確認してください。
- 展開センターのログを確認し、展開が成功したか確認してください。
- 構成を確認>アプリケーション設定にすべての必要な環境変数が含まれていることを確認してください。
エージェントインスタンス作成の検証:
Microsoft Teamsでエージェント インスタンスを正しく作成してください。
- Microsoft Teamsを開きます。
- アプリに行って、あなたのエージェントを検索してください。
- エージェントが検索結果に表示されているか確認してください。
- 見つからない場合は、Microsoft 365管理センター - エージェントで公開されていることを確認します。
- エージェントで追加を選択して新しいインスタンスを作成します。
- 詳細な指示は 「オンボードエージェント」をご覧ください。