通过 LangSmith Fleet,您可以安全地将您的智能体连接到 Slack 工作区,让您的智能体能够与 Slack 中的用户进行通信。
集成后,您的智能体将能够:
- - 直接从您的 Slack 机器人接收消息,并使用消息内容启动新的运行。
- - 处理消息后,与您的工作区进行通信。
- - 通过读取对话消息和对话历史记录从 Slack 获取相关上下文。
LangSmith Fleet 提供两种将智能体连接到 Slack 的方式: **自定义 Slack 机器人** (推荐)和 **默认 Slack 机器人**.
自定义机器人与默认机器人
| 自定义 Slack 机器人 | 默认 Slack 机器人 | |
|---|---|---|
| **Slack 应用** | 您自己的应用,通过 LangSmith 创建 | LangSmith 的 Slack 账户 |
| **触发方式** | 直接使用 @Bot_Name | 频道中的每条消息 |
| **私信** | ✅ | ❌ |
| **适用场景** | 直接来回通信。 | 每次在特定频道发送消息时启动运行 |
设置自定义 Slack 机器人
自定义 Slack 机器人为您提供智能体与 Slack 之间的完全双向通信。
前提条件
- - Fleet 中已有的智能体(请参阅 快速入门 创建一个)
- - 对 Slack 工作区的管理员访问权限或安装应用的权限
创建 Slack 应用
Create a new Slack app
- 导航到 Fleet 中的 **集成** 页面并转到 **应用** section.
- 点击 **添加 Slack 应用**.
- 输入机器人的名称。
- 点击 **创建 Slack 应用**。您将被重定向到 Slack API 网站,弹出窗口要求您选择工作区。
Select your workspace
1. 选择要安装机器人的工作区。 1. 点击 **下一步**. 1. 点击 **创建机器人**.
Enter your app credentials
创建机器人后,您将收到应用凭证。请在 Fleet 中输入以下凭证: - 应用 ID - 客户端 ID - 客户端密钥 - 签名密钥
Connect OAuth
1. 点击 **连接 OAuth**. 1. 点击 **授权** 以授予 Fleet 访问您应用的权限。
Finish setup
将您的 Slack 机器人链接到现有代理,或点击 **完成** 稍后链接。
将 Slack 机器人链接到代理
您可以从集成页面或代理编辑器将 Slack 机器人链接到代理。每个代理只能有一个 Slack 应用,每个 Slack 应用也只能链接到一个代理。
From the Integrations page
- 导航到 **Slack 应用** 部分 **集成** 页面。
- 选择要链接的机器人。
- 从下拉菜单中选择要链接的代理。
- 验证 **\** 显示在机器人名称旁边。
From the agent editor
- 从以下位置选择您的代理 **我的代理** 在左侧导航中。
- 点击 **编辑代理**.
- 滚动到 **频道** section.
- 点击 **Slack**.
- 从下拉菜单中选择要链接的 Slack 应用。
邀请机器人加入您的频道
- 在 Slack 中,转到要使用机器人的频道。
- 输入
/invite @YourSlackBotName以邀请机器人。 - 发送一条提及机器人的消息以验证其响应。
配置代理行为(可选)
您的代理需要知道如何处理传入的 Slack 消息。通过直接在代理聊天中提示来更新其指令:
Update your instructions to handle the Slack Trigger and Slack Tools
for bidirectional communication
根据您的用例调整指令——例如,您可能希望代理仅回复特定类型的问题,或在回复前从特定来源获取信息。
设置默认 Slack 机器人
默认 Slack 机器人使用 LangSmith 的 Slack 账户,并在已连接频道中发布的每条消息时触发您的代理。它无法接收私信。
Authenticate with Slack and get the channel ID
1. 在 Fleet > 集成页面,使用 Slack 进行身份验证。 1. 在 Slack 中,将默认应用(@LangSmith Fleet)邀请到频道。 1. 复制频道 ID。
Open the agent editor
In Fleet,选择您的代理并点击 **编辑代理** icon.
Add a Slack channel
1. 在 **频道** 部分,点击 **Slack**. 1. 导航到 **LangSmith Bot** 并点击 **添加频道**. 1. 粘贴频道 ID 和频道名称。
Start a run
在频道中发送任何消息以开始运行。
添加 Slack 工具
Slack 工具允许您的代理发送消息、在主题帖中回复以及读取频道历史记录。无论代理是如何触发的(通过 Slack、Fleet UI、计划任务还是 webhook),这些工具都可以正常工作。
例如,您可以在 Fleet 聊天界面中启动一个长时间运行的 research 任务,并指示代理在完成时向您发送 Slack 消息。
1. 在代理编辑器中,滚动到 **工具** section. 1. 点击 **+ 添加**. 1. 搜索 "Slack" 并添加您需要的工具(如果尚未添加): - **slack_send_channel_message**—向频道发布消息 - **slack_reply_to_message**—在主题帖中回复 - **slack_write_private_message**—发送私信 - **slack_read_channel_history**—读取最近消息 - **slack_read_thread_messages**—读取主题帖回复 1. 如果出现提示,点击 **连接** 以授权 Slack 工具。 1. 点击 **保存更改**.
故障排除
代理无响应
如果您的代理没有响应,可以尝试以下方法:
- - 检查 Fleet 中的主题帖是否有需要人工输入的审批。
- - 验证机器人已被邀请加入频道。
- - 检查 **动态** 标签页是否有错误。
- - 确保频道未在 **频道** section.
- - 尝试重新向 Slack 进行身份验证,以确保 Fleet 存储了您最新的 Slack 用户 ID。
不允许标记机器人
如果您收到一条私信,告知您不允许标记机器人,则说明您的 Slack ID 未获得该代理的授权。代理所有者需要与您共享该代理——可以与整个工作区共享运行权限,也可以单独与您共享。
后续步骤
Add more tools
将其他服务连接到您的代理
Add more channels
设置电子邮件、日程安排或 Webhook 渠道
Use templates
从预置代理模板开始