LangBot Docs
Langflow

把 Langflow 接入企业微信应用

使用 LangBot 把 Langflow 应用接入企业微信应用:Langflow 配置、机器人凭据、网络要求、测试与常见问题。

本文把你的 Langflow 应用接到企业微信应用机器人上。LangBot 接收企业微信应用消息,交给流水线处理后把答案发回去,你不需要写任何平台对接代码。

Langflow 用拖拽方式搭建 Agent 和流程。LangBot 在每条消息到来时通过 Langflow API 运行你的流程。

准备工作

  • 一个运行中的 LangBot:LangBot Cloud(无需服务器),或用 Docker、uvx langbot 自行部署。
  • LangBot 能通过网络访问到的 Langflow 账号或实例。
  • 企业微信自建应用:企业 ID、应用 Secret、通讯录同步 Secret,以及回调用的 Token 和 EncodingAESKey。

网络要求

企业微信通过回调地址推送消息,因此 LangBot 需要可公网访问的域名和 HTTPS(参考反向代理与 SSL)。LangBot Cloud 自带可直接使用的公网地址。

1. 准备 Langflow

  1. 在 Langflow 中搭建流程(可以从 Simple Agent 模板开始)。
  2. 在 Settings 中创建 API Key。
  3. 在 Share → API access 的示例代码中找到 Flow ID。

2. 创建流水线

在 LangBot WebUI 打开 流水线,新建流水线(或编辑默认流水线),按下表配置 AI 能力。如果列表里没有对应运行器,请先在 插件 或 LangBot Space 插件市场 安装官方运行器插件。

配置项填写
运行器Langflow(官方 Langflow Agent 运行器插件)
Base URLLangBot 能访问到的 Langflow 地址
API KeyLangflow API Key
Flow ID要运行的流程 ID

3. 创建企业微信应用机器人

  1. 新建机器人,选择 企业微信 适配器,填写企业 ID、应用 Secret 和通讯录同步 Secret,启用后复制 Webhook 回调地址。
  2. 在企业微信管理后台打开 接收消息 → 设置 API 接收,填入回调地址,随机生成 Token 和 EncodingAESKey,先在 LangBot 保存,再回到企业微信保存。最后在 企业可信 IP 中加入 LangBot 的出口 IP。

4. 绑定并测试

打开机器人,选择刚才创建的流水线,保存并确认机器人已启用。

在企业微信客户端打开该应用并发送消息。

常见问题排查

  • 连接被拒绝:只有 Langflow 与 LangBot 在同一主机、同一网络命名空间时,http://localhost:7860 才可用。
  • 保存回调时提示 请求 URL 失败:回调地址无法通过公网 HTTPS 访问,或 LangBot 中的 Token/EncodingAESKey 不一致。
  • 无法发出回复:把 LangBot 的出口 IP 加入企业可信 IP。
  • 在 WebUI 的 监控 页面可以看到每条消息、每次流水线运行和错误详情。

常见问题

接入企业微信应用需要有公网 IP 的服务器吗?

需要,或者直接使用 LangBot Cloud。企业微信通过回调地址推送消息,因此 LangBot 需要可公网访问的域名和 HTTPS(参考反向代理与 SSL)。LangBot Cloud 自带可直接使用的公网地址。

企业微信应用机器人支持流式回复吗?

请查看平台功能对照表了解该平台支持的能力;AI 后端生成完成后会一次性发送回复。

同一套 Langflow 配置能同时用在其他平台吗?

可以。一条流水线可以绑定多个机器人,同一套配置能同时在多个平台上回复。

相关文档

On this page