Langflow 中的 Webhook 简介(分步指南)

大家好,开发者们!👋我是 Melissa,今天我将带大家深入了解 Langflow 中的 webhook。无论你是经验丰富的程序员还是刚刚入门,本指南都将引导你完成在 Langflow 项目中设置和使用 webhook 的过程。让我们开始吧!🚀
设置 Webhook 组件
首次设置需要 Langflow (开源版 或 桌面版) 和一个终端。首先,让我们将 Webhook 组件添加到你的 Langflow 工作流中。

此组件为你的 LangFlow 实例暴露一个端点。你可以将其视为通往你的工作流的入口。
进入 Webhook 组件的“控制”面板并获取 cURL 命令。
为了测试此设置,我们将发送一个指向 Langflow webhook 端点和流程 ID 的 POST 请求。将 cURL 命令复制并粘贴到你的终端中。
curl -X POST \
"http://127.0.0.1:7860/api/v1/webhook/bc1e06f6-c7de-4151-be69-955e6710fde1" \
-H 'Content-Type: application/json'\
-d '{"any": "data"}'
一旦你在终端中看到成功消息,就表示你的数据已经成功传输到 Langflow 工作流中。
{"message":"Task started in the background","status":"in progress"}
我们可以进入 Webhook 组件,检查其输出,从而确认数据已成功发送。
简单示例
现在,让我们向 POST 请求添加更多数据:一个 name
、email
、subject
和 body
。
curl -X POST \
"http://127.0.0.1:7860/api/v1/webhook/bc1e06f6-c7de-4151-be69-955e6710fde1" \
-H 'Content-Type: application/json'\
-d '{"name": "alex", "email": "alex@email.com", "subject": "This is a test", "body": "Hi Developers!"}'
在你的终端中发送此命令,并确保看到成功消息。检查 Langflow 中的 Webhook 组件,你会注意到数据以 JSON 格式传输。
太棒了!现在如何在我们的工作流中使用这些数据呢?请使用 Parser 组件!

Parser 组件使用“模板”字段帮助从传入数据中提取特定字段。使用字段名称(如 name
、email
、subject
和 body
)定义一个模板,如下所示
Name: {name}
Email: {email}
Subject: {subject}
Body: {body}
任何位于花括号中的内容都将被识别为 Dataframe 对象的列值或 Data 对象的键值。
将 Webhook 组件的输出连接到 Parser 组件的 Data 或 DataFrame 输入。再次发送 cURL 命令,检查输出,瞧——你已经获取了你的数据!🔍
🌐 从你的应用程序调用 Webhook
现在你已经使用 cURL 设置并测试了你的 webhook,接下来让我们讨论如何从你的应用程序或外部服务调用它。通过触发特定的流程,你的应用程序可以动态地与 Langflow 进行交互。
从你的应用程序
- 定义 Webhook URL:Langflow 提供的 webhook URL 作为你的应用程序可以调用的端点。这个 URL 对于你的流程是唯一的,并且是触发工作流所必需的。
- 集成 Webhook 调用:在你的应用程序内部,使用 HTTP 客户端向 webhook URL 发送 POST 请求。这可以是你的后端逻辑的一部分,也可以是一个无服务器函数。
- 在你的代码中实现
import requests
# Example of sending data to the webhook
webhook_url = "http://127.0.0.1:7860/api/v1/webhook/bc1e06f6-c7de-4151-be69-955e6710fde1"
data = {
"name": "John Doe",
"email": "john.doe@example.com",
"subject": "Greetings",
"body": "Hello, this is a test message!"
}
response = requests.post(webhook_url, json=data)
if response.status_code == 200:
print("Webhook call was successful!")
else:
print("Failed to call the webhook.")
- 监控和调整:确保你的应用程序处理 webhook 调用的响应。你可能需要记录成功或失败,重试失败的尝试,或优雅地处理错误。
从外部应用程序/网站
- 识别外部服务:选择一个支持 webhook 集成的外部服务。这可以是任何服务,从 CRM、通知服务到应用程序集成平台,例如 Composio。
- 生成你的 Webhook URL:在 Langflow 中,你的流程附带一个唯一的 webhook URL。但是,如果你运行的是开源版或桌面版,你无法从外部访问此 URL(“localhost”无法从互联网访问)。为此,你需要使用诸如 Ngrok 或 Render 的服务来部署你的 Langflow 实例。
- 在外部服务中配置 Webhook
- 导航至 Webhook/触发器设置:在外部服务的仪表板中访问 webhook 的设置。
- 输入你的 Webhook URL:将 Langflow webhook URL 粘贴到相应的字段中。这会告诉服务将数据发送到何处。
- 测试 Webhook:从外部服务发送测试事件,以验证 webhook 配置是否正确。检查 Langflow 查看是否已接收到数据。
- 定义触发事件:指定应触发 webhook 的事件。例如,“收到新电子邮件”或“订单完成”。以下是 Composio 的一个示例

再次检查 Langflow 中的 Webhook 组件。来自外部服务的负载将更像这样。比我们最初的示例包含更多信息和元数据,但这是可用于你的 Langflow 工作流其余部分的“真实世界”中的实际数据。
结论和下一步
以上就是对 Langflow 中 webhook 的快速入门!我们从一个简单的示例开始,并深入探讨了实际应用。现在,你已准备好在你的 Langflow 项目中利用 webhook 的强大功能。
如果你有任何问题或想深入了解,请加入 Discord 上的讨论。编程愉快!🚀
请随意探索和实验这些组件。可能性是无限的!🌐🔧
参考资料