検索ベースのメッセージ拡張機能を構築する

メッセージ拡張機能を使用すると、ユーザーはMicrosoft Teams クライアントで Web サービスと対話できます。 メッセージ作成領域、コマンド ボックス、またはメッセージから直接外部システムを検索するのに役立ちます。

検索ベースのメッセージ拡張機能の主な機能:

• ユーザーが外部システムを検索できるようにする。
• 検索結果をカード形式のメッセージに挿入します。

このステップ バイ ステップ ガイドは、検索ベースのメッセージ拡張機能を構築するのに役立ちます。 次の出力が表示されます。

前提条件

• 残り 13 分

次のツールをインストールし、開発環境をセットアップしてください。

ローカル環境を設定する

• 残り 12 分

1. Microsoft-Teams-Samples を開きます。

2. [ コード] を選択します。

3. ドロップダウン メニューから、[ GitHub Desktop で開く] を選択します。

   

4. [ 複製] を選択します。

Microsoft Entra アプリを登録する

• 残り 11 分

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

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

アプリの登録を追加する

1. Azure ポータルに移動します。

2. [アプリの登録] を選択します。

   

3. [ + 新規登録] を選択します。

   

4. アプリの名前を入力します。

5. 任意の組織ディレクトリ (任意の Microsoft Entra ID テナント - マルチテナント) で [アカウント] を選択します。

6. [登録] を選択します。

   

   アプリは Microsoft Entra ID に登録されています。 アプリの概要ページが表示されます。

   

   注:

   さらに使用するために 、アプリケーション (クライアント) ID と ディレクトリ (テナント) ID からアプリ ID を 保存します。

トンネルを作成する

ngrok http --host-header=localhost 3978

Web 認証を追加する

1. 左側のウィンドウの [ 管理] で、[ 認証] を選択します。

2. [プラットフォームの追加>Web] を選択します。

   

3. 完全修飾ドメイン名に auth-end を追加して、アプリのリダイレクト URI を入力します。 たとえば、https://your-devtunnel-domain/auth-end および https://your-ngrok-domain/auth-end が禁止となります。

4. [ 暗黙的な許可とハイブリッド フロー] で、[ アクセス トークン と ID トークン ] チェック ボックスをオンにします。

5. [構成] を選択します。

   

6. [ Web] で、[ URI の追加] を選択します。

7. https://token.botframework.com/.auth/web/redirect を入力します。

8. [保存] を選択します。

   

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

1. 左側のウィンドウの [ 管理] で、[ 証明書 & シークレット] を選択します。

2. [ クライアント シークレット] で、[ + 新しいクライアント シークレット] を選択します。

   

   [ クライアント シークレットの追加] ウィンドウが表示されます。

3. 「説明」と入力します。

4. [追加] を選択します。

   

5. [ 値] で、[ クリップボードにコピー ] を選択して、クライアント シークレットの値を保存して、さらに使用します。

   

API アクセス許可の追加

1. 左側のウィンドウの [ 管理] で、[ API のアクセス許可] を選択します。

2. [ + アクセス許可の追加] を選択します。

   

3. [Microsoft Graph] を選択します。

4. [委任されたアクセス許可] を選択します。

5. 次のアクセス許可を選択します。

   • OpenId アクセス許可>電子メール、 offline_access、 openid、 プロファイル。
   • ユーザー>User.Read。

6. [アクセス許可の追加] を選択します。

   

   注:

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

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

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

2. [アプリケーション ID URI] の横にある [追加] を選択します。

   

3. アプリケーション ID URI をapi://your-devtunnel-domain/botid-{AppID}またはapi://your-ngrok-domain/botid-{AppID}形式で更新し、[保存] を選択します。

   

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

   

スコープを追加する

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

2. [ + スコープの追加] を選択します。

   

3. スコープ名として「access_as_user」と入力します。

4. [ 同意できるユーザー] で、[ 管理者とユーザー] を選択します。

5. 残りのフィールドの値を次のように更新します。

   • 「Teams は管理者の同意表示名としてユーザーのプロファイルにアクセスできます」と入力します。

   • 「Teams でアプリの Web API を現在のユーザーとして管理者の同意の説明として呼び出すことができます」と入力します。

   • 「Teams」と入力すると、ユーザー プロファイルにアクセスし、ユーザーの代わりにユーザーの同意表示名として要求を行うことができます。

   • ユーザーの同意の説明と同じ権限を持つこのアプリの API を呼び出すには、「Teams を有効にする」と入力します。

6. [状態] が [有効] に設定されていることを確認してください。

7. [スコープの追加] を選択します。

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

   

   注:

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

   

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

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

   [ 承認されたクライアント アプリケーション] で、アプリの Web アプリケーションに対して承認するアプリケーションを特定します。

2. [ + クライアント アプリケーションの追加] を選択します。

   

