CopilotKit React Core

@copilotkit/react-core 是 CopilotKit 在 React 前端的另一半：它挂载 provider、通过 SSE 以 AG-UI 协议与运行时通信（或在 SPA 模式下直接与 CopilotKit Intelligence 通信），并为每个交互面提供 hooks。

本 SKILL.md 是索引。请阅读 references/ 中与你的任务匹配的参考文档——不要试图从本文件吸收整个包的内容。

心智模型——你组合的三个壳层

1. Provider 壳层 — CopilotKit provider（来自 @copilotkit/react-core/v2），位于或接近根节点（Next.js App Router 下需放在 "use client" 内）。承载 runtimeUrl（或在 SPA 模式下使用 publicLicenseKey）、headers、credentials、properties、onError、debug、showDevConsole。
2. 聊天壳层 — CopilotChat / CopilotPopup / CopilotSidebar，或由 CopilotChatView 与 slot 原语（CopilotChatInput、CopilotChatMessageView 等）组合而成。所有聊天组件均由 @copilotkit/react-core/v2 提供。不存在 CopilotPanel——这是常见的模型幻觉。
3. Hook 壳层 — 在 provider 下的任意组件中调用 useAgent、useFrontendTool、useRenderTool 等。每个 hook 都接收可选的 { agentId } 以进行智能体作用域的注册。

何时加载哪份参考文档

| 任务 | 参考文档 | | --------------------------------------------------------------------------------------------------------- | -----------------…