Flint AI Switch：多智能体协作工具

Switch 是干什么的？把同事和 AI Agent 拉进同一个工作房间

Flint AI Switch 是一个可自托管的多智能体协作工具。通俗地说，它给团队搭建一个共同工作的房间：同事、你使用的 Claude Code 或 Codex，以及其他接入的 Agent，可以围绕同一件事交流、读取共享资料并交接工作。团队仍然使用熟悉的聊天应用，Switch 负责把聊天渠道与 Agent 连接起来。

它适合已经使用 AI Agent、却经常需要复制聊天记录或替不同 Agent 传话的团队。Switch 本身不提供大模型，也不附带一个替你完成所有工作的通用 Agent；具体能力来自接入的 Agent、它的工具和运行环境。

让项目背景留在房间里，减少重复解释

Switch 的核心单位是 Room。房间把讨论、说明、文档和引用资料放在共同的工作上下文中。新增 Agent 时，它可以获得房间中的指引，而不用由某位同事重新整理一遍背景。

例如，团队可以围绕一次故障建立房间，说明问题范围、已有发现、输出位置和不应执行的操作。调查过程及后续结果继续留在同一上下文里。这里的价值是让接手的人和 Agent 能沿着已有工作继续推进；它并不保证模型一定理解正确，重要结论仍需核对。

房间说明与参考材料也有区别：说明告诉 Agent 怎样工作，资料提供需要使用的内容。把目标、交付格式和边界写清楚，比单纯堆积文件更有帮助。

连接现有聊天工具与 Agent，分清两类接入

官方文档列出的聊天渠道包括 Slack、Microsoft Teams、Discord、Telegram 和 Mattermost。团队成员通过相应渠道参与；已经受邀进入房间的人，不必为了参与讨论再安装一套 Switch 管理工具。

在 Agent 一侧，Switch Console 的配置文档明确支持 Claude Code、Codex 和 OpenCode。需要同时配置 Agent Provider 与 Switch Connector：电脑上已经能运行某个 Agent，并不代表它已经能够进入 Switch 房间。

官网还介绍了 LangChain、ADK、OpenAI、Bedrock 和自定义 Agent 的接入方向。自定义实现需遵循 Switch Agent Protocol，不能把“协议可扩展”理解为所有框架都能在 Console 中一键安装。具体接入方式应以对应文档为准。

从安装到第一次协作：一条可执行的入门路径

1. 下载适合设备的 Switch Console。先决定是自己试用，还是连接团队已有服务器。
2. 添加服务器。本机试用需要先安装并启动 Docker；Console 可启动本地服务。团队协作则选择已配置的远程主机，或填入现有服务器分别提供的 Gateway URL 和 API URL，不要自行推测地址。
3. 准备 Node.js 20 或以上版本，在 Settings → Agent providers 中安装或检查 Provider，再安装它的 Switch Connector。详细步骤见官方 Provider 配置说明。
4. 在 Your Agents 中注册 Agent，填写名称、描述、运行位置、工作目录和 Provider。工作目录应只包含这项任务真正需要访问的资料。
5. 在 Your Rooms → Create room 中选择聊天应用，填写房间名称、用途和 Instructions，并加入已注册的 Agent。创建后检查房间是否出现在 Your Rooms，以及对应聊天渠道是否可用。可对照创建房间指南。
6. 在聊天渠道里 @Agent，让它回答工作目录中某个具体文件的问题，再追问一个依赖上一条回答的问题。确认答案包含实际文件信息，并且后续对话保留上下文。团队成员测试前，还需正确配置谁可以向该 Agent 发出指令。

官方的首次协作验证流程还列出了账号未关联、无权发出指令和 Agent 没有运行会话等情况的排查方法。

用角色和任务交接组织工作

角色让团队按工作职能找到当前执行者，例如向负责审阅的角色请求检查，而不必记住这次是哪一个 Agent。角色带有工作说明，但不会扩大它访问系统或文件的权限。当前文档还指出，同一参与者一次只能持有一个角色，这个限制跨房间生效。

任务交接比普通聊天问题多了一层状态：任务可以被接受、执行并最终提交结果。不过，聊天渠道不会显示每一次状态变化；接受和取消不会发消息，普通用户也没有列出全部任务的命令。需要了解进度时，应询问参与交接的 Agent。

因此，交付结果最好写清“做了什么、结果在哪里、还有什么需要决定”。仅回复“完成了”，很难让没有参与前文讨论的同事判断下一步。

自托管与共享上下文的实际边界

本地 Docker 模式适合个人验证：服务绑定本机，同事不能把它直接当作共享服务器连接；重启电脑后，服务也不会自行恢复。要长期供团队使用，需要另行配置共享部署。

截至 2026 年 9 月 10 日，官方将 Windows 和 Linux 的 Console 桌面版本标为 early access；这不等于 Linux 服务器部署也处于同样阶段。

数据方面，房间成员资格决定 Agent 能读到哪些共享上下文。限制“谁可以 @Agent”并不会缩小它能读取的房间内容。Switch 也不会检查每次工具调用是否安全，Agent 的实际权限仍由运行环境、凭据和 Provider 决定。部署前可阅读官方责任边界说明。不要把自托管写成所有模型调用都离线，或所有数据都不会进入第三方服务。

费用与许可证：不要把可下载理解为全部免费

核实日期为 2026 年 9 月 10 日。所检查的官网没有公开统一的 Switch 订阅套餐、附送模型额度或适用于所有地区的总价。Agent Provider、模型账户和部署资源由用户配置，相关费用需按实际选择核对。

官方 LICENSE采用 Apache 2.0 加修订版 Commons Clause，限制销售软件或其衍生物，定义还涉及符合条件的收费托管及相关服务。因此，不宜把它介绍为“无限制商用的 Apache 2.0 项目”。官网提到的部分防护和成本报告能力属于后续规划，也不应算作当前已交付功能。

常见问题

Switch 这个多智能体协作平台适合谁？

适合已经使用 Agent，希望团队共享任务背景、在聊天渠道里协作并交接结果的人。若只想打开网页直接和一个现成模型聊天，需要先考虑 Provider、服务器和渠道配置是否值得投入。

已有框架开发的 Agent 能接入吗？

可以按官方协议与连接器文档评估接入。Console 明确列出 Claude Code、Codex 和 OpenCode；自定义 Agent 走协议接入路径，不代表任意框架都有相同的开箱即用体验。

Switch 在 GitHub 上的代码可以随意商用吗？

不能仅凭源码公开就这样判断。其许可证带有修订版 Commons Clause，涉及再销售或收费托管时，应核对完整条件。

官方资源与开发者入口

• Switch 官方文档：查看部署、连接器和房间使用说明。
• 官方 GitHub 仓库：获取源码、发布版本及问题反馈入口。