連携

Microsoft Teams 連携設定ガイド

自作の Bot Framework アプリで Kocoro のエージェントを Microsoft Teams に接続し、メンバーが個別チャットやグループチャットで直接エージェントと会話できるようにします。全体で約 10 分です。

はじめる前に

Teams 開発者ポータルでアプリとボットを作成できる Microsoft Teams / Microsoft 365 アカウント。
インストール・初期化済みの Kocoroと、作成済みのエージェントが少なくとも 1 つあること。
メッセージに応答するために起動し続ける Mac（Kocoro を稼働させるため）。

1
ボットを作成
Teams 開発者ポータルを開き、「Tools → Bot management」へ進み、「New bot」をクリックして名前（例：「Kocoro」）を入力し、「Add」をクリックします。作成後に表示される Bot ID は、Kocoro への登録時に使うので控えておきます。
- Teams 開発者ポータル: https://dev.teams.microsoft.com/
図 1：「Tools → Bot management」でボットを作成。
2
ボットのエンドポイントを Kocoro に向ける
作成したボットを開き、「Configure」でエンドポイントアドレスに下記の Kocoro Teams エンドポイントを設定し、「Save」をクリックします。
https://api.shannon.run/api/v1/channels/teams/events
図 2：ボットのメッセージエンドポイントを設定して保存。
3
クライアントシークレットを作成
「Client secrets」タブで「Add a secret」をクリックし、生成されたシークレットをコピーします。次のステップで Kocoro の App Password として貼り付けます。
シークレットは一度しか表示されません。すぐにコピーして安全に保管してください。紛失した場合は新しく作成します。
図 3：クライアントシークレットを作成してコピー。
4
Kocoro でボットを登録
Kocoro を開き、「Capabilities → Connectors」へ進み、「Microsoft Teams」の「Add Bot」をクリックします。Bot ID を App ID、クライアントシークレットを App Password として貼り付け、任意で表示名を設定して「Register Bot」をクリックします。
- 登録すると、Kocoro はこの認証情報で Teams の送受信メッセージを処理します。
- Connectors ページにはいつでも戻って接続状態を確認したり、ボットを削除したりできます。
図 4：認証情報を貼り付けて Kocoro でボットを登録。
5
アプリを作成
Teams 開発者ポータルに戻り、「Apps」で「New app」をクリックし、アプリ名を入力、マニフェストバージョンは最新の安定版のままにして「Add」をクリックします。このアプリは、ユーザーが Teams にボットをインストールするためのパッケージです。
図 5：「Apps」で新しいアプリを作成。
6
基本情報を入力
アプリの「Basic information」ページで、短い名前と短い/長い説明を入力します。ここの App ID は Microsoft が生成し、組織内で一意です。
図 6：アプリの基本情報を入力。
7
開発者情報と URL を追加
「Developer information」と「App URLs」までスクロールし、開発者/会社名、ウェブサイト、プライバシーポリシーと利用規約の URL を入力して「Save」をクリックします。
- プライバシーポリシー: https://kocoro.ai/ja/privacy/
- 利用規約: https://kocoro.ai/ja/terms/
図 7：開発者情報とアプリ URL を入力して保存。
8
アプリアイコンをアップロード
「Branding」で 2 つのアイコンをアップロードします：カラーアイコン（192×192px の PNG、中央に 96×96 のシンボル）とアウトラインアイコン（32×32px、白または透明）。下記の Kocoro アイコンを使えます。
カラーアイコン · 192×192
ダウンロード
アウトラインアイコン · 32×32（白 / 透明）
ダウンロード
図 8：「Branding」でカラーアイコンとアウトラインアイコンをアップロード。
9
Bot 機能を追加
「App features」を開き、「Select a feature to add」で「Bot」を選びます。
図 9：アプリに Bot 機能を追加。
10
ボットを指定して利用範囲を設定
「Identify your bot」で「Select an existing bot」を選び、ステップ 1 で作成したボットを選択します。続いて「Select the scopes where people can use your bot」で「Personal」と「Group Chat」にチェックを入れ、「Save」をクリックします。
図 10：既存のボットを選択し、利用範囲を選んで保存。
11
Teams でプレビュー
右上の「Preview in Teams」をクリックすると、Teams クライアントにアプリがインストールされます。
図 11：「Preview in Teams」をクリックしてインストール・テスト。