| 한눈에 보기 | |
|---|---|
| 저장소 | CopilotKit/CopilotKit |
| 개발 | CopilotKit (조직) |
| GitHub 스타 | 38,354 (오늘 +52) |
| GitHub 트렌딩 | 일간 TypeScript 7위 |
| 포크 | 4,789 |
| 주 언어 | TypeScript |
| 라이선스 | MIT |
| 공개일 | 2023-06-19 |
| 최신 릴리스 | channels/v0.12.0 (2026-10-28) |
카피로킷(CopilotKit)은 AI 에이전트를 만든 뒤 이를 실제 사용자 화면에 어떻게 붙일지의 문제를 푸는 TypeScript 오픈소스다. 개발사 카피로킷은 에이전트와 사용자 사이의 통신 규약인 AG-UI 프로토콜도 함께 만들었다. 2023년 React 라이브러리로 시작한 이 프로젝트는 최근 Slack과 Microsoft Teams까지 지원 범위를 넓히며 GitHub 트렌딩 일간 TypeScript 7위에 올랐다.
무엇을 하나: 에이전트 네이티브 앱 구성 요소
README는 CopilotKit을 '에이전트와 사용자를 잇는 수평 계층'이라고 소개한다. 같은 에이전트를 웹앱, 모바일 앱, 팀 메신저에서 모두 구동할 수 있다는 것이다. 핵심 기능은 다음과 같다.
- 채팅 UI: 메시지 스트리밍, 도구 호출, 에이전트 응답을 지원하는 커스터마이징 가능한 인터페이스
- 백엔드 도구 렌더링: 에이전트가 호출한 백엔드 도구의 결과를 UI 컴포넌트로 클라이언트에 바로 표시
- 생성형 UI(Generative UI): 사용자 의도와 에이전트 상태에 따라 런타임에 UI를 만들고 갱신
- 공유 상태: 에이전트와 UI가 실시간으로 읽고 쓰는 동기화 계층
- 사람 개입(Human-in-the-loop): 에이전트가 실행을 멈추고 사용자의 입력·승인을 받은 뒤 진행
프로덕션용으로는 유료 성격의 '카피로킷 인텔리전스(CopilotKit Intelligence)'를 별도로 제시한다. 기기와 세션을 넘어 유지되는 대화 스레드, 사용자 메모리, 분석, 완료된 대화에서 재사용 가능한 스킬을 만드는 자동 학습 기능이 포함되며, 자체 인프라에 설치하는 방식도 가능하다고 밝혔다.
작동 방식·구조
CopilotKit은 UI, 에이전트, 도구를 하나의 상호작용 루프로 묶는다. 에이전트 로직은 그대로 두고, 통신은 AG-UI가, 각 프레임워크와 채널별 화면 처리는 CopilotKit이 맡는 분업 구조다.
생성형 UI는 세 가지로 나뉜다. 미리 만든 컴포넌트를 에이전트가 호출하는 정적 방식(AG-UI), 선언형 명세를 쓰는 A2UI, MCP Apps나 오픈 JSON 같은 개방형 방식이다. 지원 대상은 React/Next.js(GA), Angular, Vue, React Native이며, Slack과 Teams는 Channels SDK로 지원한다. Discord·WhatsApp은 SDK 어댑터 단계이고 Google Chat 등은 로드맵에 있다.
써보면
코딩 에이전트에 온보딩을 맡기거나 새 프로젝트를 생성할 수 있다.
npx --yes copilotkit@latest onboard start
npx copilotkit@latest create
useAgent 훅은 AG-UI 위에서 에이전트 연결을 직접 제어한다.
const { agent } = useAgent({ agentId: "my_agent" });
// 상태 읽기: agent.state.city
agent.setState({ city: "NYC" });
최근 업데이트
최신 릴리스는 channels/v0.12.0(2026-10-28)이다.
- 보안 수정: Teams 등 Channels 연동의 보안 문제를 고쳤다.
@copilotkit/channels와@copilotkit/channels-teams사용자는 0.12.0 업그레이드를 권고받았다. - 이미지 렌더링: 정적 JSX를 Slack·Teams 메시지의 이미지로 변환하고, 카드와 네이티브 버튼·캐러셀을 조합할 수 있다.
takumiRenderer를 직접 설정해야 하는 옵트인 방식이다. - 빌드 수정: 네이티브 전용 앱 번들에 Takumi가 포함돼 Next.js 빌드가 실패하던 문제를 고쳤다.
- 호환성 깨짐: 내장 Telegram 어댑터(
@copilotkit/channels-telegram)가 제거돼 사용자는 커스텀 어댑터나 다른 채널로 옮겨야 한다.
누구에게 유용한가
이미 LangChain, CrewAI, Mastra, PydanticAI 등으로 에이전트를 만든 팀이 웹 화면이나 사내 Slack·Teams에 같은 에이전트를 붙이려 할 때 쓸 수 있다. 결재, 주문 확인처럼 사람의 승인이 필요한 업무 자동화와 대시보드형 에이전트 UI에도 적합하다.
의의와 한계
라이선스는 MIT로 상업 이용에 제약이 적고, 2023년 공개 이후 포크 4천 건 이상을 모은 만큼 커뮤니티 기반이 크다. README는 AG-UI가 Google, LangChain, AWS, Microsoft 등에 채택됐다고 주장하지만 독립 검증된 수치는 아니다. 스레드 영속성·메모리·자동 학습 같은 프로덕션 기능은 인텔리전스 플랜에 걸려 있어 오픈소스 범위를 확인해야 한다. 또 Vue 퀵스타트는 준비 중이고 Channels는 이번 릴리스처럼 기능 제거를 포함한 변경이 잦아 버전 고정과 마이그레이션 점검이 필요하다. 한국 팀이 흔히 쓰는 메신저(카카오톡 등)는 공식 지원 목록에 없다.
