CopilotKit

一句話介紹

CopilotKit是一套面向開發者的AI Agent前端框架，用於將聊天、生成式介面、狀態共享、工具調用以及人工審批等功能整合到實際應用中。它既有可自行部署的開源核心，也提供持久執行緒、托管服務以及企業級運維平台。

工具簡介

CopilotKit並非為一般使用者所設計的聊天機器人，而是一種用於建立Agent產品界面的SDK及運行時環境。開發者可以透過預製的聊天組件來快速上線，或者使用Headless API來完全掌控界面的佈局與互動方式。

框架透過AG-UI將用戶介面與Agent後端相連，如此一來，同一個前端就能夠接入不同的模型、框架或自訂Agent。而企業智能平台則在開源運行時基礎上，增加了持久化儲存、即時同步、檢查控制台以及多租戶功能。

產品組成

主要功能

預製聊天組件

CopilotChat、CopilotSidebar和CopilotPopup能夠快速建立完整的聊天介面，支援訊息流、Agent回應以及各種工具功能。團隊可自行修改標籤、歡迎語、主題以及互動行為。

Headless UI

Headless方式僅提供狀態與行為，並不強制使用預設的視覺元件。它適合已擁有設計系統、無障礙規範或需處理複雜產品互動的團隊，但需要更多的前端工程投入。

生成式UI

Agent可以根據任務需求，來呈現開發者所註冊的React組件、包裝後端工具的處理結果，或是根據即時狀態來更新介面。此外，也可以使用A2UI、MCP Apps等宣告式或開放式的方案，不過開放程度越高，其驗證與隔離的要求也就越高。

共享狀態

應用介面與Agent可以讀寫同一份類型化的狀態，並透過事件增量同步。它適合用於篩選器、表單、畫布以及多步驟任務，但必須處理權限、衝突以及伺服器端的驗證問題。

前端工具調用

開發者可以將瀏覽器端的函數轉換為Agent工具，例如用於導航、更新表單或顯示確認對話框等功能。凡是會產生外部副作用的工具，都應加入權限檢查、參數驗證以及使用者確認的機制。

人工介入

Agent可在關鍵步驟暫停，請求用戶批准、編輯輸入、重試或升級處理。該能力適合付款、刪除、發布以及高風險建議等必須保留人類控制的流程。

後端工具呈現

後端Agent呼叫工具時，前端可以使用自訂卡片來顯示參數、進度與結果。如此一來，使用者就能了解Agent正在執行什麼任務，並在處理長時間的任務時獲得即時的回饋。

多模態與語音

框架支援檔案、圖片等多模態附件，並在文件中提供語音與推理結果的顯示功能。至於模型、儲存及瀏覽器的支援，則取決於具體的整合方案與套裝服務。

持久線程與檢查

Enterprise Intelligence能讓對話在重新載入、設備更換或會話中斷後仍能繼續，並可在控制台查看相關的執行緒與事件。開源核心可讓開發者自行實現資料持久化功能，但無法自動獲得管理介面。

Channels多端入口

目前，官方倉庫明確支援 Slack 和 Microsoft Teams，且允許同一個 Agent 保持原有的工具、狀態以及人工審批模式。至於 Discord、WhatsApp、Telegram、Google Chat、iMessage 和簡訊，則仍被標記為正在規劃中中，不能說是已經支援了。

• 預製聊天、側邊欄和彈窗式Agent組件
• 完全自訂視覺的Headless前端介面
• 靜態、宣告式和開放式生成式UI方案
• Agent與應用之間的雙向共享狀態
• 前端工具調用和後端工具結果呈現
• 人工批准、修改、重試和升級流程
• 持久線程、即時同步和託管檢查平台
• Slack與Microsoft Teams頻道接入

AG-UI是什麼

AG-UI是CopilotKit團隊所推動的開放式事件協議，其功能在於連接Agent與使用者介面。它用於傳輸訊息、狀態變化、工具呼叫、生命週期相關資訊，以及自訂事件，如此一來，前端就不必為每個Agent框架都設計一套專用的通訊格式了。

這些協議並非互為替代關係。一個產品可以透過AG-UI服務進行前端互動，使用MCP來存取工具，再透過A2A連接其他Agent。

支援的Agent框架

官方文件提供了多種後端整合方案，包括內建 Agent、LangGraph、CrewAI、Mastra、Google ADK、AWS Strands、PydanticAI、Microsoft Agent Framework、Agno、LlamaIndex以及 Claude Agent SDK 等。

前端與渠道支援

使用教學

創建第一個CopilotKit應用

1. 準備Node.js 20或更高版本，並確定使用的模型服務與API密鑰。
2. 使用官方CLI創建新專案，選擇前端框架、Agent路線以及是否啟用持久線程。
3. 把密鑰放在服務端環境變數中，不要寫進客戶端代碼或版本庫。
4. 啟動本地項目，先驗證流式聊天、錯誤狀態和一次簡單工具呼叫。
5. 加入身份認證、服務端授權和日誌脫敏後，再部署到測試環境。

