Langflow を DingTalk に接続する

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

Langflow はドラッグ＆ドロップでエージェントやフローを作れます。LangBot はメッセージごとに Langflow API でフローを実行します。

必要なもの

• 稼働中の LangBot：LangBot Cloud（サーバー不要）、または Docker や uvx langbot によるセルフホスト。
• LangBot からネットワーク経由で到達できる Langflow のアカウントまたはインスタンス。
• DingTalk アプリロボット（Client ID と Client Secret）。ワンクリック設定でスマートフォンから認可すると自動入力されます。

ネットワーク

Stream モードでは LangBot から DingTalk へ接続するため、公開コールバック URL は不要です。

1. Langflow を準備する

1. Langflow でフローを作成します（Simple Agent テンプレートから始めると簡単です）。
2. Settings で API キーを作成します。
3. Share → API access のサンプルコードから Flow ID を取得します。

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

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

3. DingTalk のボットを作成する

1. DingTalk アダプターでボットを作成して ワンクリック設定 を使うか、ロボットを手動で作成して認証情報を入力します。
2. イベント配信は Stream モード を使います。ストリーミング返信には LangBot の dingtalk_stream_card.json カードテンプレートをインポートし、カード返信を使用 を有効にしてテンプレート ID を入力します。

4. 紐付けてテストする

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

まずロボットと個別チャットし、次にグループへ追加してメンションします。

トラブルシューティング

• 接続が拒否される場合、http://localhost:7860 が使えるのは Langflow と LangBot が同じホスト・同じネットワーク名前空間にあるときだけです。
• ストリーミングでなくプレーンテキストで返る場合は、カードテンプレート未インポートか カード返信を使用 が無効です。
• メッセージが届かない場合は、アプリのバージョンを公開し、イベント購読で Stream モードが選ばれているか確認します。
• WebUI の モニタリング に、すべてのメッセージ、パイプラインの実行、エラーが記録されます。

よくある質問

DingTalk には公開 IP のあるサーバーが必要ですか？

いいえ。Stream モードでは LangBot から DingTalk へ接続するため、公開コールバック URL は不要です。

DingTalk のボットはストリーミング返信に対応していますか？

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

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

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

関連ガイド

• DingTalk の詳しい設定ガイド
• Langflow ランナーの詳しいガイド
• DingTalk で使える他の AI：Dify · n8n · Coze · DeepSeek · OpenAI (ChatGPT models)
• Langflow を他のプラットフォームで使う：Telegram · Discord · Slack · Lark（Feishu） · WeCom（社内アプリ） · WeCom インテリジェントボット