メインコンテンツへスキップ

EKB チャットボットを MS Teams に統合する

EKB を Microsoft Teams と統合すると、インテリジェントでコンテキストを認識したチャットをチームのコラボレーション環境に直接導入できます。このガイドでは、Microsoft Teams で EKB チャットボットをセットアップする手順を説明し、Teams インターフェイスから離れることなく AI エージェントとのシームレスな通信を可能にします。

前提条件​

  • ボットを作成するための Azure への管理者アクセス権
  • Teams 開発ポータルへの管理者アクセス

セットアップ手順​

1. Azure ボットを作成する​

  1. Azure dashboard に移動します。
  2. [リソースの作成] をクリックします。
  3. 検索バーに「Bot」と入力し、Azure Bot を選択します。
  4. 新しい Azure ボットを作成し、目的の 表示名 を設定します。

2. ボットを構成する​

  1. [構成] タブに移動し、サーバー URL を指すように メッセージング エンドポイントを更新します。
    注意
    Cloud customers, please enter PLACEHOLDER_1
    On-Premise customers, please enter PLACEHOLDER_2

    Messaging Endpoint Configuration
  2. [構成] タブで、アプリ ID と テナント ID をコピーし、パスワードの管理 に移動します。
  3. ボットの新しいパスワードを作成し、後で使用できるように保存します。
  4. Azure でボットの ストリーミング エンドポイント を有効にし、そのエンドポイントの URL をポイントします。

3. Teams チャネルを有効にする​

  1. Azure portal の左側にある [チャネル] をクリックし、ボットの Teams 対話チャネルを有効にします。

4. EKB にボットを登録する​

注意
Cloud customers, please open a support ticket with AA Support providing your PLACEHOLDER_3, PLACEHOLDER_4, and PLACEHOLDER_5 to have the bot registered for you.
  1. EKB で、スーパー管理者 ページに移動し、左側にある Teams ボット を選択します。
  2. [ボットの登録] をクリックします。
  3. 手順 6 ～ 7 で収集した アプリ ID、テナント ID、パスワードを入力します。 [ボットの登録] をクリックします。

5. Teams 開発ポータルでアプリを作成する​

  1. Teams Developer Portal に移動します。
  2. [新しいアプリ] をクリックします。
  3. アプリ情報を入力します。
    • 簡単な説明 — 必須。空にすることはできません。
    • 長い説明 — 必須、空にすることはできません。
  4. Azure からのボットのアプリ ID を アプリ ID フィールドに入力します。

6. ボット機能の構成​

  1. [**アプリの機能*​​] に移動し、Azure からの アプリ ID を指定してボットを追加します。
  2. ボットの機能を次のように構成します。
    Teams Bot Capabilities

7. デプロイ​

  1. 新しい Teams アプリケーションを展開するための組織の標準ポリシーに従って、パッケージを展開します。
  2. ボットのプロジェクトへのアクセスを構成するには、最初のメッセージとして !setup コマンドを送信します。

推奨される展開方法​

  1. Publish to Org

    On the app page in the Microsoft Teams Developer Dashboard, scroll to the bottom of the left-hand sidebar. Under Publish, select Publish to org.
    Publish to Org

  2. Grant Admin Consent

    The app will be posted to your Teams instance and may require Administrator consent. Consent can be granted from the Microsoft Teams Admin Center.

  3. Wait for Propagation

    After consent is granted, allow a few hours for permissions to propagate before the bot becomes usable. This delay is caused by Microsoft's internal review process for custom applications, even when restricted to a single organization.

Teams ボット設定の粒度​

初期セットアップが完了したら、!setup コマンドをボットに送信して、Microsoft Teams での応答の受信を開始します。

デフォルトの動作​

デフォルトでは、ボット設定の粒度は ボットごと、Teams インスタンスごと です。ボット用に構成されたプロジェクト、API キー、シークレットは、すべてのチャネル、グループ、ダイレクト メッセージを含む Teams インスタンス全体に適用されます。

チャネルごとの設定 (オンプレミスのみ)​

チャネル、グループ、ユーザーに応じて複数のプロジェクトで 1 つのボットを使用するなど、より詳細な粒度を実現するには、次のバックエンド環境変数を設定します。```env TEAMS_USE_PER_CHANNEL_SETTINGS=TRUE


<Note>
  This setting is only available for **on-premise customers**. It is not supported for cloud-hosted deployments.
</Note>

### エージェントの選択

すべての構成で、Teams ボットはプロジェクトの**現在設定されているデフォルト エージェント**と対話します。現在、別のエージェントを選択するオプションはありません。