CopilotKit：全栈 AI முகவர், உருவாக்கும் UI மற்றும் உரையாடல் பயன்பாடுகளை உருவாக்குவதற்கான சிறந்த SDK

பின்னணி சுருக்கம்

CopilotKit என்பது AI Copilot மற்றும் முகவர்-நேட்டிவ் பயன்பாடுகளை உருவாக்குவதற்கான திறந்த மூல கட்டமைப்பாக வடிவமைக்கப்பட்டுள்ளது, GitHub இல் 28.9k க்கும் மேற்பட்ட நட்சத்திரங்களை பெற்றுள்ளது, 100,000 க்கும் மேற்பட்ட டெவலப்பர்களால் பயன்படுத்தப்படுகிறது. இந்த கட்டமைப்பின் மைய மதிப்பு AI முகவர்களை பயனர் இடைமுகத்துடன் ஆழமாக ஒருங்கிணைப்பதில் உள்ளது, இது முகவர்களுக்கு UI ஐ நேரத்தில் கட்டுப்படுத்த, சூழல் தகவல்களை வழங்க மற்றும் உருவாக்கும் UI மூலம் இடைமுகக் கூறுகளை இயக்குவதற்கான திறனை வழங்குகிறது.

மைய கண்டுபிடிப்புகள்

1. கட்டமைப்பு வடிவமைப்பு மற்றும் மைய செயல்பாடுகள்

CopilotKit மூன்று அடுக்குகளைக் கொண்ட கட்டமைப்பை பயன்படுத்துகிறது, இது முன்னணி கூறுகள், CopilotRuntime இயக்கம் மற்றும் முகவர் இணைப்பு அடுக்குகளை உள்ளடக்கியது.

முன்னணி கூறுகள் அடுக்கான முழுமையான ஸ்பெக்ட்ரம், முழுமையாக தலைவில்லா (Headless) UI முதல் முன்கட்டமைக்கப்பட்ட தனிப்பயனாக்கக்கூடிய கூறுகள் வரை, டெவலப்பர்கள் தேவைக்கு ஏற்ப எளிதாக தேர்வு செய்யலாம். CopilotRuntime என்பது பின்னணி ஒழுங்குபடுத்தும் இயந்திரமாக செயல்படுகிறது, இது முன்னணி கிளையன்ட் மூலம் வரும் கோரிக்கைகளை கையாள, LLM அழைப்புகளை நிர்வகிக்க மற்றும் முகவர் தொடர்புகளை கையாளுகிறது. முகவர் இணைப்பு அடுக்கு AG-UI ஒழுங்கு மூலம் எந்த முகவர் கட்டமைப்பையும் இணைக்கிறது, இதில் LangGraph, CrewAI, LlamaIndex போன்றவை உள்ளன.

CopilotKit இன் மைய அம்சங்களில் உருவாக்கும் UI (Generative UI) அடங்குகிறது, இது முகவர்களுக்கு இயக்கத்தின் போது UI கூறுகளை இயக்க அனுமதிக்கிறது; பகிர்ந்த நிலை (Shared State), முன்னணி மற்றும் முகவருக்கிடையிலான இருதரப்பு நிலை ஒத்திசைவு; மற்றும் மனிதர்-இன்-தி-லூப் (Human-in-the-Loop), இது முகவர்களுக்கு செயல்பாட்டின் போது மனித உள்ளீடு அல்லது அங்கீகாரம் கோர உதவுகிறது. இந்த அம்சங்கள் உண்மையான தொடர்புடைய AI பயன்பாடுகளை உருவாக்குவதற்கான வாய்ப்புகளை உருவாக்குகிறது, இது எளிய கேள்வி-பதில் அமைப்புகளை மட்டுமே அல்ல.

வேலைப்போக்கு விளக்கம்:

2. AG-UI ஒழுங்கு: சூழலின் அடித்தளம்

AG-UI (Agent-User Interaction Protocol) என்பது CopilotKit குழுவால் அறிமுகப்படுத்தப்பட்ட திறந்த, எளிதான, நிகழ்வு இயக்கத்திற்கான ஒழுங்கு தரநிலையாகும், இது AI முகவர்கள் மற்றும் பயனர் மைய பயன்பாடுகளுக்கிடையிலான தொடர்புகளை தரநிலைப்படுத்துவதற்கான நோக்கத்துடன் உருவாக்கப்பட்டுள்ளது. இந்த ஒழுங்கு Google, Microsoft, AWS, LangChain, Mastra, Pydantic AI போன்ற முக்கிய நிறுவனங்கள் மற்றும் கட்டமைப்புகளால் பரவலாக ஏற்றுக்கொள்ளப்பட்டுள்ளது, இது வளர்ந்து வரும் சூழலை உருவாக்குகிறது.

