Slack

把 AI Agent 接入 Slack，让它们在频道线程和私信中协助团队排查问题、回答疑问和完成工作。

在 AgentConnect Cloud 上，推荐的路径是内置的添加到 Slack 应用。你只需批准工作区安装；AgentConnect 会完成 OAuth 流程并接入，不会要求你提供应用 manifest、令牌、签名密钥或回调 URL。

在 Cloud 上把 AgentConnect 添加到 Slack复制锚点链接

你需要 AgentConnect 账户，以及 Slack 工作区的应用安装权限，或管理员批准。

1. 打开 AgentConnect 控制台并登录。如果还没有组织，创建一个，并在设置时选择 Cloud。AgentConnect 会创建已配置 Runtime 和模型的内置 agentconnect Agent；这条路径不需要你安装 Daemon 或提供模型 API Key。
2. 打开开始使用卡片并选择添加到 Slack。也可以打开内置 Agent，选择集成 → 添加集成 → Slack。
3. 点击添加到 Slack，选择 Slack 工作区，核对并批准所请求的权限。
4. 返回控制台。控制台会等待 Slack 完成，并在机器人就绪后自动关闭设置对话框。确认内置 Agent 的集成卡片上出现 Slack，然后按下方说明发送第一条消息。

这次安装最初只服务内置 Agent。本页后面的自定义应用和自托管说明是可选的其他路径，不是这次 Cloud 安装的后续步骤。

使用复制锚点链接

通过 Slack 频道的应用管理入口或以下命令，将 AgentConnect 邀请进频道。如果机器人被重命名，请使用它的实际显示名称：

/invite @AgentConnect

提及它并给一个简单任务，例如：@AgentConnect 请把这些发布说明总结为两点：增加 CSV 导出；修复登录错误；改进搜索。 Agent 会在线程中回复。在同一线程中回复即可继续，不必再次提及。也可以在 Slack 中打开应用并发送私信。

每个被发现的频道都会出现在 Agent 的集成卡片上。为入站激活选择 @ 提及（默认）、所有消息或关闭。关闭不会卸载应用，也不会阻止定时任务和受托的出站发消息。关于从 Slack 停止、取消、排队以及更改会话设置，参见对话内命令。

当工具调用需要批准时，Agent 会在线程中发布一张审批卡片。谁能回答它、谁能在 Slack 中修改设置，由 Agent 的聊天中可以做什么决定；开启遵循 Slack 访问权限后，只有 Agent 的编辑者可以。

Slack 套餐与 AI 输出复制锚点链接

Slack 应用容器中的 AI Agent 体验需要付费 Slack 套餐。免费套餐仍可通过频道提及和私信与 Agent 对话；其他 Slack 功能受工作区套餐和权限限制。

AgentConnect 使用生成式 AI，回答和生成的文件可能不准确或不完整。在依赖输出或执行建议的操作之前，请先核查，尤其是涉及法律、医疗、财务等重要决策时。

数据与支持复制锚点链接

你配置的 Runtime 和模型提供商会处理任务所需的 Slack 消息、相关历史和共享文件。会话记录和工作区文件可能保留在你选择的执行环境中，记忆按其配置存储。AgentConnect 会在控制平面加密保存集成凭据。数据处理、保留和删除详情请参阅隐私政策。

如需安装帮助或咨询数据问题，请发邮件至 contact@agentconnect.md，无需额外注册账户。AgentConnect 托管服务适用服务条款。

断开集成或卸载应用复制锚点链接

从 Agent 上移除集成，可以停止该 Agent 使用它。如果机器人是共享的，其他 Agent 仍可能使用同一个安装。要撤销应用对 Slack 工作区的访问，请通过 Slack 的应用管理设置移除应用；这可能需要管理员批准。此前保存的会话、文件和记忆与应用安装分别管理，不会因卸载应用而自动清除。

Agent 在 Slack 中能做什么复制锚点链接

在 Slack 会话中，Agent 能做的不只是回复。它还会把 Slack 自身的功能作为工具获得，并在任务需要时主动使用它们：

• 了解现场——读取频道最近的消息、线程中的回复，以及搜索工作区的公开消息。
• 表态——给消息添加表情回应，或读取消息上已有的回应。
• 留下痕迹——置顶和取消置顶频道书签，创建和编辑画布，以及读取和更新 Slack 列表。
• 走得更远——打开私信、发起对话、分享文件，以及安排稍后发送的消息。

这些工具只会注入到 Slack 上的会话。同一个 Agent 在其他平台上工作时不会带着它们；Discord 和 Lark / 飞书提供频道历史，Telegram 只能读取附件。Agent 通过这种方式做的一切都以机器人的身份完成，并像其他工具调用一样出现在会话记录中。

在它正在回答的对话之外，Agent 是替提问的人使用这些工具：只读取这个人能看到的内容，只发到这个人自己能发消息的地方。Slack Connect 频道只以草稿形式接收来自其他对话的消息，由你所在组织的一位成员批准。参见在其他对话中读取和发消息。

在 Code channel 中工作复制锚点链接

**候选版本：**本例使用 AgentConnect v2.9.0-rc.63 和 Codex 完成，并在 v2.9.0-rc.65 上复查、截图。Code channel 需要 Slack 应用和工作区支持，目前并非所有 Cloud 安装都可用。如果 Agent 提示无法创建，可以继续在原来的线程中工作。

在 Cloud 上，先按上方步骤连接 Slack，再在 Workspace 中给 Agent 配置可写的代码仓库。第一次尝试建议使用不含业务数据的小型示例仓库；这条流程不需要在本地安装 Daemon。