在現有應用中加入聊天

1. 安裝前端核心、UI和運行時套件，並依照現有框架建立伺服器端運行時入口。
2. 在應用根部配置Provider，把Agent或模型連接註冊到運行時。
3. 選擇Chat、Sidebar或Popup組件，並匹配現有設計與行動端佈局。
4. 添加一個只讀前端工具，確認參數、結果和異常都能正確顯示。
5. 逐步開放寫操作，並對每個副作用增加用戶確認和服務端權限檢查。

連接現有Agent後端

1. 先確認後端框架是否已有官方AG-UI適配器，並選擇對應文件版本。
2. 定義Agent識別碼、執行緒識別碼、初始狀態以及可調用的工具類型。
3. 將Agent註冊到Copilot Runtime，並限制跨用戶訪問與請求渠道。
4. 測試消息流、狀態增量、取消、重試和人工中斷是否保持一致。
5. 在生產前模擬網路中斷、重複事件、長時間任務和並發標籤頁。

部署持久線程平台

1. 先根據數據駐留和運維能力選擇Copilot Cloud或自託管企業智能平台。
2. 雲端方案在建立組織和專案後，會產生專案級的運行時金鑰，並依環境分開儲存。
3. 自託管方案準備Kubernetes、Postgres、Redis、OIDC、入口和密鑰管理。
4. 配置運行時的平台地址與憑證，驗證線程跨刷新和跨設備恢復。
5. 設定保留期、租戶隔離、備份、金鑰輪換、監控及事件處理流程。

生成式UI方案對比

適合哪些開發團隊

• SaaS團隊：在現有產品中加入上下文感知Copilot
• Agent創業團隊：快速完成聊天、工具和生成式UI前端
• 企業內部平台：把流程Agent放進網頁、Slack或Teams
• 數據產品團隊：讓Agent操控篩選器、表格和可視化組件
• 客服與運營團隊：在關鍵動作前加入人工確認
• 多框架團隊：透過AG-UI降低更換Agent後端的前端成本
• 合規團隊：採用自託管持久層和專案級隔離管理對話

典型使用場景

開源核心與企業平台區別

開源核心足以構建可工作的Agent應用，不要求使用CopilotKit託管服務。需要跨會話持久化時，團隊可以自己實現儲存，也可以購買企業智能平台。

價格與套餐

截至2026年8月22日，目前官方定價頁面提供Developer、Pro、Team和Enterprise四個等級。早期的產品PDF以及舊版的定價頁面所顯示的金額可能有所不同，應以現行的正式定價頁面為準。

Developer、Pro和Team都包含雲端託管、Inspector、前端SDK、Agent後端連接以及無頭UI。Team額外提供專屬的Slack支援，而Enterprise則還包含SLA服務、優先修復服務、路線圖參與機會，以及每週最多5小時的工程支援。

Channels額度

Channels積分是CopilotKit頻道能力的額度，不等同於底層模型Token。使用自帶模型密鑰時，模型推理費用通常由對應模型供應商另行收取。

部署方式

自託管企業智慧平台並非下載一個單一檔案即可運作。官方的部署方式需要 Kubernetes、Postgres、Redis、OIDC身分驗證機制、入口介面、金鑰輪換功能以及監控能力。

產品優勢

• 開源核心覆蓋聊天、工具、狀態和生成式UI完整鏈路
• AG-UI把前端與多種Agent框架解耦
• 預製組件與Headless路線兼顧速度和設計自由
• 人機協同能力適合有副作用的真實業務流程
• 官方集成覆蓋TypeScript、Python和多家Agent框架
• 同一Agent可擴展到網頁、行動端和團隊頻道
• 可從自託管開源核心逐步升級到持久化企業平台
• 活躍GitHub社區、範例和文件有助於問題排查

使用限制與注意事項

• 它是開發框架，不是註冊後即可直接使用的通用聊天機器人
• 開源框架免費不代表模型、向量庫、託管和運維免費
• 複雜生成式UI需要嚴格限制組件、屬性和可執行動作
• 共享狀態和前端工具必須在服務端再次驗證權限
• 持久線程、管理控制台和即時同步屬於商業平台邊界
• 自託管企業平台需要成熟的Kubernetes和資料庫運維能力
• 移動與非React前端的文件成熟度可能低於React路線
• 計劃中的消息平台不能按目前可用能力承諾給客戶
• 官方文件與倉庫的許可證文字存在不一致，應按具體版本核驗

安全與隱私