3. Teams モバイルまたはデスクトップと Teams Web アプリケーションを追加します。

   1. Teams モバイルまたはデスクトップの場合: 1fec8e78-bce4-4aaf-ab1b-5451cc387264としてクライアント ID を入力します。

      

   2. Teams Web の場合: 5e3ce6c0-2b1f-4285-8d4b-75ee78787346としてクライアント ID を入力します。

      

4. [ 承認されたスコープ ] チェック ボックスをオンにします。

5. [アプリケーションの追加] を選択します。

   

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

   

ボットを作成する

• 残り 6 分

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

1. [ホーム] に移動します。

2. [ + リソースの作成] を選択します。

3. 検索ボックスに「 Azure Bot」と入力します。

4. Enter キーを押します。

5. [ Azure Bot] を選択します。

6. [作成] を選択します。

   

7. ボット ハンドルにボット名を入力します。

8. ドロップダウン リストから [サブスクリプション] を選択します。

9. ドロップダウン リストから [リソース グループ] を選択します。

   

   既存のリソース グループがない場合は、新しいリソース グループを作成できます。 新しいリソース グループを作成するには、次の手順に従います。

   1. [ 新規作成] を選択します。
   2. リソース名を入力し、[ OK] を選択します。
   3. [ 新しいリソース グループの場所 ] ドロップダウン リストから場所を選択します。

   

10. [ 価格] で、[ プランの変更] を選択します。

    

11. [ FO Free>Select] を選択します。

    

12. [Microsoft アプリ ID] で、[マルチテナントとしてのアプリの種類] を選択します。

13. [ 作成の種類] で、[ 既存のアプリの登録を使用する] を選択します。

14. アプリ ID を入力します。

    注:

    同じ Microsoft アプリ ID を持つ複数のボットを作成することはできません。

15. [確認 + 作成] を選びます。

    

16. 検証に合格したら、[ 作成] を選択します。

    ボットのプロビジョニングには数分かかります。

17. [リソースに移動] を選びます。

    

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

    

Teams チャネルを追加する

1. 左側のウィンドウで、[チャネル] を選択 します。

2. [ 使用可能なチャネル] で、[ Microsoft Teams] を選択します。

   

3. チェックボックスをオンにして 、利用規約に同意します。

4. [ 同意する] を選択します。

   

5. [適用] を選択します。

   

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

アプリ設定とマニフェスト ファイルを設定する

• 残り 5 分

1. 複製されたリポジトリ内の appsettings.json ファイルに移動します。

   

2. appsettings.json ファイルを開き、次の情報を更新します。

   • "MicrosoftAppType" を MultiTenant に設定します。
   • "MicrosoftAppId"をボットの Microsoft アプリ ID に設定します。
   • "MicrosoftAppPassword" を [クライアント シークレットの値] に設定します。
   • "MicrosoftAppTenantId"を空白に設定します。
   • "BaseUrl"を完全修飾ドメイン名に設定します。

   

3. 複製されたリポジトリ内の manifest.json ファイルに移動します。

   

4. manifest.json ファイルを開き、次の変更を行います。

   • <<YOUR-BASE-URL-DOMAIN>>をWebAppDomain名に置き換えます。
   • <<YOUR-MICROSOFT-APP-ID>>のすべての出現箇所をボットの Microsoft アプリ ID に置き換えます。

   

サービスをビルドして実行する

• 残り 4 分

サービスをビルドして実行するには、Visual Studio またはコマンド ラインを使用します。

dotnet run

検索メッセージ拡張機能アプリを追加する

• 残り 3 分

1. 複製したリポジトリで、 サンプル>msgext-search>csharp>TeamsAppManifest に移動します。

2. TeamsAppManifest フォルダーに存在する次のファイルを含む .zip を作成します。

   • manifest.json
   • icon-outline.png
   • icon-color.png

   

3. Teams クライアントで、[ アプリ ] アイコンを選択します。

4. [アプリの管理] を選択します。

5. [ アプリのアップロード] を選択します。

6. [カスタム アプリのアップロード] オプションを探します。 オプションが表示された場合は、アプリのアップロードが有効になります。

   

   注:

   カスタム アプリをアップロードするオプションが見つからない場合は、Teams 管理者に問い合わせてください。

7. [開く] を選択して、TeamsAppManifest フォルダーに作成した検索コマンド.zip ファイルをアップロードします。

   

8. [追加] を選択します。

   

Teams でアプリを操作する

• 残り 2 分

1. ポップアップ リストから任意のオプションを選択します。

   

2. テキストを入力し、[ 送信] を選択します。

   

   1. [ Nuget パッケージ] を選択します。

      

   2. [プロジェクト] を選択します。

      

課題の完了

• 残り 1 分

このようなものを思いついたのですか?

おめでとうございます。

• 100% 完了しました

Teams メッセージ拡張機能の検索を開始するためのチュートリアルを完了しました。