네이티브 인터랙티브 UI(interactive UI)를 통해 어떤 AI 에이전트든 Slack, Microsoft Teams 및 업무가 이루어지는 채널로 가져오세요.

channels-sdk.demo.mp4

에이전트는 자신의 도구(tools), 모델(model), 그리고 비즈니스 로직(business logic)을 그대로 유지합니다. Channels는 에이전트가 사람들과 함께 일할 수 있는 네이티브한 공간을 제공합니다.

Channels는 AG-UI 호환 에이전트를 팀이 이미 사용 중인 커뮤니케이션 플랫폼에 연결합니다. 에이전트는 대화를 이해하고, 응답을 스트리밍(stream)하며, 도구를 호출하고, 파일과 작업하며, 인터랙티브 UI를 렌더링(render)하고, 사람의 승인을 위해 일시 중지할 수 있습니다.

Channels는 동일한 에이전트가 모든 커뮤니케이션 접점에서 사용자를 만날 수 있는 세상을 위해 구축되었습니다. Slack 및 Microsoft Teams를 위한 관리형 연결(Managed connections)은 CopilotKit Intelligence를 통해 사용할 수 있으며, 더 많은 채널이 추가될 예정입니다.

앱, 런타임(runtime) 또는 제공업체 자격 증명(provider credentials)을 설정할 필요 없이 Slack 또는 Microsoft Teams에서 실제 Channels 에이전트를 경험해 보세요.

플랫폼을 선택하고, 경험에 참여하여 에이전트가 컨텍스트(context), 도구 사용(tool use) 및 네이티브 채널 UI를 어떻게 처리하는지 확인하세요.

에이전트와 애플리케이션 로직은 귀하의 인프라에서 실행됩니다. CopilotKit Intelligence는 플랫폼 연결을 관리하고 각 턴(turn)을 귀하의 장기 실행(long-running) Channels 프로세스로 전달합니다.

Channels 에이전트를 구축하는 과정은 프로젝트, 에이전트, 관리형 채널(managed Channel), 제공업체 앱, 그리고 장기 실행 런타임에 걸쳐 이루어집니다. 하나의 가이드가 에이전트를 이 모든 과정으로 안내합니다.

npx copilotkit@latest channels setup

이 명령은 channels-setup 스킬(skill)을 설치하고, 프롬프트(prompt)를 출력하며, 이를 클립보드에 복사합니다. 이를 코딩 에이전트에 붙여넣으세요.

이 스킬은 포인터(pointer)입니다. 에이전트가 필요할 때 copilotkit.ai/channels-guide.md에서 워크플로우(workflow)를 가져오므로, 설치된 스킬이 몇 달 전 것이더라도 단계(steps)가 최신 상태로 유지됩니다. 가이드는 Slack 또는 Microsoft Teams 중 어떤 플랫폼을 원하는지, 그리고 어떤 에이전트 프레임워크(agent framework)를 사용하는지 묻습니다.

에이전트는 사용자의 로그인된 세션 내에서 Slack 및 Intelligence 콘솔을 직접 제어합니다. 만약 에이전트에 브라우저나 컴퓨터 사용(computer-use) 도구가 아직 없다면, 먼저 도구를 추가하라고 요청할 것입니다. 이는 예외 상황(fallback)이 아니라 의도된 경로입니다. 사용자가 비밀값(secrets)을 입력하면, 에이전트가 클릭을 수행합니다.

또는 디스크에 Slack 설정 스킬을 설치하세요

호스팅된 가이드를 건너뛰고, 이미 실행 중인 코딩 에이전트에 Slack 워크플로우를 직접 넣으세요:

npx copilotkit@latest skills install --skill setup-slack-channel -y

-y는 선택기(picker)를 열지 않고 해당 스킬 하나만 설치합니다. 이 스킬은 Slack으로 범위(scoped)가 제한되어 있습니다. Microsoft Teams의 경우 위의 가이드를 사용하세요.