CopilotKit會位於使用者介面、Agent、模型以及業務工具之間，其安全設計必須涵蓋每一層面。僅隱藏前端按鈕並不等同於完成了權限控制，所有的工具參數與使用者身分都應在可信任的伺服器端重新驗證。

官方的隱私政策最後更新日期仍為2023年10月，該政策規定會收集帳戶資訊、使用資訊、IP地址、瀏覽器及作業系統的相關數據，且這些數據可能會由服務供應商來處理。企業在進行採購時，應要求獲得有關數據處理方式、數據保存方式、數據處理的第三方、安全措施以及事件應變流程的相關文件。

• 把模型密鑰、平台密鑰和工具憑證保存在服務端
• 為組織、專案、用戶和執行緒建立明確隔離邊界
• 把刪除、付款、發布和外發操作置於人工確認之後
• 對Agent生成的組件屬性和工具參數執行模式校驗
• 防止提示注入內容直接觸發高權限前端或後端工具
• 日誌中脫敏消息、附件、Token、個人資訊和業務數據
• 為持久線程設定保留期、導出、刪除和備份策略
• 升級依賴前檢查安全公告、遷移說明與許可證變化

GitHub、SDK與許可證

CopilotKit的官方主倉庫包含前端套件、運行時環境、範例、CLI以及Python SDK等目錄。目前，該倉庫在公開頁面上顯示有約3.69萬個星標，以及4600次複製次數。倉庫中的README文件及核心許可證文件都明確指出，此處所使用的許可證為MIT許可證。

官方的一份OSS對比文件仍標示為Apache 2.0，這與目前的主倉庫規定相衝突；AG-UI的獨立倉庫則明確採用MIT許可證。在實際發布或再分發時，應仔細核對所安裝套件的許可證文件，而非僅依賴概要頁面。

基本資訊

推薦指數

推薦指數為4.7分，滿分5分。CopilotKit將Agent前端中最複雜的流式互動、工具呈現、狀態共享、生成式UI以及人機協同等功能，整合成一個相對完整的開發架構。

它最適合擁有工程團隊，且準備將Agent嵌入實際產品中的專案。選擇之前應明確開源與商業的界線、模型成本、持久化需求、非React的成熟度以及授權版本。

常見問題

CopilotKit免費嗎？

開源核心可免費使用，Developer雲端套餐也永久免費。模型調用、外部資料庫、雲端資源及團隊運維成本通常需另行承擔。

最低付費套餐多少錢？

目前Pro的價格為每月39美元，包含5000個執行緒、5天的資料保留期、10GB的多模態儲存空間，以及每月2000個Channel積分。

CopilotKit是聊天機器人嗎？

不是現成的通用聊天服務，而是開發Agent聊天與互動界面的框架。用戶需要提供模型或Agent後端並完成應用整合。

可以不用Copilot Cloud嗎？

可以。開源核心能在自有基礎設施運行，團隊也可自行實現認證和持久化；託管平台主要提供現成的持久線程、檢查和運維能力。

支援哪些模型？

內建Agent可連接OpenAI、Anthropic、Google以及相容AI SDK的模型，也可透過外部Agent框架使用其他模型。模型是否可用則取決於具體的後端系統。

支援LangGraph嗎？

支持，官方提供Python、FastAPI和TypeScript等路線，也是功能覆蓋較完整的集成之一。

AG-UI和MCP有什麼區別？

AG-UI負責處理Agent與使用者介面之間的即時互動，而MCP則負責處理Agent與各種工具及資料之間的連接。這兩者相輔相成，通常會在同一個應用程式中一起使用。

可以生成React組件嗎？

可以，Agent可調用預註冊組件、渲染後端工具結果或根據共享狀態更新UI。生產環境應限制組件目錄和屬性範圍。

支援人工審批嗎？

支援，Agent可暫停並等待用戶批准、編輯、重試或升級處理。真正的業務權限仍必須由服務端控制。

支援Slack和Teams嗎？

目前兩者皆已正式支援，且受到各套組的組織數量、頻道數量及積分限制。其餘多個訊息平台仍處於規劃階段。

CopilotKit採用什麼許可證？

目前，GitHub的官方主倉庫及根許可證均明確為MIT，但有一份官方說明文件仍標示為Apache 2.0。應以實際使用的倉庫版本以及程式包內的許可證規定為準。

企業智能平台開源嗎？

不是。CopilotKit採用開源核心加商業企業平台的雙層模式，持久線程、託管檢查、多租戶及企業支援屬於商業功能。

總結

CopilotKit適合用來打造真正嵌入產品中的AI Agent體驗，而非僅僅是獨立的聊天視窗。其開源核心提供了功能完善的聊天、工具、狀態管理、生成式UI以及人機協同功能。

項目進入生產後，應根據線程持久化、跨設備同步、管理控制台以及合規需求來決定是自行建置還是購買企業平台，同時持續核對套裝、依賴項目及許可證的變動。