以编程方式使用文档

通过 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

  1. 导航到 Fleet 中的 **集成** 页面并转到 **应用** section.
  2. 点击 **添加 Slack 应用**.
  3. 输入机器人的名称。
  4. 点击 **创建 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

  1. 导航到 **Slack 应用** 部分 **集成** 页面。
  2. 选择要链接的机器人。
  3. 从下拉菜单中选择要链接的代理。
  4. 验证 **\** 显示在机器人名称旁边。

From the agent editor

  1. 从以下位置选择您的代理 **我的代理** 在左侧导航中。
  2. 点击 **编辑代理**.
  3. 滚动到 **频道** section.

  1. 点击 **Slack**.
  2. 从下拉菜单中选择要链接的 Slack 应用。

邀请机器人加入您的频道

  1. 在 Slack 中,转到要使用机器人的频道。
  2. 输入 /invite @YourSlackBotName 以邀请机器人。
  3. 发送一条提及机器人的消息以验证其响应。

配置代理行为(可选)

您的代理需要知道如何处理传入的 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

从预置代理模板开始