Teams 会話ボットを作成する手順 - Teams

Microsoft Teams会話ボットを使用すると、ユーザーはテキスト、対話型カード、ダイアログ (TeamsJS v1.x のタスクモジュールと呼ばれます) を介して Web サービスと対話できます。基本的な会話は、1 つの REST API である Bot Framework コネクタを介して処理されます。この API を使用すると、ボットは Teams やその他のチャネルと通信できます。

Bot Builder SDK の主な機能

Bot Framework コネクタへのアクセスを提供します。
会話フローと状態を管理します。
自然言語処理 (NLP) などのコグニティブサービスが組み込まれています。

ボットがグループまたはチームに追加されると、概要メッセージが送信されます。メッセージには、ボットの機能とその使用方法の簡単な説明が表示されます。

このステップバイステップガイドは、Teams アプリケーションで会話ボットを作成するのに役立ちます。次の出力を確認できます。

前提条件

残り 16 分

次のツールをインストールし、開発環境を設定していることを確認します。

	インストール	使用するには...
	Microsoft 365 開発者アカウント	アプリをインストールするための適切なアクセス許可を持つ Teams アカウントにアクセスします。
	Visual Studio 2022	Visual Studio 2022 でエンタープライズバージョンをインストールし、ASP.NET および Web 開発ワークロードをインストールできます。最新バージョンを使用します。
	.NET Core SDK	ローカルデバッグとAzure Functionsアプリのデプロイ用にカスタマイズされたバインド。最新バージョンをインストールしていない場合は、移植可能なバージョンをインストールします。
	Microsoft Teams	Microsoft Teams、チャット、会議、通話を 1 か所で行うアプリを通じて作業するすべてのユーザーと共同作業を行う
	開発トンネル	Teams アプリの機能 (会話型ボット、メッセージ拡張機能、受信 Webhook) には、受信接続が必要です。トンネルは、開発システムを Teams に接続します。開発トンネルは、localhost をインターネットに安全に開き、アクセス権を持つユーザーを制御するための強力なツールです。開発トンネルは、Visual Studio 2022 バージョン 17.7.0 以降で使用できます。または ngrok をトンネルとして使用して、開発システムを Teams に接続することもできます。タブのみを含むアプリには必要ありません。このパッケージはプロジェクトディレクトリ内にインストールされます (npm `devDependencies` を使用)。

注:

ngrok をダウンロードしたら、サインアップして authtoken をインストールします。

ローカル環境を設定する

残り 15 分

Microsoft-Teams-Samples を開きます。
[ コード] を選択します。
ドロップダウンメニューから、[ GitHub Desktop で開く] を選択します。
[ 複製] を選択します。

アプリMicrosoft Entra登録する

残り 14 分

Azure でボットを開発してホストするときに、ボットを Azure Bot サービスに登録します。手順は次のとおりです。

ボットを Azure Bot サービスに登録します。
ボットのシングルサインオン (SSO) 認証を有効にするクライアントシークレットを作成します。
Teams チャネルを追加してボットをデプロイします。
開発トンネル (推奨) または ngrok を使用して、Web サーバーのエンドポイントへのトンネルを作成します。
作成した開発トンネルにメッセージングエンドポイントを追加します。

アプリの登録を追加する
1. Azure ポータルに移動します。
2. [アプリの登録] を選択します。
3. [ + 新規登録] を選択します。
4. アプリの名前を入力します。
5. 任意の組織ディレクトリ (Any Microsoft Entra ID tenant - Multitenant) の [アカウント] を選択します。
6. [登録] を選択します。
  
  アプリはMicrosoft Entra IDに登録されています。アプリの概要ページが表示されます。
  
  注:
  
  さらに使用するために 、アプリケーション (クライアント) ID と ディレクトリ (テナント) ID からアプリ ID を 保存します。
トンネルを作成する
- dev tunnel
- ngrok
1. Visual Studio を開きます。
2. [ プロジェクトまたはソリューションを開く] を選択します。
3. microsoft-Teams-Samples >サンプル>ボット会話> csharp に移動します。
4. ファイル TeamsConversationBot.sln 選択します。
5. 概要ウィンドウが表示されます。
6. デバッグドロップダウンリストで、[Dev Tunnel (アクティブトンネルなし)]>[トンネルの作成]を選択します。...
  
  ポップアップウィンドウが表示されます。
