LangBot：企业级即时通讯 AI 机器人平台 LLMops(dify,n8n,langflow,TBox,coze)平台接入指南

LangBot：企业级即时通讯 AI 机器人平台 LLMops(dify,n8n,langflow,TBox,coze)平台接入指南

“专为企业打造的即时通讯 AI 机器人平台，无缝集成飞书（Lark）、钉钉、企业微信等企业通讯工具，与 Dify 等 AI 应用平台深度整合，让企业 AI 应用快速落地。”

LangBot 项目地址 · LangBot 项目官网 · LangBot 社区 · 项目文档 · 我的博客

LangBot（原 QChatGPT）是一款专为企业设计的开源 AI 机器人平台，立项于 2021 年中。它专注于帮助企业将 AI 能力无缝集成到现有的工作流程中，特别针对使用飞书（Lark）和 Dify 的企业用户，提供了完整的解决方案，让企业能够快速部署智能客服、知识库助手、工作自动化等 AI 应用。

LLMops平台接入指南

什么是流水线（Pipelines）？

流水线控制了收到消息之后的处理流程，以及与大模型之间的信息交互。每个机器人可以绑定到一条流水线上，同一条流水线能被多个机器人绑定。

LangBot 首次启动时会自动创建一个默认的流水线。创建机器人时，会自动绑定到默认流水线。创建第一个模型时，会自动将其设置为默认流水线的模型。

您可以创建多条流水线，用于不同的机器人，适应不同的场景。

AI 能力配置

在流水线配置中，可以选择使用以下运行器：

• 内置 Agent（默认）
• Dify
• n8n
• Langflow
• TBox（蚂蚁百宝箱）
• Coze API

运行器定义了如何调度大模型处理消息。默认为内置 Agent，这是 LangBot 实现的一个多回合 Agent 策略，当且仅当选择此运行器时，才会使用 LangBot 内部配置的模型和工具。

您也可以选择使用Dify、n8n等外部 LLMOps 平台，这种情况下所使用的模型、提示词、工具等资源将由外部平台提供。

请求变量

当使用外部 LLMOps 平台时，LangBot 会显式传入以下参数，您可以在外部平台的开始节点中添加（以 Dify 为例）：

• launcher_type：发起对象类型，私聊为person，群聊为group
• launcher_id：发起对象ID，私聊为用户ID，群聊为群ID
• sender_id：发送者ID
• user_message_text：用户消息的纯文本内容
• session_id：用户会话id，私聊为person_<id>，群聊为group_<id>
• conversation_id：字符串，用户会话id，由 LangBot 生成。用户重置会话后，会重新生成
• msg_create_time：数字类型，收到此消息的时间戳（秒）
• group_name：群聊名称，仅在群消息事件时设置
• sender_name：发送者名称

您可以通过插件自定义任何变量

接入 Dify

Dify 是一款开源的大语言模型(LLM) 应用开发平台。它融合了后端即服务（Backend as Service）和 LLMOps 的理念，使开发者可以快速搭建生产级的生成式 AI 应用。
Dify 可以创建聊天助手（含Chatflow）、Agent、文本生成应用、工作流等应用。

LangBot 目前支持聊天助手（含Chatflow）、Agent、工作流三种 Dify 应用类型。

在 Dify 上创建应用

请根据 Dify文档 部署dify并创建你的应用。

发布应用后，在应用的访问API页面，生成 API 密钥。

保存 API 服务器和 API 密钥，在 LangBot 的流水线的AI 能力配置。

提示：以上为 Dify 云服务版本的示例，若您使用本地自部署的社区版本，请使用 LangBot 访问你自己 Dify 服务的地址作为base-url，后方需要添加/v1作为路径。

• 若 LangBot 与 Dify 部署在同一台主机，并且都是使用 Docker 部署的，可以参考文章：【网络配置详解】。其中，请将启动 Dify 的 docker-compose.yaml 中所有容器的networks均添加langbot-network，并为nginx容器添加容器名dify-nginx，最后在 LangBot 配置中将base-url设置为http://dify-nginx/v1。
• 其他情况请咨询贵司运维人员。

配置 LangBot

打开 LangBot WebUI 页面，添加一个新的流水线或在已有流水线中切换到 AI 能力配置页面。

工作流输出键

如果使用的是 Dify 的工作流应用，那么请使用summary作为键传递输出内容。

输出处理

使用 工作流 应用或 Agent 应用时，如果开启了 LangBot 流水线输出处理中的track-function-calls，将会在 Dify 执行每个工具调用时，输出一个调用函数xxx的消息给用户。
但如果是使用chat应用下的ChatFlow（聊天助手->工作流编排），无论如何只会输出 Answer（直接回复）节点返回的文本。

接入 n8n

n8n 是一款开源的自动化工作流平台，可以创建、调度、执行各种自动化任务。

