LangBot Docs
Coze

Coze を Lark(Feishu) に接続する

LangBot で Coze アプリを Lark(Feishu) のボットとして動かす手順:Coze の設定、ボットの認証情報、ネットワーク、テスト、トラブルシューティング。

このレシピではお使いの Coze アプリを Lark(Feishu) のボットにつなぎます。LangBot が Lark(Feishu) のメッセージを受け取り、パイプラインで処理して返信するので、プラットフォーム連携のコードは不要です。

Coze ではエージェントをビジュアルに作れます。LangBot は Coze API で Coze ボットを呼び出すため、Coze が直接公開できないプラットフォームにも同じボットを展開できます。

必要なもの

  • 稼働中の LangBot:LangBot Cloud(サーバー不要)、または Docker や uvx langbot によるセルフホスト。
  • LangBot からネットワーク経由で到達できる Coze のアカウントまたはインスタンス。
  • Feishu または Lark のカスタムアプリ(app_id と app_secret)。LangBot のワンクリック設定で作成と認可ができます。

ネットワーク

既定の WebSocket 長期接続では公開 IP は不要です。長期接続が使えない場合(一部の Lark 国際版など)は Webhook モードとなり、公開 HTTPS アドレスが必要です。LangBot Cloud には最初から用意されています。

1. Coze を準備する

  1. Coze の開発者コンソールの API 管理 でトークンを作成します(coze.com は個人アクセストークン、coze.cn はサービス資格情報にも対応)。
  2. 公開時に API チャネルを選んでエージェントを公開し、bot_id を控えます。

2. パイプラインを作成する

LangBot WebUI の パイプライン でパイプラインを作成(または既定のものを編集)し、AI を次のように設定します。ランナーが一覧にない場合は、プラグイン または LangBot Space マーケット から公式ランナープラグインをインストールします。

項目設定値
ランナーCoze(公式 Coze Agent ランナープラグイン)
API KeyCoze のトークン
Bot IDエージェントの bot_id
API Base URLcoze.cn は https://api.coze.cn、coze.com は https://api.coze.com

3. Lark(Feishu) のボットを作成する

  1. Lark アダプターでボットを作成し、プラットフォームのドメイン(Feishu / Lark)を選んで ワンクリック設定 を使うか、app_id と app_secret を手動入力します。
  2. ガイドに沿ってメッセージ権限とイベント購読(ストリーミングカードを使う場合はカード権限も)を追加し、アプリのバージョンを公開します。

4. 紐付けてテストする

ボットを開いて作成したパイプラインを選び、保存してボットが有効になっていることを確認します。

Feishu/Lark でボットを検索して DM を送り、グループに追加してメンションでも試します。

トラブルシューティング

  • 呼び出しに失敗する場合は、トークンと bot_id に余分な空白がないか、API チャネルで公開したか、Base URL が利用サイトと一致しているかを確認します。
  • メッセージが届かない場合は、アプリのバージョンが公開済みか、イベント購読方式(長期接続 / Webhook)が LangBot 側と一致しているかを確認します。
  • WebUI の モニタリング に、すべてのメッセージ、パイプラインの実行、エラーが記録されます。

よくある質問

Lark(Feishu) には公開 IP のあるサーバーが必要ですか?

必ずしも必要ではありません。既定の WebSocket 長期接続では公開 IP は不要です。長期接続が使えない場合(一部の Lark 国際版など)は Webhook モードとなり、公開 HTTPS アドレスが必要です。LangBot Cloud には最初から用意されています。

Lark(Feishu) のボットはストリーミング返信に対応していますか?

はい。ボットでストリーミングを有効にし、AI 側もストリーミングに対応している必要があります。詳しくはプラットフォーム機能一覧をご覧ください。

同じ Coze の設定を他のプラットフォームでも使えますか?

はい。1 つのパイプラインを複数のボットに紐付けられるので、同じ設定で複数のプラットフォームに同時に応答できます。

関連ガイド

On this page