Coze
Coze を KOOK に接続する
LangBot で Coze アプリを KOOK のボットとして動かす手順：Coze の設定、ボットの認証情報、ネットワーク、テスト、トラブルシューティング。
このレシピではお使いの Coze アプリを KOOK のボットにつなぎます。LangBot が KOOK のメッセージを受け取り、パイプラインで処理して返信するので、プラットフォーム連携のコードは不要です。
Coze ではエージェントをビジュアルに作れます。LangBot は Coze API で Coze ボットを呼び出すため、Coze が直接公開できないプラットフォームにも同じボットを展開できます。
必要なもの
- 稼働中の LangBot：LangBot Cloud（サーバー不要）、または Docker や
uvx langbotによるセルフホスト。 - LangBot からネットワーク経由で到達できる Coze のアカウントまたはインスタンス。
- KOOK 開発者センターで作成したボットとその Bot Token。
ネットワーク
KOOK アダプターに必要なのはボットトークンだけで、LangBot から KOOK に接続します。
1. Coze を準備する
- Coze の開発者コンソールの API 管理 でトークンを作成します（coze.com は個人アクセストークン、coze.cn はサービス資格情報にも対応）。
- 公開時に API チャネルを選んでエージェントを公開し、
bot_idを控えます。
2. パイプラインを作成する
LangBot WebUI の パイプライン でパイプラインを作成（または既定のものを編集）し、AI を次のように設定します。ランナーが一覧にない場合は、プラグイン または LangBot Space マーケット から公式ランナープラグインをインストールします。
| 項目 | 設定値 |
|---|---|
| ランナー | Coze（公式 Coze Agent ランナープラグイン） |
| API Key | Coze のトークン |
| Bot ID | エージェントの bot_id |
| API Base URL | coze.cn は https://api.coze.cn、coze.com は https://api.coze.com |
3. KOOK のボットを作成する
- KOOK アダプターでボットを作成し、Bot Token を入力します。
- ボットの権限を設定し、サーバーへ招待します。
4. 紐付けてテストする
ボットを開いて作成したパイプラインを選び、保存してボットが有効になっていることを確認します。
ボットが読めるチャンネルで、トリガー条件に合うメッセージを送ります。
トラブルシューティング
- 呼び出しに失敗する場合は、トークンと
bot_idに余分な空白がないか、API チャネルで公開したか、Base URL が利用サイトと一致しているかを確認します。 - チャンネルで返信がない場合は、ボットのチャンネル権限とパイプラインのグループトリガー条件を確認します。
- WebUI の モニタリング に、すべてのメッセージ、パイプラインの実行、エラーが記録されます。
よくある質問
KOOK には公開 IP のあるサーバーが必要ですか？
いいえ。KOOK アダプターに必要なのはボットトークンだけで、LangBot から KOOK に接続します。
KOOK のボットはストリーミング返信に対応していますか？
対応状況はプラットフォーム機能一覧で確認してください。AI 側の生成が終わってから返信が送られます。
同じ Coze の設定を他のプラットフォームでも使えますか？
はい。1 つのパイプラインを複数のボットに紐付けられるので、同じ設定で複数のプラットフォームに同時に応答できます。
関連ガイド
- KOOK の詳しい設定ガイド
- Coze ランナーの詳しいガイド
- KOOK で使える他の AI：Dify · n8n · Langflow · DeepSeek · OpenAI (ChatGPT models)
- Coze を他のプラットフォームで使う：Telegram · Discord · Slack · Lark（Feishu） · DingTalk · WeCom（社内アプリ）