LangBot 目前支持通过 n8n 工作流的Webhook节点，来触发工作流并获取回复。

选用 n8n 作为运行器

请打开已有的流水线配置页面，或新建流水线（推荐）并打开配置页面，到AI 能力中选择n8n 工作流 API作为运行器。

并根据下方内容设置并填写其他配置。

配置 n8n 工作流连接

or

需要选择Webhook或者On chat message触发，并参考下图配置：

• webhook
  
• on chat message
  

提示：如果要需要流式，其中的Response Mode都需要选择为Streaming。

提示：Authentication 对应 LangBot 流水线配置中的几种鉴权方式，可自行更改。

调用ai模型的节点可配置为AI Agent，并参考下图配置：

需要流式则将图片中红框内容添加，不需要则不管

n8n 的工作流响应内容请使用Respond to Webhook节点，并参考下图配置（如果你选择的是流式响应和AI Agent节点，则不需要操作此步骤）：

Response Body中的响应内容键名需要与 LangBot 流水线配置中的输出键名一致。

在完成 n8n 工作流的配置之后，请在其顶部点击Active以启用工作流。

接入 Langflow

Langflow 是一个开源的用于构建和部署基于 AI 的 Agent 和工作流的项目。其支持本地和云端部署，并提供 API 供其他应用接入。

LangBot 目前支持使用 Langflow 作为运行器。

在 Langflow 上创建工作流

请根据 Langflow 文档 部署 Langflow 实例。

以默认模板中的 Simple Agent 为例：

您可根据需求修改工作流：

配置 LangBot

打开 LangBot WebUI 页面，添加一个新的流水线或在已有流水线中切换到 AI 能力配置页面，选择Langflow API作为运行器。

根据提示填入Base URL(根据实际网络情况填写)API KeyFlow ID等信息，API Key 可在 Langflow 的 Settings 中获取：

Flow ID 可点击编辑页右上角的Share->API access并示例代码中获取：

接入 TBox（蚂蚁百宝箱）

TBox（百宝箱）是蚂蚁集团推出的面向 AI 开发者的一站式智能体应用开发平台。在平台上，无论您是否拥有编程基础，都可以通过自然语言，基于各种大模型搭建属于您自己的智能体应用，并将其发布到支付宝小程序、web 服务、浏览器插件等生态渠道。

LangBot 支持接入 TBox 上编排好的智能体，用作流水线 Runner。

在 TBox 上搭建好智能体后，请到开放平台创建 API Key：

并在 TBox 的智能体编排页面找到该应用的 AppID：

接着回到 LangBot 流水线设置中，切到AI 能力配置页面，选择蚂蚁百宝箱平台 API作为运行器：

现在即可使用 TBox 上的智能体了。

接入 Coze API

本文仅说明如何在 Coze 平台获取 Token 与 Bot ID，并将其填写到 LangBot 流水线配置中。

1. 获取 Token 与 Bot ID

1. 登录 Coze 平台，进入你的开发控制台。
   
2. 在"API 管理"中创建并复制令牌。
   

提示：
coze.cn 的授权中有可以长期授权的服务身份及凭证，但是 coze.com 只有个人访问令牌。

3. 从项目开发中选择你自己的智能体，或者新建智能体，拿到一下id就是bot_id。
   

• 智能体发布一定要选上api的选项
  

请妥善保存以上两项信息：

• token：Coze 平台生成的令牌
• bot_id：机器人 ID

2. 在 LangBot 中填写配置

1. 打开 LangBot WebUI，进入一个流水线的配置页面（或新建流水线后进入配置页面）。

2. 在"AI 能力"中选择运行器为Coze API。

3. 在运行器的配置项中，填写：

   • token：粘贴你在 Coze 平台复制的 API Token
   • bot_id：粘贴对应机器人的 Bot ID
   • 请根据您使用的 Coze 站点选择API 基础 URL：coze.cn 请填写https://api.coze.cn；coze.com 请填写https://api.coze.com

4. 点击"保存"完成配置。

完成后，你即可在该流水线中调用 Coze 机器人完成对话处理。

常见问题

• 保存失败或调用报错：请确认 token 与 bot_id 是否正确且未包含多余空格。
• 无法选择Coze API：请确认当前版本是否已支持该运行器；若尚未支持，请升级到包含 Coze 运行器的版本。

更多流水线通用配置说明，请参考修改对话流水线配置。

总结

LangBot 通过流水线机制，为企业提供了灵活可配置的 AI 机器人接入方案。无论是使用内置 Agent，还是接入 Dify、n8n、Langflow、TBox、Coze 等外部 LLMOps 平台，LangBot 都能提供统一的配置界面和消息处理流程。

通过本文的指南，您可以根据实际需求选择合适的平台进行接入，快速构建适合企业场景的 AI 应用。