CopilotKit để xây dựng trợ lý AI ngay trong ứng dụng

CopilotKit dùng để làm gì? Giải thích dễ hiểu

CopilotKit là framework mã nguồn mở của Tawkit, Inc. giúp lập trình viên đưa trợ lý AI vào ứng dụng của mình. Nó nối tác tử với màn hình mà người dùng đang làm việc. Kết quả có thể là câu trả lời, biểu đồ hoặc một thao tác đã được nhóm phát triển cho phép.

Ví dụ, trong ứng dụng quản lý công việc, người dùng yêu cầu thêm một mục và nhìn thấy danh sách cập nhật. Nhóm phát triển vẫn phải cung cấp dữ liệu và các chức năng được phép. Đây là công cụ xây dựng sản phẩm SaaS, hệ thống nội bộ và ứng dụng di động, cần có quá trình tích hợp thực tế.

Bắt đầu với React và runtime

Hướng dẫn bắt đầu chính thức mô tả lộ trình React:

1. Chuẩn bị dự án, Node.js 20+ và khóa API của nhà cung cấp mô hình.
2. Cài @copilotkit/react-core cùng @copilotkit/runtime, cấu hình thông tin xác thực trên máy chủ và tạo endpoint runtime.
3. Nối Provider với runtime, nhập stylesheet và thêm thành phần chat hoặc thanh bên.
4. Kiểm tra hội thoại đơn giản, sau đó đăng ký một chức năng có kết quả dễ quan sát.
5. Xác nhận trạng thái ứng dụng thực sự thay đổi và xem sự kiện AG-UI trong Inspector cục bộ.

Nếu đã có tác tử, hãy dùng hướng dẫn tích hợp của framework đó. BuiltInAgent gọi mô hình trực tiếp, không tự nối vào logic sẵn có. SPA chỉ có frontend cần một máy chủ runtime riêng.

Đưa trợ lý AI vào quy trình của ứng dụng

Frontend tools gọi các hàm đã đăng ký trong trình duyệt, chẳng hạn mở một bản ghi, đổi bộ lọc hoặc cập nhật trạng thái màn hình. Ứng dụng vẫn chịu trách nhiệm kiểm tra quyền truy cập dữ liệu nghiệp vụ.

SDK chính thức hỗ trợ React, Angular, Vue và React Native. Bạn có thể dùng tác tử tích hợp hoặc kết nối LangGraph, Google ADK, Mastra, PydanticAI và những backend được hỗ trợ khác. AG-UI truyền thông tin giữa tác tử và giao diện; CopilotKit cung cấp thành phần và cơ chế tương tác. Channels cũng có hướng tích hợp Slack và Microsoft Teams.

Giao diện tạo sinh, trạng thái chung và xác nhận

Giao diện tạo sinh trình bày dữ liệu bằng thẻ, bảng hoặc biểu đồ thuộc hệ thống thiết kế của bạn. Với React, useComponent đăng ký thành phần hiển thị và tham số có kiểu dữ liệu; tác tử cung cấp dữ liệu để dựng giao diện. Hiển thị thành phần không đồng nghĩa với thực hiện giao dịch ở backend.

Trạng thái chung đồng bộ ứng dụng và tác tử. Cơ chế human-in-the-loop tạm dừng để nhận lựa chọn hoặc xác nhận của người dùng. Với phê duyệt bắt buộc, cần áp dụng điểm kiểm tra trong luồng thực thi, thay vì chỉ trông chờ mô hình tự quyết định hỏi.

Gói miễn phí, giá và giới hạn sử dụng

Theo bảng giá công khai bằng USD được kiểm tra ngày 18/10/2026, Developer miễn phí cho một lập trình viên, tối đa 200 luồng hội thoại, lưu ba ngày và 1 GB dữ liệu đa phương thức. Pro là 39 USD/tháng; Team là 100 USD/chỗ/tháng, tối đa năm chỗ. Lời mời chưa chấp nhận cũng chiếm chỗ. Enterprise có điều kiện riêng. Đây không phải báo giá bằng đồng Việt Nam hay tổng tiền đã xác định thuế.

Intelligence bổ sung hội thoại bền vững và bộ nhớ người dùng. Bảng hiện tại ghi Analytics và Self-Learning là quyền truy cập sớm của Enterprise. Hãy tính riêng mô hình và hạ tầng, đồng thời kiểm tra các gói hiện hành.

Tự lưu trữ, giấy phép và dữ liệu

Mã nguồn chính thức dùng giấy phép MIT, cho phép sử dụng thương mại khi tuân thủ điều kiện và giữ thông báo cần thiết. Dịch vụ quản lý có điều khoản riêng. Tự lưu trữ runtime trong Developer/Pro khác với triển khai toàn bộ nền tảng.

Chạy runtime trên máy chủ riêng không tự ngăn dữ liệu gửi tới mô hình bên ngoài. Chính sách quyền riêng tư phân biệt dữ liệu website với xử lý theo thỏa thuận khách hàng. Tài liệu telemetry cho biết telemetry mã nguồn mở thu siêu dữ liệu, không thu prompt, tin nhắn, trạng thái hay nội dung công cụ, và có thể tắt. Điều này không phải cam kết cho mọi dịch vụ kết nối.

Câu hỏi thường gặp

CopilotKit có miễn phí không?

SDK là mã nguồn mở và Developer có hạn mức miễn phí. Mô hình, máy chủ và tính năng bổ sung vẫn có thể phát sinh phí.

Có thể kết nối tác tử LangGraph sẵn có không?

Có. Hãy theo cấu hình LangGraph để giữ logic tác tử hiện tại, không thay nhầm bằng BuiltInAgent.

Có thể tự lưu trữ CopilotKit không?

Có, nhưng cần phân biệt runtime với toàn bộ nền tảng và kiểm tra điều kiện gói, cơ sở dữ liệu cùng kết nối mô hình ngoài.

Tài liệu chính thức và cộng đồng

• Tài liệu chính thức: chọn frontend và backend.
• Kho GitHub: mã nguồn, giấy phép và vấn đề đã ghi nhận.
• Discord chính thức: trao đổi về triển khai.