連携

Lark / Feishu 連携設定ガイド

Lark / Feishu のエージェントボットアプリで Kocoro のエージェントを Lark / Feishu に接続し、メンバーが個別チャットやグループチャットで直接エージェントと会話できるようにします。全体で約 3 分です。

はじめる前に

アプリを作成できる Lark / Feishu アカウント。
インストール・初期化済みの Kocoroと、作成済みのエージェントが少なくとも 1 つあること。
常時接続を維持するために起動し続ける Mac（公開 IP やドメインは不要）。

1
エージェントアプリを作成
Lark / Feishu 開発者プラットフォームのワンクリックアプリ作成ページを開き、アバターを選び、アプリ名を入力して「Create」をクリックします。このページ下部のボタンから直接アクセスできます。
- Lark: https://open.larksuite.com/page/launcher?from=backend_oneclick
- Feishu: https://open.feishu.cn/page/launcher?from=backend_oneclick
図 1：開発者プラットフォームでエージェントアプリを作成。
2
App ID と App Secret をコピー
アプリ作成後、App ID と App Secret が表示されます。コピーして Kocoro に貼り付けます。
App Secret は安全に保管してください。漏洩した場合はアプリの「Credentials & Basic Info」ページでリセットできます。
図 2：App ID と App Secret をコピー。
3
Kocoro でボットを登録
Kocoro を開き、「Capabilities → Connectors」へ進み、「Lark」/「Feishu」の「Add Bot」をクリックします。App ID と App Secret を貼り付け、受信メッセージに応答するエージェントを選び、任意で表示名を設定して「Register Bot」をクリックします。
- 登録が成功すると、ボットは即座に常時接続で Kocoro に接続します —— Lark / Feishu でボットにメッセージを送れば、選んだエージェントが返信します。
- Connectors ページでいつでも「Refresh」をクリックして接続状態を確認したり、ゴミ箱アイコンでボットを削除したりできます。
図 3：認証情報を貼り付けて Kocoro でボットを登録。
4
ユーザー基本情報を有効化
登録が成功すると、Kocoro が「ユーザー基本情報を有効化」を促します。これにより会話タイトルにユーザー名が正しく表示されます。「Open permissions page」をクリックして Lark / Feishu の権限設定へ進みます。
図 4：登録後、ユーザー基本情報を有効化。
5
「Obtain user's basic information」権限を追加
権限ページで「Obtain user's basic information (contact:user.base:readonly)」を検索して選択し、「Add Scopes」をクリックします。
contact:user.base:readonly
図 5：「Obtain user's basic information」権限を追加。
6
アプリを公開して変更を反映
「Version Management & Release」へ進み、利用可能範囲を設定して「Save」でバージョンを作成・公開します。権限の変更はアプリが公開（管理者承認）された後に反映されます。
「The changes will take effect after the current version is published」というバナーが表示されている場合は、このステップが必要です。
図 6：「Version Management & Release」でアプリを保存・公開。