重要
この記事は、v3 Bot Framework SDK に基づいています。 SDK バージョン 4.6 以降の最新のドキュメントをお探しの場合は、「 会話型ボット」 セクションを参照してください。
ボットをテストするときは、ボットを実行するコンテキストと、Microsoft Teams に固有のデータを必要とするボットに追加した可能性のある機能の両方を考慮する必要があります。 ボットをテストするために選択した方法がその機能と一致していることを確認します。
Teams にアップロードしてテストする
ボットをテストする最も包括的な方法は、アプリ パッケージを作成して Teams にアップロードすることです。 アプリを Teams にアップロードすることが、ボットで利用できるすべての機能をすべてのスコープでテストする唯一の方法です。
アプリをアップロードするには、2 つの方法があります。 Teams 用開発者ポータルを使用することも、手動でアプリ パッケージを作成してアプリをアップロードすることもできます。 マニフェストを変更してアプリを再アップロードする必要がある場合は、変更したアプリ パッケージをアップロードする前に ボットを削除 する必要があります。
ボットをローカルでデバッグする
開発中にボットをローカルでホストしている場合は、ボットをテストするために ngrok などのトンネリング サービスを使用する必要があります。 ngrok をダウンロードしてインストールしたら、次のコマンドを実行してトンネリング サービスを開始します。 パスに ngrok を追加する必要がある場合があります。
ngrok http <port> --host-header=localhost:<port>
アプリ マニフェストで ngrok によって提供される https エンドポイントを使用します。 コマンド ウィンドウを閉じて再起動すると、新しい URL が取得されるので、その URL を使用するようにボット エンドポイント アドレスも更新する必要があります。
Teams にアップロードせずにボットをテストする
場合によっては、ボットをアプリとして Teams にインストールせずにボットをテストする必要があります。 アプリとしてインストールせずにボットをテストすると、ボットが使用可能で応答していることを確認するのに役立ちますが、ボットに追加した Teams の機能の全範囲をテストすることはできません。 ボットを完全にテストする必要がある場合は、 アップロードによるテストの手順に従ってください。
ボット エミュレーターを使用する
Bot Framework Emulator は、ボット開発者がボットをローカルまたはリモートでテストおよびデバッグできるデスクトップ アプリケーションです。 エミュレーターを使用すると、ボットとチャットし、ボットが送受信するメッセージを調べることができます。 これは、ボットが利用可能で応答していることを確認するのに役立ちますが、エミュレーターではボットに追加した Teams 固有の機能をテストすることはできません。また、ボットからの応答は、Teams でどのようにレンダリングされるかを正確に視覚的に表現することはできません。 これらのいずれかをテストする必要がある場合は、 ボットをアップロードするのは最善ではありません。
Bot Framework Emulator の完全な手順については、こちらを参照してください。
個人用チャットでボットをブロックする
ユーザーは、ボットが個人用チャット メッセージを送信できないようにすることを選択できます。 チャット チャネルでボットを右クリックし、[ ボットの会話をブロック] を選択することで、これを切り替えることができます。 つまり、ボットは引き続きメッセージを送信しますが、ユーザーはそれらのメッセージを受信しません。
チームからのボットの削除
ユーザーは、Teams ビューのボット リストでごみ箱アイコンを選択することでボットを削除できます。 ただし、これはボットをそのチームの使用から削除するだけであり、個々のユーザーは個人的なコンテキストで対話できます。
個人的なコンテキストのボットは、ボットを Teams から完全に削除しない限り、ユーザーが無効にしたり削除したりすることはできません。
Teams でボットを無効にする
ボットによるメッセージの受信を停止するには、ボット ダッシュボードに移動し、Microsoft Teams チャネルを編集します。 [ Microsoft Teams で有効にする] オプションをオフにします。 Teams でボットを無効にすると、ユーザーがボットと対話できなくなりますが、ボットは検出可能であり、ユーザーはボットを Teams に追加できます。
Teams からのボットの削除
ボットを Teams から完全に削除するには、ボット ダッシュボードに移動し、Microsoft Teams チャネルを編集します。 下部にある [削除 ] ボタンを選択します。 Teams からボットを削除すると、ユーザーがボットを検出、追加、または操作できなくなります。 Teams からボットを削除しても、他のユーザーの Teams インスタンスからボットは削除されませんが、それらのユーザーでも機能しなくなります。
AppSource からのボットの削除
AppSource (以前の Office ストア) の Teams アプリからボットを削除する場合は、アプリ マニフェストからボットを削除し、検証のためにアプリを再送信する必要があります。 詳細については、「 Microsoft Teams アプリを AppSource に発行する」を参照してください。