AG-UI ஒழுங்கு ஒரு முக்கிய பிரச்சினையை தீர்க்கிறது: பாரம்பரிய முன்னணி மற்றும் பின்னணி தொடர்பு முறை (கோரிக்கை-பதில்) முகவர் பயன்பாடுகளின் சிக்கலான தேவைகளை பூர்த்தி செய்ய முடியாது. முகவர்களுக்கு நேரத்தில் நிலை புதுப்பிப்புகளை, செயல்முறை இடைஞ்சல்களை மற்றும் அங்கீகார செயல்முறைகளை கையாள, UI மற்றும் முகவர் நிலையை ஒத்திசைக்க, மேலும் எளிதான தொடர்பு முறைமைகள் தேவைப்படுகிறது. AG-UI நிகழ்வு ஓட்டம் (Event Streaming) மூலம் இந்த செயல்பாடுகளை செயல்படுத்துகிறது, நேரடி உரை ஓட்டம், கருவி அழைப்புகள், நிலை ஒத்திசைவு மற்றும் தனிப்பயனாக்கப்பட்ட நிகழ்வுகளை ஆதரிக்கிறது.

தற்போது முகவர் ஒழுங்கு துறையில் மூன்று முக்கிய தூண்கள் நிலைத்திருக்கின்றன: AG-UI பயனர் மற்றும் முகவர் இடையிலான தொடர்பு அடுக்கில் கவனம் செலுத்துகிறது, MCP (Model Context Protocol) முகவர்களை கருவிகள் மற்றும் தரவுகளுடன் இணைக்கிறது, மற்றும் A2A (Agent-to-Agent) முகவர்களுக்கிடையிலான ஒத்திசைவு தொடர்புகளை கையாள்கிறது. AG-UI A2A ஒழுங்குடன் கைமுறையை ஒருங்கிணைத்துள்ளது மற்றும் உருவாக்கும் UI இயக்கத்திற்கான Google இன் A2UI தரநிலையை முழுமையாக ஆதரிக்கிறது.

3. முக்கிய கட்டமைப்புகளுடன் ஒருங்கிணைப்பு

CopilotKit 与 LangGraph 的集成是最成熟的用例之一。通过简单的配置，开发者即可将 LangGraph 代理连接到 CopilotKit 前端，实现状态共享和实时流式响应。集成过程通常包括使用 useCoAgent hook 连接代理，通过 copilotkitemitstate 函数从代理端发射状态更新，以及使用 useCopilotAction 定义人机协作中断点。

对于 CrewAI 开发者，CopilotKit 同样提供了开箱即用的集成方案。通过 AG-UI 协议，开发者可以将任何 CrewAI 代理暴露为支持实时交互的前端应用。除 LangGraph 和 CrewAI 外，AG-UI 协议还支持 Microsoft Agent Framework、Google ADK、AWS Strands Agents、Mastra、Pydantic AI、Agno、LlamaIndex 等众多框架，形成了真正的多框架互操作性。

4. 与同类框架的对比分析

与 Vercel AI SDK 相比，CopilotKit 的定位有显著差异。Vercel AI SDK 主要专注于简化聊天界面的流式文本传输，提供了优秀的 useChat hook 和 UI 组件；而 CopilotKit 更强调深度代理集成、生成式 UI 和人机协作能力。

与 LangChain 的关系则更像是互补而非竞争。LangChain 侧重于构建代理的"大脑"（逻辑和工作流），而 CopilotKit 提供该大脑的"面孔、声音和双手"——即与应用交互的界面。开发者通常使用 LangChain/LangGraph 定义代理逻辑，然后通过 CopilotKit 构建用户交互层。

5. 典型应用场景

CopilotKit 的典型用例涵盖多个领域。SaaS Copilot 是其最常见的应用场景，智能助手可以引导用户完成复杂的工作流程，提供上下文感知的帮助。共创 Copilot 则强调人机协作，AI 与用户共同创建内容，显著提升生产力。对话式表单填写将繁琐的表单转化为自然对话交互，用户通过聊天即可完成复杂的数据输入。研究代理应用如官方演示的研究画布应用，展示如何将 LangGraph 代理与前端深度集成，实现研究大纲生成、章节撰写和人类审批的完整流程。

快速入门：代码示例

基础集成示例

以下是一个使用 CopilotKit 与 LangGraph 集成的最小可运行示例：

前端（Next.js/React）：

// app/page.tsx "use client"; import { CopilotKit } from "@copilotkit/react-core"; import { CopilotPopup } from "@copilotkit/react-ui"; import "@copilotkit/react-ui/styles.css";

export default function Home() { return (

研究助手

); }运行时 API 路由：

// app/api/copilotkit/route.ts import { CopilotRuntime, OpenAIAdapter } from "@copilotkit/runtime"; import { NextRequest } from "next/server";const copilotKit = new CopilotRuntime({ remoteEndpoints: [ { url: process.env.LANGGRAPHURL || "http://localhost:8000" }, ], });

const serviceAdapter = new OpenAIAdapter();

export const POST = async (req: NextRequest) => { const { handleRequest } = copilotKit; return handleRequest(req, { serviceAdapter }); };

பகிர்வு நிலை எடுத்துக்காட்டு

// useCoAgent ஐப் பயன்படுத்தி முன்னணி மற்றும் பின்னணி நிலை ஒத்திசைவு செய்யவும் import { useCoAgent } from "@copilotkit/react-core";

