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

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. ボットをプロジェクトに接続するには、最初のメッセージとして !setupme（自分専用）または !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.

ボットをプロジェクトに接続する​

ボットは Odin プロジェクトから回答し、プロジェクトの操作には API キーとシークレットを使用します。接続方法は 2 つあり、どちらも Teams で短いフォームを開きます。チャネルやグループ チャットでコマンドを送信するときは、@Odin !setup のようにボットを @メンションしてください。

共有接続 (!setup)​

!setup は、プロジェクト ID と、そのプロジェクトにアクセスできる API キーとシークレットを使って、会話の全員向けにプロジェクトを接続します。

既定では、共有接続の粒度は ボットごと、Teams インスタンスごと です。すべてのチャネル、グループ、ダイレクト メッセージを含む Teams インスタンス全体に適用されます。

個人接続 (!setupme)​

!setupme は、自分の Odin アカウントを接続します。自分のアカウント設定にある API キーとシークレット（プロジェクト レベルのキーは使用できません）と、必要に応じてアクセス権のあるプロジェクト ID を入力します。個人の Autopilot プロジェクトを使う場合は、プロジェクト ID を空欄のままにします。

個人接続は自分にのみ回答し、常に共有接続より優先されます。!resetme で個人接続を削除すると、ボットは再び共有接続から回答します。

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

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

TEAMS_USE_PER_CHANNEL_SETTINGS=TRUE

この変数を設定すると、!setup はチャネルごと（ダイレクト メッセージでは個人ごと）にプロジェクトを接続し、チャネルで !setupme を使って作成した個人接続はそのチャネルにのみ適用されます。ダイレクト メッセージで作成した個人接続は、ボットとのダイレクト メッセージに適用されます。

情報

この設定は オンプレミスのお客様 のみが利用できます。クラウド ホスト型のデプロイではサポートされていません。

エージェントの選択​

ボットは、プロジェクトに現在設定されている既定のエージェントで回答します。Project ID を指定しない個人接続は自分の Autopilot プロジェクトを使用し、Odin の Autopilot エージェントとして回答します。

プロジェクトが Teams App の設定でエージェントの選択を許可をオンにすると、個人接続（!setupme）を持つメンバーは自分用に別のエージェントを選べます。!agent と入力するか、ホームカードの Change agent を押して、Odin の Web チャットで自分のロールが使えるエージェント（Autopilot を含む）から選びます。Project default は、後で変わった場合も含め、常にプロジェクトに設定されているエージェントに従います。

選択は自分の接続にのみ適用されます。同じプロジェクトで !setupme をやり直しても保持され、別のプロジェクトに接続するとクリアされます。エージェントを切り替えても会話の履歴はそのまま残ります。共有接続（!setup）は常にプロジェクトの既定のエージェントで回答します。選んだエージェントが削除されたり、ロールがそのエージェントにアクセスできなくなったりした場合は、ボットが一度だけ知らせてプロジェクトの既定に戻ります。設定をオフにすると、全員が既定に戻ります。

ボットの使い方​

ホーム カード​

!home と入力すると、ボットが接続しているプロジェクト、ボットにできること、試せる質問の例が表示されます。カードには、プロジェクトの変更とプロジェクトの連携の一覧表示のためのボタンがあります。個人チャットに初めてインストールされたときにも表示されます。 接続でエージェントを選べる場合は、回答中のエージェントと Change agent ボタンもカードに表示されます。

ライブ ステータス​

エージェントが作業している間、ボットは回答が届く前に作業内容（Thinking... や使用中のツール）を表示します。個人チャットではライブ ステータス行として表示され、チャネルやグループ チャットではボットのメッセージがその場で更新されます。会話に残るのは最終的な回答だけです。Teams アプリの設定 の ライブステータス トグルでオフにできます。

連携の接続​

エージェントがまだ接続されていない連携を必要とすると、ボットはカードを投稿します。

  • OAuth でサインインするサービス（Gmail や Notion など）の場合は、Connect を選択し、ブラウザーでサインインを完了してから Continue を選択します。
  • API キーやトークンを使うサービスの場合は、Connect を選択し、表示されるフォームに資格情報を入力します。

!integrations は、プロジェクトが接続している連携と接続できる連携を一覧表示します。連携の接続と切断は Odin で行います。

承認と質問​

承認が必要なアクションをエージェントが実行しようとすると、ボットはアクションの詳細を Allow と Deny ボタン付きで表示します。追加の情報が必要な場合は、Teams で直接回答できる短いフォームで質問します。

ボットが受け付けるすべてのコマンドについては、利用可能なコマンド を参照してください。