7. ポップアップウィンドウで次の詳細を更新します。
  1. アカウント: Microsoft または GitHub アカウントを入力します。
  2. [名前]: トンネルの名前を入力します。
  3. トンネルの種類: ドロップダウンリストから [ 一時] を選択します。
  4. アクセス: ドロップダウンリストから [パブリック] を選択 します。
8. [OK] を選択します。
  
  開発トンネルが正常に作成されたことを示すポップアップウィンドウが表示されます。
9. [OK] を選択します。
  
  作成したトンネルは、次のようにデバッグドロップダウンリストにあります。
10. F5 キーを押して、デバッグモードでアプリケーションを実行します。
11. [セキュリティ警告] ダイアログが表示されたら、[はい] を選択します。
  
  ポップアップウィンドウが表示されます。
12. [続行] を選択します。
  
  開発トンネルのホームページが新しいブラウザーウィンドウで開き、開発トンネルがアクティブになりました。
13. Visual Studio に移動し、[ 表示] > [出力] を選択します。
14. [出力コンソール] ドロップダウンメニューで、[Dev Tunnels]\(開発トンネル\) を選択します。
  
  出力コンソールには、開発トンネル URL が表示されます。
ngrok またはコマンドプロンプトを使用して、ローカルで実行されている Web サーバーのパブリックに利用可能な HTTPS エンドポイントへのトンネルを作成します。 ngrok で次のコマンドを実行します。
```
ngrok http --host-header=localhost 3978
```
ヒント

ERR_NGROK_4018が発生した場合は、コマンドプロンプトに記載されている手順に従ってサインアップし、ngrok を認証します。 ngrok http --host-header=localhost 3978 コマンドを実行します。

ウィンドウに HTTPS URL が表示されます。

Web 認証を追加する

左側のウィンドウの [ 管理] で、[ 認証] を選択します。
[プラットフォームの追加>Web] を選択します。
完全修飾ドメイン名に auth-end を追加して、アプリのリダイレクト URI を入力します。たとえば、https://your-devtunnel-domain/auth-end および https://your-ngrok-domain/auth-end が禁止となります。
[ 暗黙的な許可とハイブリッドフロー] で、[ アクセストークン と ID トークン ] チェックボックスをオンにします。
[構成] を選択します。
[ Web] で、[ URI の追加] を選択します。
https://token.botframework.com/.auth/web/redirect を入力します。
[保存] を選択します。

クライアントシークレットを作成する

左側のウィンドウの [ 管理] で、[ 証明書 & シークレット] を選択します。
[ クライアントシークレット] で、[ + 新しいクライアントシークレット] を選択します。

[ クライアントシークレットの追加] ウィンドウが表示されます。
「説明」と入力します。
[追加] を選択します。
[ 値] で、[ クリップボードにコピー ] を選択して、クライアントシークレットの値を保存して、さらに使用します。

API アクセス許可を追加する

左側のウィンドウで、[ API アクセス許可] を選択します。
[ + アクセス許可の追加] を選択します。
[Microsoft Graph] を選択します。
[アプリケーションのアクセス許可] を選択します。
[ ユーザー>User.Read.All] を選択します。
[アクセス許可の追加] を選択します。

注:

アプリに IT 管理者の同意が付与されていない場合、ユーザーは初めてアプリを使用する際に同意を提供する必要があります。
ユーザーは、Microsoft Entra アプリが別のテナントに登録されている場合にのみ、API のアクセス許可に同意する必要があります。

アプリケーション ID URI の追加

左側のウィンドウの [ 管理] で、[ API の公開] を選択します。
[アプリケーション ID URI] の横にある [追加] を選択します。
アプリケーション ID URI をapi://your-devtunnel-domain/botid-{AppID}またはapi://your-ngrok-domain/botid-{AppID}形式で更新し、[保存] を選択します。

次の図は、ドメイン名を示しています。

スコープを追加する

