ja usage platforms lark
ボットを作成する際、アダプター設定でプラットフォームドメインを選択する必要があります：
- 飞书 (open.feishu.cn)：国内の飛書ユーザー向け（デフォルト）
- Lark (open.larksuite.com)：海外のLarkユーザー向け
- カスタム (custom)：プライベートデプロイユーザー向け
Warning
海外版のLarkを選択する場合、open.larksuite.comドメインを使用してください。そうしないと、接続に失敗する可能性があります。プライベートデプロイユーザーは、実際のデプロイアドレスに応じてカスタムを選択し、対応するドメインを入力してください。
LangBot は Feishu アプリのワンクリック作成とクレデンシャルの自動入力に対応しています。手動でのコピペは不要です。
- LangBot WebUI を開き、ボット > ボットを作成 に移動
- ボット名を入力し、プラットフォーム/アダプターで
飞书を選択 - 表示される 一键创建应用 エリアで 開始 ボタンをクリック
- 飛書で QR コードをスキャンし、手机端で飞書開放平台のボット作成ページが表示されます
- 既存のアプリを使用 または 新規作成 を選択できます：
既存のアプリを選択すると、アプリ一覧が表示されます：
- 認証成功後、手机端に「設定成功」と表示され、app_id と app_secret が LangBot WebUI に自動入力されます
- ボット名を手動で入力 — 飛書のボット名と一致させる必要があります。一致しない場合、グループ内でメッセージを受信できません
- 送信 をクリックして完了
Feishu Open Platformにアクセスし、ログインして、企業の自己構築アプリケーションまたはストアアプリケーションを作成します。(違いの紹介)
アプリケーションにボット機能を追加します：
権限管理で画像に示されている権限を追加します：
カードストリーミング権限が必要な場合は、画像に示されている次のカード作成と更新権限を追加します：
Warning
デフォルトのカードテンプレートを変更する必要がある場合は、プラットフォームアダプターのコードでカードテンプレートを自分で修正する必要があります。
「認証情報と基本情報」ページで app_id と app_secret を見つけます。
LangBot の Webui 設定ページを開き、新しいボットを作成します
フォームに関連情報を入力します
ストリーミング関連：
入力後、LangBot を起動します。設定が成功した場合、ログに [01-29 23:42:56.796] manager.py (68) - [INFO] : Initializing platform adapter 1: lark と表示されます。LangBot を実行し続けてください。
Warning
デフォルトでは、WebSocket 長時間接続モードが使用されます。これは以下の長時間接続サブスクリプションに対応しています。ただし、場合によっては（国際版の Feishu など）、長時間接続モードが利用できない場合があります。その場合は、Webhook モードを使用する必要があります。これは、「開発者サーバーにイベントを送信」モードに対応しています。次の設定を参照してください：
-
enable-webhook：trueに設定 -
encrypt-key：「イベントとコールバック」ページの「暗号化戦略」の「Encrypt Key」に設定
Webhook モードでは、LangBot をパブリック IP を持つサーバーにデプロイし、ファイアウォールが上記で設定したポートを開いていることを確認する必要があることに注意してください。 [!TIP] パブリックサーバーがありませんか？ LangBot Cloud にはドメインと HTTPS が含まれており、Lark ボットをすぐに使用できます。
「イベントとコールバック」ページに移動し、サブスクリプション方式を「長時間接続」として設定します：
そして、イベント：「メッセージを受信」を追加します
コールバック設定を設定し、長時間接続のコールバックを選択します（webhook の場合は webhook を使用）
コールバックカードコールバックインタラクションを追加します
Warning
Webhook モード設定方法：
まず LangBot を起動してください。ここに LangBot から取得した Webhook アドレスを入力します。
上部の「バージョンを作成」をクリックし、バージョン番号とその他の情報を入力し、下部の「保存」をクリックします。
ボットを Feishu グループに追加して使用します：
プライベートチャットでも直接使用できます
- ストアアプリのボットは、作成/保存直後にチャットメッセージに応答できません。app_ticket イベントの遅延メカニズムにより、正常に動作するまで約 2 分待つ必要があります。