CopilotKit：為你的應用打造 AI 助理

白話介紹：CopilotKit 是做什麼的？

CopilotKit 是由 Tawkit, Inc. 提供的開源開發框架，讓團隊把 AI 助理放進自己經營的網站或應用程式。它負責銜接使用者介面與 AI 代理，讓使用者能在原本的工作畫面中提問、查看結果，或透過團隊設定好的工具執行操作。

可以用待辦清單來理解：開發者先提供清單狀態與新增事項的功能，使用者再說「幫我加入這幾件事」，代理便能依工具設定處理，畫面跟著更新。這需要開發與資料串接，並非開啟 CopilotKit 官網就會自動控制任意網站。

它適合 SaaS、內部系統與行動應用的產品團隊，尤其是希望把 AI 從文字回答延伸到實際工作流程的人。

把 AI 助理接進網站與既有系統

現成聊天元件可以先提供對話入口，再逐步接上應用程式的功能，例如切換頁面、篩選紀錄或更新欄位。前端工具的處理函式在瀏覽器執行，能使用你明確提供的應用能力；後端的資料權限仍須由系統本身管理。

前端 SDK 包含 React、Angular、Vue 與 React Native。後端則有 LangGraph、Google ADK、Mastra、PydanticAI 等整合路線。AG-UI 是代理與介面的通訊協定，CopilotKit 提供元件和互動層，不需要把兩者當成相互排斥的選項。官方另有 Slack 與 Microsoft Teams 的 Channels 路線，各平台的支援細節要分別確認。

生成式介面、共享狀態與人工確認

生成式介面可以把回答呈現成圖表、表格或卡片。受控的 React 路線透過 useComponent 註冊元件與參數，代理選擇元件並傳入資料，產品仍能沿用自己的設計系統。展示元件本身不會代替後端操作；需要填寫、選擇或確認時，應搭配對應互動機制。

共享狀態讓代理與畫面讀寫同一份工作資料，避免助理說已修改，畫面卻沒有更新。人工參與機制（HITL）則可暫停流程、收取使用者回覆後繼續。必須強制確認的動作，應以後端流程檢查點落實，不能只依靠模型主動詢問。詳見元件式生成 UI。

React 與 Vue 專案如何開始接入

以官方 React 路線為例，可按以下順序完成第一個可檢查的成果：

1. 準備 Node.js 20+、React 專案及模型服務的 API 金鑰。
2. 安裝 @copilotkit/react-core 和 @copilotkit/runtime，設定服務端模型憑證並建立 runtime 接口。
3. 用 Provider 指向 runtime，匯入樣式，加入聊天或側欄元件。
4. 先驗證一般對話，再加入一個用途清楚的前端工具。
5. 檢查操作結果與畫面狀態，並在本機 Inspector 觀察代理及 AG-UI 事件。

若已有代理，應沿用其框架的整合指南；BuiltInAgent 是直接呼叫模型的內建代理，不會自動串接既有邏輯。Vue 或純前端 SPA 需要依各自路線配置獨立 runtime，不能直接套用 Next.js 同源 API 的設定。請對照官方快速入門。

免費方案、付費門檻與部署選擇

截至 2026 年 10 月 18 日，官網公開美元標價包含：Developer 免費供一位開發者開始，最多 200 個對話串、保留 3 天及 1 GB 多模態儲存；Pro 為每月 39 美元；Team 為每席每月 100 美元，頁面標示最多 5 席；Enterprise 採客製報價。Team 的待接受邀請也會占用席位。以上不是新臺幣報價，也不代表含稅總成本。

開源 SDK、平台用量和模型推論費用應分別評估。Intelligence 延伸了跨工作階段的豐富對話紀錄、使用者記憶等功能；目前價目表將分析與自我學習列為 Enterprise 早期存取，不能一律視為免費內含。

自行架設也分 runtime 與完整平台，Developer/Pro 的表列範圍是 runtime-only。實際需求涉及資料庫、保留期限或企業部署時，請查閱現行方案比較。

資料處理、授權與適用情境

官方程式碼採 MIT 授權，可依其條件用於商業軟體，並保留必要聲明。託管服務和企業功能仍有各自條款。

選擇自行架設時，要一併盤點模型 API、工具服務和資料庫。只把 runtime 放到自己的伺服器，不代表資料不會傳給外部模型。官方隱私政策將網站服務與依客戶協議處理的資料分開說明，不能據此宣稱所有情境皆不留存或不用於訓練。

開源遙測文件說明其蒐集的是中繼資料，而非提示詞、訊息、代理狀態或工具內容，也提供停用方式。對需要應用內 AI 互動的開發團隊，這些部署控制具有評估價值；只想直接聊天的使用者則仍需考量整合門檻。

常見問題

CopilotKit 可以免費使用嗎？

可以，開源 SDK 與 Developer 方案提供免費起點，但平台額度有限，外部模型和應用部署也可能產生費用。

CopilotKit 支援 Vue 嗎？

支援。Vue 有自己的元件及 composables；React 範例中的 API 不宜直接照搬，應查閱 Vue 文件。

自行架設就能保證資料不外傳嗎？

無法單憑自行架設保證。仍要檢查模型、第三方工具、遙測及資料儲存的實際路徑，並確認所需平台功能的部署條件。

官方文件與開發者社群

• 官方文件：選擇前端與代理整合方式。
• GitHub 專案：查閱原始碼、授權與問題紀錄。
• 官方 Discord 社群：討論實作與接入問題。