左側のウィンドウの [ 管理] で、[ API の公開] を選択します。
[ + スコープの追加] を選択します。
スコープ名として「access_as_user」と入力します。
[ 同意できるユーザー] で、[ 管理者とユーザー] を選択します。
残りのフィールドの値を次のように更新します。
- 「Teams は同意の表示名としてユーザーのプロファイル管理アクセスできます」と入力します。
- 「Teams が同意の説明として現在のユーザーとしてアプリの Web API を呼び出管理許可する」と入力します。
- 「Teams」と入力すると、ユーザープロファイルにアクセスし、ユーザーの代わりにユーザーの同意表示名として要求を行うことができます。
- ユーザーの同意の説明と同じ権限を持つこのアプリの API を呼び出すには、「Teams を有効にする」と入力します。
[状態] が [有効] に設定されていることを確認してください。
[スコープの追加] を選択します。

次の図は、フィールドと値を示しています。

注:

スコープ名は、最後に追加/access_as_userアプリケーション ID URI と一致する必要があります。

クライアントアプリケーションを追加する

左側のウィンドウの [ 管理] で、[ API の公開] を選択します。

[ 承認されたクライアントアプリケーション] で、アプリの Web アプリケーションに対して承認するアプリケーションを特定します。
[ + クライアントアプリケーションの追加] を選択します。
Teams モバイルまたはデスクトップと Teams Web アプリケーションを追加します。
1. Teams モバイルまたはデスクトップの場合: 1fec8e78-bce4-4aaf-ab1b-5451cc387264としてクライアント ID を入力します。
2. Teams Web の場合: 5e3ce6c0-2b1f-4285-8d4b-75ee78787346としてクライアント ID を入力します。
[ 承認されたスコープ ] チェックボックスをオンにします。
[アプリケーションの追加] を選択します。

次の図は、 クライアント ID を表示します。

ボットを作成する

残り 9 分

Azure ボットリソースを作成する

注:

Teams でボットを既にテストしている場合は、このアプリと Teams からサインアウトします。この変更を確認するには、もう一度サインインします。

[ホーム] に移動します。
[ + リソースの作成] を選択します。
検索ボックスに「 Azure Bot」と入力します。
Enter キーを押します。
[ Azure Bot] を選択します。
[作成] を選択します。
ボットハンドルにボット名を入力します。
ドロップダウンリストから [サブスクリプション] を選択します。
ドロップダウンリストから [リソースグループ] を選択します。

既存のリソースグループがない場合は、新しいリソースグループを作成できます。新しいリソースグループを作成するには、次の手順に従います。
1. [ 新規作成] を選択します。
2. リソース名を入力し、[ OK] を選択します。
3. [ 新しいリソースグループの場所 ] ドロップダウンリストから場所を選択します。
[ 価格] で、[ プランの変更] を選択します。
[ FO Free>Select] を選択します。
[Microsoft アプリ ID] で、[マルチテナントとしてのアプリの種類] を選択します。
[ 作成の種類] で、[ 既存のアプリの登録を使用する] を選択します。
アプリ ID を入力します。

注:

同じ Microsoft アプリ ID を持つ複数のボットを作成することはできません。
[確認 + 作成] を選びます。
検証に合格したら、[ 作成] を選択します。

ボットのプロビジョニングには数分かかります。
[リソースに移動] を選びます。

Azure ボットが正常に作成されました。

Teams チャネルを追加する

左側のウィンドウで、[チャネル] を選択 します。
[ 使用可能なチャネル] で、[ Microsoft Teams] を選択します。
チェックボックスをオンにして 、利用規約に同意します。
[ 同意する] を選択します。
[適用] を選択します。

メッセージングエンドポイントを追加するには

dev tunnel
ngrok

出力コンソールの開発トンネル URL をメッセージングエンドポイントとして使用します。
左側のウィンドウの [ 設定] で、[ 構成] を選択します。
メッセージングエンドポイントを https://your-devtunnel-domain/api/messages 形式で更新します。
[適用] を選択します。

Azure Bot サービスでボットが正常に設定されました。

注:

Application Insights Instrumentation キーにエラーが表示される場合は、アプリ ID で更新します。

ngrok から HTTPS URL をコピーします。

注:

