Teams 用のボットを構築する

ボットは、チャットボットまたは会話ボットとも呼ばれます。 これは、カスタマー サービスやサポート スタッフなどのユーザーが単純で反復的なタスクを実行するアプリです。 ボットの日常的な使用には、天気に関する情報を提供するボット、ディナーの予約を行うボット、旅行情報を提供するボットなどがあります。 ボットとのやり取りは、質問や回答を素早く行ったり、複雑な会話になったりする場合があります。

まず、 JavaScript を使用して最初のボット アプリをビルド するか、新しい世代の Teams 開発ツールを使用して JavaScript を使用して通知ボットをビルド することをお勧めします。 詳細については、「 Teams Toolkit の概要」を参照してください。

重要

• ボットは 、Government Community Cloud (GCC)、GCC-High、および国防総省 (DOD) 環境で使用できます。 GCC-High と DOD 用の Microsoft Teams 内のボット アプリケーションは Azure bot Service を通じて利用でき、ボット チャネルの登録はポータルAzure Government行う必要があります。

• アダプティブ カードの画像 URL は、GCC-High 環境と DOD 環境ではサポートされていません。 画像 URL を Base64 でエンコードされた DataUri に置き換えることができます。

• ユーザーがボットの Teams テーマを変更した場合、そのテーマはアダプティブ カードを使用して共有されたコンテンツには適用されません。

会話型ボットを使用すると、ユーザーはテキスト、対話型カード、ダイアログ (TeamsJS v1.x のタスク モジュールと呼ばれます) を使用して Web サービスと対話できます。

会話ボットは非常に柔軟です。 ボットは、人工知能と自然言語処理を含むいくつかの基本的なコマンドまたは複雑なタスクを処理できます。 ボットは、大規模なアプリケーションの一部にすることも、スタンドアロンにすることもできます。

カード、テキスト、ダイアログの適切な組み合わせを使用して、便利なボットを作成します。 次の図は、テキストカードと対話型カードを使用して、1 対 1 のチャットでボットと会話するユーザーを示しています。

ユーザーとボットの間のすべての対話は、アクティビティとして表されます。 ボットは、アクティビティを受け取ると、そのアクティビティ ハンドラーに渡します。 ボット アクティビティ ハンドラーを参照してください。

ボットは、会話インターフェイスを持つアプリです。 テキスト、対話型カード、音声を使用してボットと対話できます。 ボットの動作は、チャネルまたはグループ チャットの会話と 1 対 1 の会話で異なります。 会話は、Bot Framework コネクタを介して処理されます。 会話の基本を参照してください。

ボットには、関連するコンテンツにアクセスし、ボットのエクスペリエンスを向上させるために、ユーザー プロファイルの詳細などのコンテキスト情報が必要です。 Teams コンテキストを取得を参照してください。

Graph API または Teams ボット API を使用して、ボットを介してファイルを送受信できます。 ボットを介してファイルを送受信する方法を参照してください。

レート制限は、Teams アプリケーションに使用されるボットを最適化するために使用されます。 Teams とそのユーザーを保護するために、ボット API は受信要求のレート制限を提供します。 Teamsでレート制限を使用してボットを最適化を参照してください。

通話やオンライン会議用の Microsoft Graph API により、Microsoft Teams アプリは音声とビデオを使用してユーザーと対話できるようになりました。 通話と会議のボットを参照してください。

Teams ボット API を使用して、チャットまたはチームのメンバーの情報を取得できます。 チームまたはチャット メンバーをフェッチするための Teams ボット API に対する変更を参照してください。

Teams 環境に表示されるボット名を変更できます。また、次の状況でボット名を更新する必要があります。

• チャット ウィンドウにタイトルとして表示されるボット名は、アプリ マニフェスト (以前は Teams アプリ マニフェスト) 内で管理され、アプリ マニフェストでボット名を更新できます。

• Teams チャット リストと各メッセージのチャット ウィンドウに表示されるボット名は、Microsoft Azure portal内で管理されます。 カスタムアップロードされたアプリの場合は、Azure portalの [Bot profile]\(ボット プロファイル\) ページでボット名を更新できます。

  

会話ボットに SSO 認証を追加する

次の手順を使用して、会話ボットにシングル サインオン認証を追加できます。

• Teams 会話ボットを作成する
• Microsoft Entra IDでボット アプリを構成する

ボット構成エクスペリエンス

ボット構成エクスペリエンスは、ユーザーがインストール中にボットを構成し、ボットがインストールされているチャネルまたはグループ チャット スコープからボットを再構成するためのボット設定を有効にするのに役立ちます。 ボットの構成は、Teams プラットフォーム内のアプリにとって重要な機能であり、運用効率の基礎を築きます。 詳細については、「 ボットの構成エクスペリエンス」を参照してください。

コード サンプル

サンプルの名前	説明	.NET	Node.js	マニフェスト
ボットの毎日のタスクリマインダー	このサンプルでは、ボットを使用して定期的なタスクをスケジュールし、スケジュールされた時刻にリマインダーを取得する方法を示します。	表示	表示	表示
Helloワールド ボット	これは、ボットとメッセージ拡張機能の両方の機能を備えたシンプルな hello world アプリケーションです。	該当なし	表示
アダプティブ カード通知	これはサンプルであり、ボットを使用してさまざまなアダプティブ カードで通知を送信する方法を示しています。	該当なし	表示
受信 Webhook 通知	これは、Microsoft Teams チャネルで受信 Webhook を使用して通知を送信する方法を示すサンプルです。	該当なし	表示

次の手順

ボットと SDK

関連項目

• Microsoft Teams ボットの仕組み
• Microsoft Teams のボットをデザインする
• Teams のボットを作成する
• Microsoft Teams ボットのテストとデバッグ
• JavaScript を使用して初めてのボット アプリを構築する
• Teams ボットに認証を追加する
• ボットからのダイアログを使用する
• 受信 Webhook を作成する
• Teams アプリ固有の分析のインストルメント化