用 Webhook 实时通知：LangSmith 部署中如何让 Slack 报告智能代理运行结果

一句话总结：一段代码教你几分钟内实现智能代理完成时，通过 Slack 自动收到通知。

---

内容概览

• 主题：LangSmith，Webhook，智能代理运行，Slack 通知，FastAPI
• 适合人群：AI 开发者、LangChain 用户、自动化爱好者、团队协作管理员

---

核心观点

1. Webhook 是连接智能代理和外部通知的桥梁
   代理运行结束时，LangSmith 可以发送 POST 请求到指定的 Webhook 地址，触发后续动作。

2. 用 FastAPI 自建接口，轻松处理回调通知
   视频中用 FastAPI 创建了一个专门接收 LangSmith 运行数据的路由，并处理消息内容推送给 Slack。

3. 配置 Slack Webhook，实现自动提醒不再靠盲等
   只要把 Slack 提供的 Webhook URL 填进环境变量，运行结束时即可收到带有内容摘要的即时消息。

---

深度解读

Webhook：智能代理不是孤单的“代码跑者”

想象你启动了一个费时的智能代理任务——比如深度调研、复杂问答或者多轮对话模型调用。你想知道它什么时候结束，但又不想盯着屏幕浪费时间。

这时候，Webhook 解决了你的焦虑。它其实就是一根“电话线”：当代理跑完，它主动给你“打电话”——把运行结果和关键信息发过去。

LangSmith 的部署机制里，用户发起任务，后台代理开始执行。任务结束，LangSmith 就会把这次运行的输入、状态等数据打包成 POST 请求，发到你预设的接口。

这不只是简单的通知，更是把这次对话里的所有数据都传过去，你能基于这段数据做任何二次开发。

FastAPI 自建处理路由，接收运行结果

视频演示的核心，是写一个叫 webhook.py 的 FastAPI 小应用。

它实现了以下几步：

• 从环境变量里读取 Slack 的 Webhook URL，避免硬编码泄露风险。
• 定义输入数据格式，特别是“values”字段的含义：其中保存了这次运行的检查点信息，包含了对话消息。
• 通过获取最后一条消息，提取出智能代理的最终回答。
• 通过 POST 请求把这条消息“转发”给 Slack 里预先设置好的频道。

代码里，处理函数先做了必要的类型转换和安全检查，再把最终消息内容包装成 Slack 能接受的格式，发出请求。异常会抛出方便调试。

这一设计意味着，你不仅知道任务结束，还能一览 AI 给出的总结或答案。

配置细节：从环境变量到 LangGraph 注册

步骤并不繁琐。大致是：

1. 把几个重要的 API Key 填进 .env 文件 —— 包括模型服务、搜索工具的访问密钥，还有 LangSmith 自身的跟踪密钥。
2. Slack Webhook URL 也是必要参数，可以从 api.slack.com/apps 里自己创建并获取。
3. 在 LangSmith 项目里新增一个 webhook.py，写好上述 FastAPI 接口。
4. 在 langraph.json 里注册这个接口，告诉系统“这是我新写的 HTTP 路由”。
5. 开启开发服务器，确认接口生效。

这样，后台就有一条从 LangSmith 到你自定义接口的运行数据传输链。

AI 运行和 Slack 推送协同演示

演示里用到的 Agent 来自 LangChain 的 “deep research” 示例库，实战感拉满。

在 API 文档页面里：

• 先手动创建对话线程，获取线程 ID。
• 用线程 ID 触发后台异步运行，给助手下达调研任务“给我点关于 LangGraph 的研究”。
• 关键是传入这个新写的 Slack webhook 路由，告诉 LangSmith 运行结束后把数据“回调”到这里。

异步任务开始后，你可以离开屏幕。几秒钟后 Slack 频道自动收到机器人发的消息，是由 AI 这次研究产生的文字报告摘要。

回到 LangSmith 平台的跟踪页面，还能看到完整的详细报告文件 finalreport.md。

这整个流程打通后，开发者能做到：

• 不用盯着耗时任务
• 直接在 Slack 里获取 AI 工作成果
• 结合自身业务需求，定制自动化反馈提醒

---

值得记住的话

"Once the run is finished, the runtime will send the run input and a couple other details as a post request to some endpoint that we provide."

"We expect the run input, then also get some other data — the most important being a checkpoint that lets us access the last AI message."

"Sending a post request to the Slack webhook URL with the last message lets you get notified the moment your task is done."

---

标签

AI 工具 LangSmith 快速开发 自动化通知