ngrok の HTTPS URL は、完全修飾ドメイン名です。 WebAppDomainは、https://を含まない完全修飾ドメイン名です。
左側のウィンドウの [ 設定] で、[ 構成] を選択します。
メッセージングエンドポイントを https://your-ngrok-domain/api/messages 形式で更新します。
[適用] を選択します。

Azure Bot サービスでボットを正常に設定しました。

注:

Application Insights Instrumentation キーにアプリ ID を使用したエラー更新が表示される場合。

ボットサービス接続を設定する

残り 4 分

Teams で会話ボットを認証し、Teams アプリパッケージを作成し、それをorganizationにアップロードする方法を理解するようにボットを構成します。

Visual Studio でappsettings.json ファイルを更新します。
Visual Studio でmanifest.json ファイルを更新し、エクスプローラーの zip ファイルに圧縮します。
Visual Studio でソリューションを実行します。
ボットを Teams にアップロードします。

appsettings を更新するには

エクスプローラーで、Microsoft-Teams-Samples>サンプル>bot-conversation>csharp に移動します。
Visual Studio で appsettings.json ファイルを開き、ボットの構成を更新します。
- [ "MicrosoftAppType"] を [マルチテナント] に設定します。
- "MicrosoftAppId"をボットの Microsoft アプリ ID に設定します。
- "MicrosoftAppPassword"をボットのクライアントシークレット Value に設定します。
- "MicrosoftAppTenantId"をテナント ID に設定します。
[保存] を選択します。

マニフェストを更新するには

エクスプローラーで、Microsoft-Teams-Samples>サンプル>bot-conversation>csharp>TeamsApp>appPackage に移動します。
Visual Studio で manifest.json ファイルを開き、次の変更を行います。
- "id"と"botId"をボットの Microsoft アプリ ID に置き換えます。
- "validDomains"を、https://を除く ngrok ドメインに置き換えます。
appPackage フォルダーの内容を圧縮して、manifest.zip を作成します。

注:

manifest.zipに他のフォルダーを含めてはなりません。 zip フォルダー内には、ソースファイル、color アイコン、outline アイコンmanifest json必要があります。 Visual Studio でソリューションを実行し、organizationまたは Teams アカウントのデモテナントにマニフェストをアップロードします。

Visual Studio でソリューションを実行するには

Visual Studio を開きます。
[ ファイル>Open>Project/Solution.... を選択します。
Microsoft-Teams-Samples>サンプル>bot-conversation>csharp に移動します。
TeamsConversationBot.c#proj ファイルを選択します。
F5 キーを押してプロジェクトを実行します。
[ はい] を 選択して証明書をインストールします。

Web ページに、ボットの準備ができたというメッセージが表示されます。

アプリを Teams にアップロードするには

Teams クライアントで、[ アプリ ] アイコンを選択します。
[アプリの管理] を選択します。
[ アプリのアップロード] を選択します。
[カスタムアプリのアップロード] オプションを探します。オプションが表示されている場合は、カスタムアプリのアップロードが有効になります。

注:

カスタムアプリをアップロードするオプションが見つからない場合は、Teams 管理者に問い合わせてください。
[ 開く ] を選択して、 appPackage フォルダーに作成した .zip ファイルをアップロードします。
[追加] を選択します。

ボットと対話できます。

会話ボットと対話する

残り 3 分

Teams でボットを操作する場合は、メッセージを送信するか、コマンド一覧からコマンドを選択します。ボットが文字列に応答します。

Teams の左側のウィンドウで、[その他の追加されたアプリ (●●●)] を選択し、一覧からアプリを選択します。ボットには、次のように 提案が 表示されます。

MentionMe
ようこそ表示
MessageAllMembers
MessageAllMembersUsingAadId

[提案] カードを示すスクリーンショット。

MentionMe	ようこそ表示	MessageAllMembers

結果：ボットはメッセージに応答し、ユーザーメンションします。	結果：ボットは、対話するためのウェルカムカードを送信します。	結果：ボットは、現在の会話の各メンバーに 1 対 1 のメッセージを送信します。
有効なスコープ: 個人用、グループチャット、チームチャット。	有効なスコープ: 個人用、グループチャット、チームチャット。	有効なスコープ: 個人用、グループチャット、チームチャット。