从编码需求开始复制锚点链接

直接描述你需要的结果。多步骤编码需求可以开启独立的 Code channel；简单问题仍留在当前对话中。例如：

做一个 CSV 转 JSON 的小工具，让我在 Slack 里试用，完成后开个 PR。

打开 Agent 返回的频道链接，然后用自然语言继续提出要求，例如：**保留字段中的空格，但忽略记录之间的空行。**整个频道共用一个编码会话。在线程中追问会继续这个会话，并在线程中收到回复；Code 视图和 artifacts 仍属于整个频道。

检查改动并试用结果复制锚点链接

打开 Code 查看 diff。对于符合条件的隔离仓库，AgentConnect 会在工作过程中更新视图，把当前工作区与任务开始时的状态比较。提交代码后，这份比较仍然保留。

像上面的需求一样，说明你希望得到可试用的页面，然后打开 Agent 添加到频道的 HTML 预览。本例选择 Headers 会生成对象，选择 Data 会生成数组。可以尝试这份合成数据：

name,city,note
Ari,Oslo,"Likes tea, coffee"
Bo,Kyoto,"Said ""hello""
and waved"

再输入两行 name,city 和 Ari,Oslo,extra：页面会提示列数不一致，清空输出，并禁用复制按钮。示例 PR 包含源代码和 6 项解析器测试。

固定栏把模型与 effort 放在一起，并显示 Runtime 报告的 context 用量，例如 42k/200k。仓库、分支和 PR 项可帮助你返回代码。PR 状态反映 Agent 最近一次检查的结果，不是自动订阅 CI 变化；需要最新结果时，可以说：检查一下 PR 并更新状态。

给 Agent 一个自定义的 Slack 身份复制锚点链接

在内置 Agent 上，当它需要专属的 Slack 应用时，选择改用自定义 bot 身份。其他 Agent 会直接进入自定义身份流程。当自托管部署没有发布内置应用时，这也是常规路径。

配置令牌安装复制锚点链接

这是推荐的自定义应用路径。如果你还没有保存 Slack 配置令牌，AgentConnect 会链接到 Slack 的配置令牌页面。粘贴访问令牌（xoxe.xoxp-…）及其刷新令牌（xoxe-…），这样 AgentConnect 才能轮换它；只保存访问令牌的话，大约 12 小时后就会过期。Slack 把这对令牌限定在一个用户和一个工作区。AgentConnect 会为当前登录用户保存它，该用户可以在个人资料 → Slack 配置令牌中替换或清除。

为应用命名，点击创建并安装，然后在 Slack 中批准。使用 HTTP (Events API) 投递时，AgentConnect 会自动获取机器人令牌和签名密钥，无需复制粘贴凭证即可完成。使用 Socket 模式时，Slack 仍要求你生成一个带 connections:write 的 App-Level 令牌，并粘贴生成的 xapp-… 令牌。

Manifest 安装复制锚点链接

当你无法创建 Slack 配置令牌时，使用这条手动备用路径：

1. 选择复制 manifest 并打开 Slack，然后用复制的 manifest 创建并安装应用。
2. 对于 HTTP，粘贴 Bot User OAuth 令牌（xoxb-…）和签名密钥。
3. 对于 Socket 模式，粘贴 Bot User OAuth 令牌和一个带 connections:write 的 App-Level 令牌（xapp-…）。

如果 Slack 提示权限范围有变化，请先重新安装一次应用，再复制 Bot User OAuth 令牌。

保持应用权限为最新复制锚点链接

Slack 在安装应用时授予权限，因此新增功能的版本可能让已有安装缺少某个权限范围。AgentConnect 会指出缺少的权限范围，而不是静默失败：打开集成 → 消息应用 → Slack，在该机器人的行上使用刷新 Slack 应用。

• 当 AgentConnect 能替你更新应用时，它会同步 manifest，并要求你重新安装工作区，以便 Slack 授予新增的权限范围。
• 当它做不到时——manifest 安装的应用，或不由 AgentConnect 管理的应用——它会把你指向 Slack 中该应用的 OAuth & Permissions 页面，让你添加列出的权限范围，然后重新安装。

内置安装也从同一行修复：AgentConnect 会替你发起重新安装，并等待 Slack 确认。

投递模式与自托管复制锚点链接

• HTTP (Events API) 是 Cloud 上的默认值。入站回调经由 AgentConnect Relay（中继）进入，并直接送达所属的 Daemon。可共享的机器人必须使用 HTTP。
• Socket 模式是由 Daemon 发起的出站连接。它不需要 Relay 或公网回调 URL，且限制为每个机器人一个 Agent。

自托管部署只有在运维人员配置了部署级 Slack 应用之后才会显示内置的添加到 Slack 路径。否则，请使用自定义应用。HTTP 只有在部署拥有公网可达且已连接的 Relay 时才可用；没有的话，使用 Socket 模式。

让一个 Slack 应用服务多个 Agent复制锚点链接

AgentConnect 一般建议每个 Agent 使用一个机器人身份。如果你的团队确实希望同一个 Slack 身份在不同频道中表现不同，可以把机器人设为可共享，并把每个频道分发给不同的 Agent：

1. 打开集成 → 消息应用 → Slack，为该机器人开启可共享。
2. 在每个额外的 Agent 上，选择集成 → 添加集成 → Slack → 使用已有机器人并选中它。
3. 回到集成 → 消息应用 → Slack，展开该机器人，为每个频道选择默认分发 Agent。

完整模式请参见一个 Slack 应用按频道对接不同 Agent。