との統合 Microsoft Teams

IBM Cloud

Microsoft Teams にチャットボットを追加して、コンテンツ、ツール、人々が集まってチャット、ミーティング、コラボレーションを行う生産的なハブを作成、カスタマイズできます。

アクションを作成した 後、この統合を使用してアシスタントを Microsoft Teams に接続することができます。

開始前に

アシスタントを Microsoft Teams に統合するには、 Global Administrator、または Teams Administrator のロールが必要です。 詳しくは、 アプリ権限ポリシーを参照してください。

Microsoft 365 開発者管理者の E メール・アドレスがない場合は、登録します。

  1. Microsoft Dev Centerにアクセスします。

  2. 「今すぐ参加」 をクリックして、 Microsoft 365 Developer プログラムのメンバーになります。

  3. ダッシュボードで、 「 E5 サブスクリプションのセットアップ」 をクリックし、 「インスタント」 サンドボックスまたは 「構成可能」 サンドボックスを選択します。

  4. 「管理者」 にリストされている E メール・アドレスをコピーします。 管理者の資格情報は、いくつかのセットアップ・ポイントで必要になります。

Microsoft Teams との統合

  1. **「統合」**ページに移動します。それには、左側のメニューにある統合アイコン (統合アイコン) をクリックします。

  2. Microsoft Teams タイルの 追加 をクリックする。

  3. 「確認」 をクリックします。 「開始」 ページには、セットアップ・プロセスの要約が表示されます。

  4. 「次へ」 をクリックして、アプリの登録を開始します。

アプリ登録

  1. Microsoft Azure ポータルに移動し、管理者資格情報を使用してログインします。

  2. 「アプリ登録 (App registrations)」 ページで、 「新規登録 (New registration)」 をクリックします。

  3. 「アプリケーションの登録」 ページで、名前を入力し、アプリに適用するマルチテナント・オプションを選択し、 「登録」 をクリックします。

  4. アプリの概要ページからアプリIDをコピーし、 watsonx Assistant Microsoft Teams インテグレーションのアプリ登録フィールドに貼り付けます。

  5. 同じ Microsoft Azure 「概要」 ページで、「クライアント資格情報」の横にあるハイパーリンク 「証明書またはシークレットの追加」 をクリックします。

  6. トークン作成の 「証明書」&「シークレット」 ページで、 「新規クライアント・シークレット」 をクリックします。 説明を入力し、 「推奨 180 日」 を選択します。 **「追加」**をクリックします。

  7. Value] の下にある文字列をコピーし、 watsonx Assistant Microsoft Teams インテグレーションのアプリ登録ページの Client secret value に貼り付けます。 注: 現在の値が 180 日目に期限切れになる前に、新しい値を生成する 必要があります。

  8. 次へ」をクリックしてボットを作成します。

ボットの作成

  1. Microsoft Bot Framework 開発者ポータルに移動し、管理者資格情報を使用してログインします。

  2. 「ボットについて教えてください (Tell us about your bot)」 ページで、ボット・プロファイルを入力します。

  3. watsonx Assistant Microsoft Teams インテグレーションのボット作成ページから生成されたエンドポイントをコピーし、 設定セクションのメッセージングエンドポイントフィールドに貼り付けます。

  4. アプリのタイプとしてマルチテナントを選択します。

  5. アプリ ID をコピーして貼り付け、 「登録」 をクリックします。

  6. Connect to channels ページで、 Add a featured channel セクションの Configure Microsoft Teams channel をクリックします。

  7. 設定 Microsoft Teams ページで、 メッセージング、 呼び出し、 出版 タブでボットのニーズに合ったオプションを指定し、 セーブ をクリックします。

  8. watsonx Assistant Microsoft Teams の統合で、 「次へ 」をクリックしてTeamsアプリを作成します。

チーム・アプリの作成

  1. Microsoft Teams Developer Portal にアクセスし、管理者認証情報でログインします。

  2. Apps タブで New Appをクリックします。

  3. 名前を入力し、 「追加」 をクリックします。

  4. 「基本情報」 ページで、アプリケーション名、アプリケーション ID、説明、開発者情報、およびアプリケーション URL を入力し、アプリケーション ID をコピーして アプリケーション (クライアント) ID に貼り付けます。 「保存」 をクリックします。

  5. 「構成」 セクションで、 「アプリの機能」 を選択し、 「ボット」 を選択します。

  6. 「ボットの識別 (Identify your bot)」 ページで、ボットを選択します。

  7. 「ユーザーがこのコマンドを使用できる範囲を選択してください」 セクションで、 「個人」、 「チーム」、および 「グループチャット」 を選択します。

  8. 「保存」 をクリックしますが、ウィンドウは開いたままにします。

  9. watsonx Assistant Microsoft Teams の統合で、[ 完了] をクリックします。

  10. 「公開」 をクリックして、ボットを公開します。

Microsoft Teams の会話中にカスタム拡張機能が実行される場合、クライアントは、拡張機能への呼 び出しが完了した後にのみ、実行前のステップを受け取る。 詳細は、 カスタム拡張子の呼び出し を参照してください。

チーム・アプリの公開

  1. Teamsアプリを作成して保存した Microsoft Teams Developer Portalウィンドウで、 Publishをクリックしてボットを公開します。

  2. 「アプリケーション・パッケージのダウンロード」 をクリックします。

  3. にアクセスしてください。 Microsoft Teams にアクセスし、管理者認証情報でログインする。

  4. サイドバー・メニューで 「アプリケーション」 をクリックし、 「アプリケーションの管理」 をクリックし、 「アプリケーションのアップロード」 をクリックします。

  5. Upload a custom appを選択し、ダウンロードしたアプリパッケージ圧縮ファイルを指定します。

  6. Addをクリックして完了。

  7. チーム・アプリの 「チャット」 セクションでアクションと応答をテストします。

応答タイプ

これらの レスポンスタイプは、 Microsoft Teams ダイレクトメッセージ、チャンネル、またはグループチャットにアシスタントが配置されている場合にサポートされ、期待どおりに表示されます。

  • 日付
  • イメージ
  • オプション
  • 推奨
  • テキスト

制限

Microsoft Teams では、 オプションボタンは、アクションからレンダリングされたものであれ、ダイアログノードからレンダリングされたものであれ、選択した後もアクティブなままです。 これらのボタンは、会話中に複数回クリックすることができ、クリックするたびに、同じペイロードが watsonx Assistant に再送信される。 このような動作は、重複処理を引き起こし、予期せぬ、あるいは誤ったフォローアップ回答を招く可能性がある。

この制限は、 Microsoft Teams チャンネルに特有のものである。 ウェブチャットや、 watsonx Assistant の Try it Out ページのような他のチャンネルでは、 Option ボタンは最初のクリックで無効になり、再選択はできません。