Lark Bot 連携
Multica エージェントを Lark（飞书）Bot に紐づければ、Lark の DM やグループからそのまま対話できます——@ でメンションして自然に話しかけたり、/issue と入力して Lark を離れずに Multica イシューを起票したりできます。
任意のエージェントを Lark（飞书）Bot に紐づければ、チームは Lark の中から直接それを使えます——Bot に DM したり、グループで @ メンションしたり、/issue と入力してアプリを開かずに Multica イシューを起票したりできます。エージェントの返信は、作業の進行に合わせて更新されるライブカードとしてチャットに戻ってきます。
各 Bot は 1 つの Multica エージェントと 1 対 1 で紐づきます。2 つ目のエージェントを紐づけると 2 つ目の Bot が作られます。1 つのエージェントが 2 つの Bot を持つことはありません。
この連携でできること
| 場所 | 動作 |
|---|---|
| エージェント → 連携 | エージェント詳細ページには 連携（Integrations） タブがあります（左サイドバーにも対応する区画があります）。owner と admin はそこに Lark に紐づける が表示され、紐づけると Lark に接続済み バッジと Lark で管理 リンクに切り替わります。 |
| Bot に DM | ワークスペースメンバーが Lark の中で Bot に直接メッセージを送ります。各会話はそのエージェントとの Multica chat セッションになり、エージェントはスレッド内で返信します。 |
| グループで @ メンション | Bot を Lark グループに追加して @ メンションします。読み取られるのはメンションしたメッセージだけで、Bot はグループ全体を聞いているわけではありません。 |
/issue コマンド | /issue <タイトル>（本文を続けてもよい）と入力すると、ワークスペースに新しい Multica イシューが作られ、あなたの名義になります。 |
| ライブ返信カード | Bot はインタラクティブなカードを投稿し、エージェントの実行に合わせて更新し続けます——進捗、最終的な回答、あるいはエラーが反映されます。 |
エージェントを紐づける（owner / admin）
紐づけはスキャンしてインストールするフローです——アプリのシークレットをコピーする必要も、開発者コンソールでの操作も不要です。
- Agents → あなたのエージェント からそのエージェントを開きます。
- 連携（Integrations） タブ（または左サイドバーの 連携 区画）を開き、Lark に紐づける をクリックします。
- QR コードが表示されます。スマートフォンで Lark → スキャン を開き、新しい PersonalAgent Bot を認可します。
- スキャンが完了するとダイアログが閉じ、エージェントに Lark に接続済み と表示されます。あなた自身の Lark アイデンティティは自動であなたの Multica アカウントに紐づくので、すぐに Bot と対話を始められます。
QR は使い切りで、短い時間が過ぎると失効します。認可する前に失効してしまったら、もう一度スキャン をクリックして新しいコードを取得してください。
エージェントが接続されると、Lark に紐づける ボタンは Lark で管理 リンクに置き換わります。スコープの調整、名前の変更、追加の権限の申請が必要なときは、これを使って Lark 内の Bot のアプリページを開いてください——再スキャンは意図的に無効化されており、既存の Bot を取り残してしまわないようにしています。
Bot を使う（メンバー）
最初のメッセージ：Lark アイデンティティを紐づける
初めて Bot にメッセージを送ると、Bot は Lark アイデンティティを紐づける よう促すカードで返信します。リンクをタップして Multica にサインインすると、あなたの Lark アカウントがあなたの Multica メンバーシップに紐づきます。これによって、エージェントがあなたとして振る舞えるようになります——たとえば /issue はあなたの名義でイシューを起票します。
Bot を使えるのは ワークスペースのメンバー だけです。メンバーでない場合や、アイデンティティの紐づけをスキップした場合、Bot は返信しません——あなたのメッセージは破棄されます（内容は保存せず、監査のために記録されます）。
対話と /issue
- エージェントに何でも聞く —— Bot に DM するか、グループで @ メンションします。会話は通常のエージェント chat セッションで、エージェントはカードの中で返信します。
- イシューを起票する ——
/issue Fix the login redirectと送れば、Multica は新しいイシューを作るのと同じやり方でそのイシューをワークスペースに作ります。タイトルの後ろに行を足せば、それが説明になります。 - 作業を見守る —— 返信カードはエージェントの実行に合わせて自身を更新するので、進捗と結果がその場で見えます。
エージェントが オフライン（ランタイムが接続されていない）または アーカイブ済み の場合、Bot はメッセージを黙って破棄するのではなく、短いステータス通知で返信します。
管理と切断
ワークスペース全体の管理は 設定 → 連携 にあります。
- 接続済みの Bot は、ワークスペース内のすべての Bot と、それぞれが紐づくエージェントを一覧表示します。この一覧はすべてのメンバーから見えます。
- 切断 は owner / admin 専用 です。切断すると Bot は Lark メッセージの受信を停止し、その接続が破棄されます。インストール記録は監査のために保持され、あとで同じエージェントを再び紐づけられます。
権限
- 紐づけ / 切断 にはワークスペースの owner または admin が必要です。member には接続済み Bot 一覧は見えますが、紐づけや切断の操作は見えません。
- Bot との対話 には、Lark アイデンティティを紐づけたワークスペースメンバーであることが必要です。それ以外の人のメッセージは一律に破棄されます。
- この連携は破棄されたメッセージの本文を保存することはありません——監査のために破棄理由だけを記録します。
セルフホストのセットアップ
Multica Cloud では連携はすでに利用可能です——このセクションは飛ばしてください。
セルフホストの場合、保存時の暗号化キーを設定するまで Lark はオフ です。このキーは、各 Bot の app secret がデータベースに触れる前にそれを暗号化します。
-
32 バイトのキーを生成し、API サーバーに設定します。
MULTICA_LARK_SECRET_KEY=<base64-encoded 32-byte key> -
API を再起動します。キーを設定するまで、設定 → 連携 には「Lark integration not enabled」という通知が表示され、Lark に紐づける のエントリポイントは非表示のままになります。
国際版テナント。 連携はデフォルトで中国大陸のホスト（open.feishu.cn）を使います。組織が Lark の国際版テナントにある場合は、トランスポートをそちらに向けてください。
MULTICA_LARK_HTTP_BASE_URL=https://open.larksuite.com