Channels SDK: AG-UI 에이전트를 Slack·Teams에 붙이는 오픈소스 SDK

Who Should Read

이미 만든 LangGraph·Mastra 같은 에이전트를 사내 Slack이나 Teams에서 쓰게 하고 싶은 백엔드 개발자

Core Mechanics

• 에이전트는 그대로 두고 채팅만 붙인다
  • 에이전트의 도구, 모델, 비즈니스 로직은 그대로 유지한다.
  • AG-UI(에이전트와 UI를 잇는 프로토콜)를 지원하는 에이전트면 연결된다.
• UI는 한 번만 쓰면 된다
  • 메시지를 한 번 기술하면 Slack Block Kit과 Teams Adaptive Cards로 각각 렌더링된다.
  • 버튼, 선택지, 승인 단계를 대화창 안에 넣을 수 있다.
• 설치는 코딩 에이전트에 맡길 수 있다
  • npx copilotkit@latest channels setup을 실행하면 skill이 설치되고 프롬프트가 클립보드에 복사된다.
  • 이 프롬프트를 코딩 에이전트에 붙여넣으면 Slack 또는 Teams, 에이전트 프레임워크를 물어보며 진행한다.
• 수동 설치는 Node 22 이상이 필요하다
  • @copilotkit/channels와 @copilotkit/runtime을 함께 설치하고 함께 업그레이드해야 한다.
  • 장시간 실행되는 Node 프로세스나 컨테이너가 필요하다.
• 역할 분담이 나뉜다
  • 에이전트, 모델 키, 도구, 리스너, 배포는 내 인프라에서 돌린다.
  • 플랫폼 연결, 수신, 인증 정보 기반 전달, 재연결은 CopilotKit Intelligence가 맡는다.

Community Reactions

• 라이선스 논란이 있었다는 의견
  • MIT인 건 클라이언트뿐이고 실제 구동 서비스는 닫혀 있고 라이선스로 제한된다는 의견이 있었다.
  • 개발팀은 Intelligence가 직접 호스팅 가능하고 외부로 호출하지 않으며, 모델 호출은 사용자 에이전트가 한다고 답했다.
• 내부 사용 경험이 공유됐다
  • 개발팀이 직접 써 봤더니 작업 전용의 작은 에이전트들이 채널에 많이 생겼다는 경험이 올라왔다.
  • 점심 주문, 장애 분류, PR 기반 마케팅 영상 생성 에이전트가 예로 나왔다.
• 내부 구조 설명이 나왔다
  • 승인 카드를 올리고 전달을 ack한 뒤 클릭이 오면 실행을 재개해, 재시도나 재시작에도 승인이 유지된다는 설명이 있었다.
  • 핸들러 ID가 내용 해시라서 지난주 버튼도 배포 후 동작한다는 설명이 있었다.
• 우려와 대안 의견도 있었다
  • Team 요금제 가격을 보고 도입을 접었다는 의견이 있었다.
  • Vercel Chat SDK의 래퍼냐는 질문이 있었고, eve.dev를 써 보니 잘 만들어졌다는 경험이 공유됐다.

How to Apply

• 오늘 setup 명령으로 Slack 봇 띄워보기
  • 터미널에서 npx copilotkit@latest channels setup을 실행하고 클립보드 프롬프트를 코딩 에이전트에 붙여넣어라.
  • 테스트 Slack 워크스페이스를 고르고 시크릿은 직접 .env에 입력하라.
• 기존 에이전트를 AG-UI 호환인지 확인하기
  • 쓰는 프레임워크(LangGraph, Mastra, CrewAI 등)가 AG-UI 연동을 지원하는지 AG-UI integrations 문서에서 확인하라.
  • 지원하면 makeAgent 팩토리만 내 에이전트로 바꿔라.
• 쓰기 작업 앞에 승인 버튼 넣기
  • 이슈 생성이나 DB 수정처럼 되돌리기 어려운 도구 호출 앞에 승인 게이트를 넣어라.
  • OpenTag의 Linear·Notion 쓰기 승인 흐름을 참고해 구성하라.
• 도입 전 라이선스와 요금 확인하기
  • 팀에서 쓰기 전에 Intelligence의 호스팅 방식과 Team 요금제를 확인하라.
  • 자체 호스팅 여부는 CopilotKit에 직접 문의하라.

Try It

# Claude Code 같은 코딩 에이전트에 그대로 붙여넣기 (셸에서 먼저 npx copilotkit@latest channels setup 실행)

Read https://copilotkit.ai/channels-guide.md and help the user build their first channel.

내 에이전트 프레임워크: {{LangGraph / Mastra / CrewAI / 내장 에이전트}}
붙일 플랫폼: {{Slack 또는 Microsoft Teams}}

브라우저 도구가 없으면 먼저 추가를 요청하고, 비밀 값은 내가 직접 입력할게.

이어서 해 볼 것: 채널 안에서 봇을 멘션해 스레드 응답이 오는지 확인한 뒤, 승인 버튼을 추가해 달라고 요청해 보세요.

Terminology

관련 논문

• 같은 시뮬레이션, 다른 근거: 도구 출력을 파일로 넘기면 LLM 에이전트 정확도가 어디서 깎이나

  긴 툴 출력을 파일로 넘기자 GPT-5.1은 정확도 11.3%p 하락, 정식 출력 지정하니 회복

• 가짜 뉴스가 진짜 폭락을: LLM 트레이딩 에이전트 대상 정보 주입 공격

  가짜 헤드라인 한 줄로 LLM 트레이딩 에이전트 62%를 조종했다(프롬프트 주입은 14%)

• Harness Engineering 101: LLM은 뇌, harness는 몸

  에이전트는 JSON 배열을 관리하는 루프이고, 16개 챕터로 직접 만들어 본다

• Harness²: 에이전트 harness를 스스로 고쳐 쓰는 재귀 최적화 프레임워크

  모델은 고정하고 harness를 재귀로 고쳤더니 벤치마크 점수가 최대 11.8%p 올랐다

• 해고된 Savannah 경찰관, ICE 요원 남편에게 Flock 계정 공유

  경찰관이 Flock 계정을 남편(ICE 요원)에게 공유했고, 감사에서 983건 검색이 드러나 해고됐다

• tmux와 Claude Code: 세션, send-keys, 그리고 한계선

  tmux로 Claude Code 여러 개를 돌리면 편하지만 에이전트 4개쯤에서 한계가 온다

• Hybrid Reasoning Agents: 잠재 공간에서 생각하고 텍스트로 행동하는 LLM 에이전트

  잠재 공간 추론과 텍스트 도구 호출을 섞었더니 성능 10.4%↑, 토큰 최대 54.7%↓

Related Resources

• https://github.com/CopilotKit/channels-sdk
• https://copilotkit.ai/channels-guide.md
• https://copilotkit.ai/try-channels
• https://github.com/vercel/chat
• https://eve.dev/
• https://wingman.actor