개요

OpenTag는 copilotkit이 2026-06-26 공개한 MIT 오픈소스 Channels SDK 스타터 애플리케이션이다. Slack·Microsoft Teams 스레드 안에서 지식 업무 에이전트가 동작하며, README는 스스로를 “연결 도구와 생성형 UI가 포함된 자체 호스팅 지식 업무 에이전트”로 소개한다. 데모가 아니라 “프로덕션 형태”(Railway 2서비스, 고정 SDK 버전, graceful shutdown, 실 Slack 테스트 하네스)를 내세운다. 2026-10-04 기준 별 1,227개·포크 135개. 계열 중 가장 먼저 나왔고 OpenDots가 Slack 연결의 참조 구현으로 삼는다.

데모 시나리오

CSV를 올리면 Slack 네이티브 차트와 요약이 돌아오고, Linear 이슈 생성 같은 쓰기는 승인 카드 뒤에서 일어나며, 웹 리서치는 출처 링크가 달린 표로 답한다. 전부 스레드 안에서 끝난다.

구조

Slack/Teams → CopilotKit Intelligence(수신·전달 관리) ⇄ websocket(아웃바운드) → Node 런타임(Channels 내장) → AG-UI → Python LangGraph 에이전트(OpenAI, Parallel 검색, GitHub·PostHog·Linear·Notion MCP, Composio)
  • 운영자는 Python 에이전트·모델 키·도구와 Node 런타임을, Intelligence는 Slack·Teams 자격증명과 수신·전달·재연결을 맡는다. 소켓 모드·터널·공개 URL이 필요 없다. 직접 만든 채널 러너로 대체할 수도 있다.
  • 바꿀 곳이 분리되어 있다: 페르소나는 agent/prompts/, 에이전트 프레임워크는 AGENT_URL(아무 AG-UI 에이전트), 도구는 agent/tools.py, 채팅 렌더링은 app/components/, 트리거는 app/channel.tsx 한 파일.
  • 쓰기 승인: Linear·Notion 변경은 코드에서 가로채 confirm_write 카드를 띄우고 승인 후에만 실행하며, LangGraph interrupt가 버튼으로 재개된다. 코딩 서브에이전트(Daytona)의 push·초안 PR도 같은 카드를 쓴다. 읽기와 렌더링은 멈추지 않는다.

설정에서 비용이 큰 함정

  • Socket Mode는 꺼 둔다: 켜면 설치는 초록으로 끝나는데 아무것도 전달되지 않는다(성공처럼 보이는 유일한 실패).
  • 봇은 채널에 /invite 해야 app_mention이 발생한다. 앱 설치만으로는 대화에 존재하지 않는다.
  • 매니페스트 적용은 Reinstall to Workspace 후에만 되고, 서명 비밀은 재설치 때 재발급된다.
  • 채널 이름은 배달을 선점한다: 같은 Intelligence 프로젝트에서 같은 이름을 쓰는 두 런타임은 경합하고 진 쪽은 조용히 아무것도 못 받는다. 포크는 자기 프로젝트·키·채널 이름을 쓴다.
  • 검증은 사람 계정으로 (1) 멘션 응답 (2) 구독된 스레드의 무멘션 후속 응답 (3) 새 대화의 무멘션 메시지에는 침묵, 세 가지를 본다.
  • Teams는 개인 메시지가 없어 Composio 개인 연결 링크를 전달하지 못한다. 런타임은 채널 배선을 핫리로드하지 않는다.

배포

Railway 2서비스(agent, runtime)가 기본이고 AWS는 ECS Fargate 단일 태스크(Secrets Manager·CloudWatch→Datadog) 가이드가 있다. 이미지는 ghcr.io/copilotkit/opentag-{agent,runtime}. 요건은 Node 22+·pnpm·Python 3.12·uv·CopilotKit 계정·OpenAI 키. Discord·Telegram·WhatsApp은 예정이다. 웹 검색 기본값은 Parallel Search MCP(키 없이 가벼운 사용, 질의·URL 외부 전송)이며 Tavily·비활성으로 바꿀 수 있다.

확인 범위와 한계

  • README 기준 정리이며 직접 설치·Slack 연결은 하지 않았다. 데모 화면은 저자가 실제 Slack 워크스페이스에서 찍었다고 밝힌다.
  • 관리형 채널은 copilotkit Intelligence에 의존하며(무료 플랜 있음) 완전 오프라인 자체 호스팅은 별도 러너를 직접 만들어야 한다.

관련 위키