Agent Switch 소개
Agent Switch는 팀이 이미 쓰는 Slack, Microsoft Teams, Discord, Telegram, Mattermost 안에서 사람과 AI 에이전트가 함께 일할 수 있도록 만드는 자체 호스팅(self-hosted) 협업 인프라 프로젝트입니다. 새 메신저로 옮기는 대신, 기존 채널에 에이전트와 작업 맥락을 연결하는 방식을 택합니다. 그래서 팀의 대화 흐름은 유지하면서 에이전트를 채널 구성원으로 참여시킬 수 있습니다.
Agent Switch는 에이전트나 모델을 제공하지 않습니다. 대신 채널이 따를 지시문, 역할, 권한, 연결된 지식과 작업을 운영할 수 있는 계층을 제공합니다. README에는 Claude Code, OpenAI Codex, OpenCode처럼 이미 팀이 사용하는 에이전트를 연결하는 것이 이 프로젝트의 역할이라고 적혀 있습니다.
Agent Switch는 채널을 단순한 대화방이 아니라 작업 단위로 다룹니다. 예를 들어 README는 기능 개발, 버그 보고, 지원 문의처럼 서로 다른 맥락을 별도 채널에 두고, 필요한 사람과 에이전트가 그 안에서 작업하도록 구성하는 예를 듭니다. 대화와 작업 이력이 같은 채널에 남으므로, 새로 참여한 사람이 앞선 내용을 다시 옮기거나 설명하는 부담을 줄이는 데 목적이 있습니다.
Agent Switch가 기존 메신저를 바꾸지 않는 이유
Agent Switch의 핵심은 기존 협업 도구를 교체하지 않는다는 점입니다. README는 Slack, Teams, Discord, Telegram, Mattermost가 계속 대화가 이뤄지는 곳으로 남고, Agent Switch가 그 안으로 에이전트와 워크플로를 가져온다고 설명합니다. 또한 특정 에이전트 제공자나 모델에 묶이지 않도록 설계했으며, 기존에 실행 중인 에이전트를 연결하는 구조를 제시합니다. Agent Switch와 기존 도구의 역할은 다음과 같습니다:
| 구분 | 기존 도구와 Agent Switch의 역할 |
|---|---|
| 대화 채널 | 기존 메신저가 사람의 대화를 계속 처리합니다. |
| 에이전트 | Agent Switch는 에이전트와 모델을 직접 제공하지 않고, 연결된 에이전트가 채널에서 메시지를 주고받게 합니다. |
| 운영 정보 | 역할, 지시문, 권한, 연결된 지식과 작업은 Agent Switch의 관리 계층에서 다룹니다. |
이 구분은 이미 특정 메신저와 에이전트 도구를 쓰는 팀에서 특히 중요합니다. 대화 도구와 에이전트를 한 번에 교체하는 대신, 기존 채널을 유지한 채 역할과 맥락을 운영하려는 경우에 맞습니다.
Agent Switch의 구성과 메시지 흐름
Agent Switch Core의 중심에는 Matrix 홈서버인 Tuwunel이 있습니다. 사람은 협업 메신저에서, 에이전트는 Agent Bridge를 통해 Matrix의 방(room)에 참여합니다. Collaboration Bridge는 Slack의 Socket Mode, Teams의 HTTP 리스너, Discord의 게이트웨이 웹소켓, Telegram의 long polling, Mattermost의 웹소켓처럼 플랫폼별 전송 방식을 연결하고, 채널을 방에 대응시킵니다.
Agent Bridge는 Switch Agent Protocol을 사용합니다. README 기준으로 에이전트는 HTTP로 메시지를 보내고, 서버가 밀어 보내는 이벤트는 서버 전송 이벤트(Server-Sent Events, SSE)로 받습니다. Room Service와 Gateway API는 방, 역할, 지시문, 권한, 연결된 지식 및 메신저 연결을 관리하며, PostgreSQL은 이 상태를 보관합니다. 운영자는 대시보드에서 이 관리 계층을 다룰 수 있습니다.
Agent Switch Console로 시작하기
Agent Switch는 Switch Console이라는 데스크톱 앱을 제공합니다. 공식 문서는 macOS(Apple silicon 및 Intel), Windows x64, Linux x86_64와 arm64용 설치 파일을 안내합니다. README는 Windows와 Linux용 Switch Console 빌드를 early access로 표시하므로, 운영 환경에 적용하기 전에는 릴리스별 동작 차이를 확인하는 편이 안전합니다.
Codex를 이미 사용하는 경우에는 공식 문서가 안내한 대로 Switch 커넥터 플러그인을 설치할 수 있습니다:
codex plugin marketplace add sandbox-quantum/switch
codex plugin add switch-connector-codex@switch-plugins
이후에는 에이전트가 실제로 작업할 디렉터리에서 커넥터의 설정 절차를 실행해 Agent Bridge 주소, 등록 토큰, 에이전트 정보를 연결합니다. 공식 문서는 이 과정에서 생성되는 자격 증명이 작업 디렉터리의 .switch/agents/ 아래 평문으로 저장된다고 설명하므로, 해당 디렉터리를 저장소의 ignore 규칙에 추가하고 접근 권한을 점검해야 합니다.
팀이 에이전트를 지속적으로 실행하려면 Switch Console에서 원격 호스트를 연결할 수 있습니다. 공식 문서는 SSH로 접근 가능한 Linux 또는 macOS 호스트를 안내하며, 그 호스트에서 Switch 서버를 실행하려면 Docker가 필요하다고 설명합니다. 호스트가 재부팅되면 서버는 다시 시작해야 하고, 원격 에이전트는 Switch Console을 다시 실행해야 하므로, 항상 켜져 있는 협업 환경이 필요하다면 이 재시작 절차도 운영 계획에 포함해야 합니다.
Agent Switch가 유용한 팀
이미 메신저 채널을 중심으로 일하면서, 여러 에이전트에게 역할과 작업 맥락을 나눠 주려는 팀에는 Agent Switch가 적합합니다. 프로젝트가 기존 메신저와 에이전트 제공자를 바꾸지 않고 연결하는 구조이기 때문입니다. 반대로 에이전트 자체나 모델을 바로 제공받고 싶은 팀, 또는 원격 호스트와 자격 증명 관리까지 운영할 여력이 없는 팀에는 Agent Switch가 즉시 가장 단순한 선택지는 아닙니다.
Agent Switch의 라이선스
Agent Switch는 Apache 2.0 License와 수정된 Commons Clause 조건으로 공개되어 있습니다. 이 조건은 소프트웨어 또는 파생물의 기능에서 실질적인 가치를 얻는 유료 제품, 서비스, 호스팅, 컨설팅 및 지원을 판매할 권리를 부여하지 않습니다. 따라서 상업적 제공이나 재배포를 검토한다면 일반적인 Apache-2.0 프로젝트로 간주하지 말고 LICENSE 원문을 먼저 확인해야 합니다.
Agent Switch 공식 제품 페이지
Agent Switch 공식 문서
Agent Switch 프로젝트 GitHub 저장소
더 읽어보기
이 글은 GPT 모델로 정리한 초안을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 댓글로 알려주시기를 부탁드립니다. 
이 도구를 직접 설치해 사용해보셨다면, 
파이토치 한국 사용자 모임
회원들을 위해 경험이나 팁을 댓글로 남겨주세요! 