copilotkit-setup

CopilotKit Setup — это официальный skill CopilotKit для подключения CopilotKit к существующему приложению или для начального создания нового проекта. Он предназначен для ситуации, когда нужно пройти путь от определения стека до первого рабочего chat-интерфейса, сохраняя выбор runtime и провайдера явным. В исходном SKILL.md описаны подготовка окружения, установка пакетов, настройка runtime, подключение provider и проверка результата; сам skill не заменяет проверку секретов, сетевого доступа и требований безопасности конкретного production-проекта. Перед началом skill проверяет базовые предпосылки: Node.js версии 18 или новее, ключ одного из поддерживаемых AI-провайдеров — OpenAI, Anthropic или Google, React-фронтенд и backend, способный запускать runtime. Поддерживаются Next.js App Router, Next.js Pages Router, Vite + React и Angular. Для определения framework используются файлы проекта: конфигурация Next.js вместе с app/ или pages/, angular.json либо Vite-конфигурация с React-зависимостями. Такой порядок позволяет сначала понять форму приложения, а уже затем выбирать пример и точку подключения. Для проекта с frontend и backend в одном Next.js-приложении исходник показывает установку @copilotkit/react-core, @copilotkit/runtime и hono. Для frontend-only и backend-only сценариев набор пакетов сокращается; для standalone Express предусмотрен отдельный набор с express, dotenv, zod и типами. Skill отдельно отмечает, что createCopilotExpressHandler уже включает CORS, поэтому дополнительный пакет cors для приведённого примера не требуется. Ключевой выбор — режим runtime. Managed Intelligence даёт durable hosted thread state, hosted ingress, dashboard и Channels, включая Slack и Teams; для него нужны аккаунт CopilotKit и project API key. Self-hosted SSE не требует hosted-зависимости и работает только с ключом AI-провайдера, но состояние thread хранится в памяти процесса, теряется после рестарта и не разделяется между репликами. Поэтому SSE подходит для самостоятельного владения persistence и инфраструктурой, а managed-вариант — когда важна сохранность thread между рестартами и deploy-операциями. В исходнике прямо указано, что SSE остаётся поддерживаемым вариантом, а не временным обходом. После выбора режима skill различает два способа HTTP-подключения. Multi-route Hono использует createCopilotHonoHandler и catch-all маршрут Next.js; операции run, connect, stop, info, transcribe и threads получают собственные пути. Single-route вариант доступен для Hono и Express: операции проходят через одну POST-точку, а режим определяется мультиплексированием методов. Это влияет на структуру маршрутов, поэтому источник рекомендует принять решение до написания runtime-кода, а не переделывать wiring после первоначальной настройки. Практический результат skill — проект с обнаруженным framework, установленными совместимыми пакетами, выбранным режимом runtime, настроенным provider и первым chat integration. При managed Intelligence нужно завершить серверное подключение и учесть требования hosted-сервиса; при SSE нужно самостоятельно учитывать in-memory состояние и ограничения нескольких реплик. В обоих случаях перед запуском следует проверить реальные credentials, переменные окружения, доступность backend и соответствие примера версии пакетов. Эти шаги делают skill полезным для bootstrap и интеграции, но не превращают его в security-аудит или гарантию корректности чужого production-кода.