CLI는 Intelligence 측면을 다룹니다: copilotkit channels add --adapter slack은 채널(Channel)을 선언하고 어댑터(adapter)를 연결하며, copilotkit channels status는 사용자의 설정, 코드, 그리고 서버를 비교합니다. 브라우저에서 수행되는 작업은 제공자(provider) 측 작업입니다. 즉, Slack 앱을 생성하여 워크스페이스(workspace)에 설치하고 프로젝트 API 키를 발급받는 작업입니다. 어떤 CLI 플래그도 자격 증명(credential) 값을 허용하지 않으므로, 봇 토큰(bot token)과 서명 비밀값(signing secret)은 사용자의 .env 파일에 안전하게 남게 됩니다.

Unknown option '--skill'

이전 버전의 copilotkit — 전역(globally)으로 설치되었거나 npx 캐시에 남아 있는 — 이 현재의 CLI를 가리고(shadowing) 있을 수 있습니다. @latest를 계속 유지하세요. 이것이 npx가 이미 가지고 있는 것을 재사용하는 대신 현재 버전을 가져오도록 강제하는 방법입니다.

아래 단계들은 수동으로 진행하는 동일한 경로입니다.

CopilotKit Intelligence에서 채널(Channel)을 생성하고 Slack을 연결합니다. 다음 단계를 위해 채널 **코드(Code)**와 프로젝트 범위의 Intelligence API 키를 보관하세요.

Node.js 22 이상 버전과 계속 실행 중인 Node 프로세스 또는 컨테이너(container)가 필요합니다.

npm install @copilotkit/channels @copilotkit/runtime
npm install --save-dev tsx typescript @types/node
npm pkg set type=module

Channels와 Runtime은 테스트를 마친 한 쌍으로 함께 배포됩니다. 두 패키지를 함께 업그레이드하세요.

아래 예제는 CopilotKit의 내장 에이전트(built-in agent)를 사용합니다. Channel 생명주기(lifecycle)를 변경하지 않고도 makeAgent를 AG-UI 호환 에이전트 팩토리(agent factory)로 교체할 수 있습니다.

// channel.ts
import { createServer } from "node:http";
import { createChannel } from "@copilotkit/channels";
...

# .env
OPENAI_API_KEY=<openai-api-key>
INTELLIGENCE_API_KEY=<project-api-key>
...

node --env-file=.env --import tsx channel.ts

Intelligence가 Online 상태를 보고하면, 앱을 Slack 채널에 초대하고 멘션하세요. 이제 에이전트가 대화를 수신하고 스레드(thread) 내에서 응답합니다.

Microsoft Teams, 다른 에이전트 프레임워크(agent framework), 대화형 승인(interactive approvals), 파일, 또는 프로덕션 배포 가이드가 필요하신가요? Channels 문서에서 계속 확인하세요.

에이전트가 직접 수행하게 하고 싶으신가요? 위에서 설명한 가장 빠른 경로(Fastest path)에서 npx copilotkit@latest channels setup을 실행하세요. 해당 가이드는 이 설정과 더불어 프로바이더(provider) 및 검증(verification) 단계를 다룹니다.

모든 턴(turn)은 동일한 경로를 따릅니다:

• 사용자가 Slack 또는 Microsoft Teams에서 앱에 메시지를 보냅니다.
• CopilotKit Intelligence가 플랫폼 이벤트(platform event)를 수신하여 Channels 프로세스로 전달합니다.
• Channels가 AG-UI를 통해 에이전트를 실행하고, 도구(tools)를 실행하며, 결과를 렌더링(renders)합니다.
• Intelligence가 플랫폼 네이티브 UI를 대화로 다시 보냅니다.

SDK는 오픈 소스이며 MIT 라이선스를 따릅니다. CopilotKit Intelligence는 CopilotKit에 의해 호스팅되거나 기업용 배포를 위해 셀프 호스팅(self-hosted)될 수 있습니다.

OpenTag는 Channels로 구축된 오픈 소스 셀프 호스팅 온콜 트리아지(on-call triage) 어시스턴트입니다.

다음과 같은 완전한 애플리케이션을 학습하는 데 사용해 보세요:

• AG-UI를 통해 연결된 Python LangGraph 에이전트
• 네이티브 Slack 및 Microsoft Teams 경험
• 파일 인지 프롬프트 (file-aware prompts) 및 생성형 UI (generative UI)
• Linear 또는 Notion에 쓰기 전 인간의 승인 단계
• 프로덕션 환경에 적합한 Node 런타임 (runtime) 및 에이전트 서비스