AgentConnect
连接与自动化

集成概览

Agent 如何接入各个渠道——机器人、集成、共享机器人,以及在任何对话中都可用的命令。

集成把一个 Agent 与一种触达它的方式绑定在一起。支持的类型如下:

平台Agent 响应的内容你需要提供
Slack频道、线程和私信Cloud 上的“添加到 Slack”,或自定义 Slack 应用
Telegram私信和群组消息来自 @BotFather 的机器人令牌
Discord频道、线程和私信机器人令牌;AgentConnect 会生成邀请链接
Lark / 飞书群组 @ 提及和一对一聊天一键应用配置,或 App ID + 密钥
Google Chat空间中的 @ 提及和私信Chat 应用的服务账号密钥,或部署自带的应用
GitHub所监视仓库中的 Issue、PR 和评论AgentConnect 的 GitHub App
GitLab所监视项目中的 Issue、Merge Request 和评论一个 OAuth 连接;每个 Agent 拥有自己的机器人
Gitea所监视仓库中的 Issue、PR、评论和评审每个组织一个机器人用户的令牌
Linear委派给该应用的 Issue,或按名称的提及在 Linear 弹窗中批准工作区
Webhook任何能 POST JSON 的东西无需提供——我们为你生成端点

在 Agent 页面(集成 → 添加集成)或 Agent 列表中添加集成。

添加集成并选择平台

机器人是身份,集成是绑定

对于聊天平台来说,真正存在于你的 Slack 工作区、Telegram 群组、Discord 服务器或 Lark / 飞书租户中的是一个机器人——一个拥有自己令牌的持久身份。集成把这个机器人绑定到一个 Agent。

  • 删除集成会释放机器人而不是销毁它——可以通过使用已有机器人选择器把它复用给另一个 Agent。
  • 机器人在集成 → 消息应用中按组织统一管理:参见机器人。

平台卡片会根据 Agent 所在 Daemon 支持的能力启用。在 AgentConnect Cloud 上,Slack 和 Lark / 飞书提供引导式设置,Telegram 和 Discord 从机器人令牌开始,Google Chat 则从你自己的 Chat 应用的服务账号密钥开始。自托管的运维人员可以在各平台的设置中选择直接连接,或由 Relay(中继)承接的回调;Google Chat 只通过回调投递。

绑定频道

没有频道选择器:把机器人邀请进频道,它就会出现在 AgentConnect 中。随后每个已加入的频道都会显示在 Agent 的集成卡片上,并带有各自的触发条件:

  • @ 提及——默认值;未提及的后续消息会在 Agent 已加入的线程(thread)中继续。
  • 所有消息——对频道里的每条消息都运行该频道的 Agent。
  • 按决策——用一个决策判断每条消息,只有答案符合你的规则时才回复。
  • 关闭——不在该频道中响应,包括提及、已有的线程关联、控制命令或共享机器人回退。

关闭会让机器人留在频道中、保留过去的会话,只是屏蔽入站激活。定时任务或另一个 Agent 的主动交接仍然可以在那里发消息。机器人实际的频道或服务器成员身份请在聊天平台上管理。

Linear 的形态相同,只是名单不同:它的对话是工作区的团队,在你连接的那一刻就会列出;团队行只接受 @ 提及、按决策或关闭——每个 Linear 事件本来就是发给该应用的。

私信

有人给机器人发消息后,私信就会出现,每个 Agent 各自控制自己的私信对话。一对一私信使用开启 / 关闭。群组对话使用与频道相同的触发条件选项。受限 Agent 的对话初始为关闭,直到有权限的编辑者启用它们。

共享机器人

通常是一个机器人对应一个 Agent。共享 Slack 机器人可以通过单一身份服务多个 Agent,而已连接的 Linear 工作区始终如此——你在它上面启用的每个 Agent 都通过部署中唯一的 Linear 应用工作。在集成 → 消息应用中展开机器人,为每个频道选择默认分发 Agent:Slack 里只有一个“@Assistant”,背后按频道由不同的专家 Agent 负责。或按决策选择则改为按对话、用一个决策挑选专家 Agent。

频道触发条件作用于共享机器人。将其切换为关闭会停止该频道中经由该机器人的路由。

跨平台交接

把同一个 Agent 连接到多个聊天平台后,它就可以从一个对话向另一个对话发起主动交接。只在两个你信任并已批准互通信息的消息工作区之间使用此功能。目标端会开启自己的关联会话,而不是合并两个平台的会话记录。参见在受信任的工作区之间交接对话。

受限 Agent

当 Agent 的团队可见范围为指定成员时,它的聊天对话同样受限。新发现的频道和私信初始为关闭,直到有权限的编辑者在集成卡片上逐一启用。每个 Agent 之后也可以选择关闭作为显式静音。参见团队可见范围。

对话内命令

使用这些命令可以直接控制当前对话,而不必让模型来做。Slack 使用 !,因为 Slack 把 / 命令保留给了应用。

操作其他平台Slack
停止并静音/stop!stop
取消当前轮次/cancel!cancel
恢复/resume!resume
排队一条消息/queue <message>!queue <message>
查看会话状态/status!status
更改模型、推理强度或权限/models、/effort、/permission相同的命令,改用 !
切换快速模式/fast on、/fast off!fast on、!fast off

停止还会让对话静音,直到有人再次提及 Agent 或使用恢复。取消只中断当前轮次。

运行时设置命令(/models、/effort、/permission、/fast)只有在 Agent 的允许在聊天中更改设置开启时才生效。在 Telegram 和 Discord 上,这些命令会出现在原生命令菜单中,注册的名称是 /models 而不是 /model(手动输入时两者都接受)。

Agent 应该有多“健谈”?

Agent 的输出模式决定哪些内容会送达平台:极简只保留一条实时更新的回复,低会发布回复,中会加上工具和计划,高还会包含推理和工具输出,无则只把运行保留在 Web 会话中。完整的会话记录始终可以在会话中查看。

How is this guide?

本页目录

How is this guide?