function ResearchCanvas() { const { state, setState } = useCoAgent({ name: "researchagent", initialState: { topic: "", outline: [], currentSection: null, }, });

return (

setState({ ...state, topic: e.target.value })} placeholder="ஆய்வு தலைப்பை உள்ளிடவும்" />

); }

மனித-இயந்திர ஒத்துழைப்பு (Human-in-the-Loop) எடுத்துக்காட்டு

import { useCopilotAction } from "@copilotkit/react-core";

function DocumentEditor() { useCopilotAction({ name: "publishDocument", description: "ஆவணத்தை வெளியிடுவதற்கு முன் பயனர் உறுதிப்படுத்த வேண்டும்", parameters: [ { name: "title", type: "string", description: "ஆவணத்தின் தலைப்பு" }, { name: "content", type: "string", description: "ஆவணத்தின் உள்ளடக்கம்" }, ], handler: async ({ title, content }) => { const confirmed = await new Promise((resolve) => { showConfirmDialog({ title, content, onConfirm: resolve }); });

if (confirmed) { await api.publish({ title, content }); return "ஆவணம் வெற்றிகரமாக வெளியிடப்பட்டது"; } return "வெளியீடு ரத்து செய்யப்பட்டது"; }, });

return ...; }`

வழக்கமான பயன்பாட்டு வழக்குகள்

வழக்கு 1: SaaS புத்திசாலி உதவியாளர்

நிலையம்: ஒரு நிறுவன அளவிலான திட்ட மேலாண்மை கருவி, பயனர்களுக்கு வேகமாக பணிகளை உருவாக்க, வளங்களை ஒதுக்க, அறிக்கைகளை உருவாக்க AI உதவியாளர் ஒருங்கிணைக்கிறது.

நிறைவேற்றுவதற்கான முக்கிய அம்சங்கள்:

• CopilotKit இன் பகிர்வு நிலை செயல்பாட்டைப் பயன்படுத்தி, AI தற்போதைய திட்டக் காட்சியை நேரத்தில் புரிந்து கொள்ள உதவுகிறது
• உருவாக்கும் UI மூலம் பணிக்கர்ட்கள், காந்த் வரைபடங்கள் போன்ற கூறுகளை இயக்கமாக உருவாக்குகிறது
• மனித-இயந்திர ஒத்துழைப்பு மையங்கள் முக்கிய செயல்பாடுகளை (எடுத்துக்காட்டாக, திட்டத்தை நீக்குதல்) பயனர் உறுதிப்படுத்த வேண்டும்.### 案例 2：AI 研究助手

场景：学术研究辅助工具，帮助研究人员收集资料、整理论文结构、协作写作。

实现要点：

• LangGraph 代理负责信息检索和逻辑推理
• CopilotKit 前端展示研究大纲、文献列表
• 状态同步确保研究进度实时保存和展示
• 审批节点在引用外部资料时提示用户确认

案例 3：智能表单填写

场景：将复杂的保险申请表转化为对话式交互。

实现要点：

• 代理根据用户回答动态决定下一个问题
• 使用条件渲染根据上下文显示不同 UI 组件
• 自动保存部分完成的表单，支持断点续填
• 在提交前汇总所有信息供用户确认

技术启示

CopilotKit 的技术实现基于现代 Web 栈。前端采用 React（也支持 Angular）作为主要 UI 框架，提供 useAgent 和 useCoAgent 等 hook 用于状态管理和代理交互。后端运行时 CopilotRuntime 类作为中央编排器，处理请求验证、LLM 调用和响应流式传输。通信协议采用 Server-Sent Events（SSE）实现服务端到客户端的实时流推送，同时通过 HTTP POST 处理客户端请求。

v1.50 版本带来了重大架构升级，引入了更清晰的单一端点架构、更好的可观测性（遥测内置）和与 CopilotKit Next 的深度集成，进一步简化了开发体验。

未来展望CopilotKit இன் உத்தி நிலைமை என்பது பிரதிநிதி பயன்பாட்டு மேம்பாட்டிற்கான அடிப்படைக் கட்டமைப்பாக மாறுவதற்காக உள்ளது. AG-UI ஒப்பந்தம் மேலும் பல நிறுவனங்களால் (Microsoft, Google, AWS போன்றவை) ஏற்கப்படுவதுடன், திறந்த தரநிலைகளின் அடிப்படையில் ஒரு பிரதிநிதி பயன்பாட்டு சூழல் உருவாகி வருகிறது. CopilotKit முன்னிருப்பான கூறுகள், உருவாக்கும் UI மாதிரிகள் மற்றும் ஆழமான கட்டமைப்பு ஒருங்கிணைப்புகளை வழங்குவதன் மூலம், உற்பத்தி தர AI Copilot உருவாக்குவதற்கான தடைகளை குறிப்பிடத்தக்க அளவுக்கு குறைத்துள்ளது, இதனால் மேம்படுத்துபவர்கள் அடிப்படைக் தொடர்பு விவரங்களைப் பற்றிய கவனத்தை தவிர்த்து, வணிக உளவியலுக்கு கவனம் செலுத்த முடிகிறது.