Channels SDK: Giải pháp mã nguồn mở kết nối nhân viên hỗ trợ với mọi nền tảng chat

Đưa bất kỳ AI agent nào vào Slack, Microsoft Teams và các kênh làm việc của bạn — với giao diện người dùng (UI) tương tác nguyên bản.

Trải nghiệm Channels · Xây dựng với SDK · Khám phá OpenTag

Agent của bạn vẫn giữ nguyên các công cụ, mô hình và logic nghiệp vụ. Channels cung cấp cho nó một không gian làm việc nguyên bản để tương tác với con người.

Agent của bạn thuộc về nơi công việc diễn ra

Channels kết nối một agent tương thích với AG-UI vào các nền tảng giao tiếp mà nhóm của bạn đang sử dụng. Agent có thể hiểu cuộc trò chuyện, truyền phát phản hồi, gọi công cụ, làm việc với tệp tin, hiển thị UI tương tác và tạm dừng để chờ con người phê duyệt.

Một tương tác, nguyên bản trên mọi kênh

Channels được xây dựng cho một thế giới nơi cùng một agent có thể gặp gỡ người dùng trên mọi nền tảng giao tiếp. Các kết nối được quản lý cho Slack và Microsoft Teams hiện đã có sẵn thông qua CopilotKit Intelligence, với nhiều kênh khác đang được triển khai.

Thử nghiệm trước khi xây dựng

Trải nghiệm một agent Channels thực tế trong Slack hoặc Microsoft Teams mà không cần cấu hình ứng dụng, runtime hay thông tin xác thực của nhà cung cấp.

Thử Channels →

Chọn một nền tảng, tham gia trải nghiệm và xem cách một agent xử lý ngữ cảnh, sử dụng công cụ và UI kênh nguyên bản.

Xây dựng Channel đầu tiên của bạn

Agent và logic ứng dụng của bạn chạy trên cơ sở hạ tầng của chính bạn. CopilotKit Intelligence quản lý kết nối nền tảng và chuyển từng lượt tương tác đến quy trình Channels đang chạy của bạn.

Con đường nhanh nhất: để coding agent của bạn thực hiện

Việc xây dựng một agent Channels bao gồm một dự án, một agent, một Channel được quản lý, một ứng dụng nhà cung cấp và một runtime chạy dài hạn. Một hướng dẫn sẽ giúp agent của bạn thực hiện tất cả các bước này.

Thao tác đó sẽ cài đặt kỹ năng channels-setup, in ra một câu lệnh và sao chép nó vào clipboard của bạn. Hãy dán nó vào coding agent của bạn.

Kỹ năng này đóng vai trò như một con trỏ — nó lấy quy trình làm việc từ copilotkit.ai/channels-guide.md khi agent của bạn cần, vì vậy các bước luôn được cập nhật ngay cả khi kỹ năng đã được cài đặt từ nhiều tháng trước. Hướng dẫn sẽ hỏi bạn muốn chọn nền tảng nào (Slack hoặc Microsoft Teams) và framework agent nào.

Agent của bạn sẽ tự điều khiển bảng điều khiển Slack và Intelligence trong phiên đăng nhập của chính bạn. Nếu nó chưa có công cụ trình duyệt hoặc công cụ điều khiển máy tính, nó sẽ yêu cầu bạn thêm vào trước — đó là lộ trình dự kiến, không phải phương án thay thế. Bạn nhập các thông tin bảo mật; còn việc nhấp chuột là do nó thực hiện.

Bỏ qua hướng dẫn được lưu trữ và đưa quy trình làm việc của Slack trực tiếp vào coding agent mà bạn đang chạy:

-y cài đặt kỹ năng đó mà không cần mở trình chọn. Kỹ năng này được giới hạn cho Slack — đối với Microsoft Teams, hãy sử dụng hướng dẫn ở trên.

CLI bao quát phía Intelligence: copilotkit channels add --adapter slack khai báo Channel và đính kèm adapter, còn copilotkit channels status so sánh cấu hình, mã nguồn và máy chủ của bạn. Những gì nằm trong trình duyệt là phía nhà cung cấp — tạo ứng dụng Slack và cài đặt nó vào workspace — cộng với việc cấp khóa API dự án. Không có cờ CLI nào chấp nhận giá trị thông tin xác thực, vì vậy mã thông báo bot (bot token) và mã bí mật (signing secret) vẫn nằm trong tệp.env của bạn và do bạn quản lý.

Tùy chọn '--skill' không xác định? Một phiên bản copilotkit cũ hơn — được cài đặt toàn cục hoặc còn sót lại trong bộ nhớ đệm npx — đang ghi đè lên CLI hiện tại. Hãy giữ @latest; đó là yếu tố buộc npx phải lấy phiên bản hiện tại thay vì sử dụng lại phiên bản đã có.

Các bước dưới đây là cùng một lộ trình, được thực hiện thủ công.

1. Cấu hình kết nối

Tạo một Channel trong CopilotKit Intelligence và kết nối với Slack. Hãy giữ lại Mã Channel (Channel Code) và khóa API Intelligence theo phạm vi dự án cho các bước tiếp theo.

Bạn cần Node.js 22 trở lên và một quy trình Node hoặc container chạy dài hạn.

2. Cài đặt SDK

Channels và Runtime được phát hành cùng nhau như một cặp đã được kiểm thử. Hãy nâng cấp cả hai gói cùng lúc.

3. Tạo trình lắng nghe (listener)

Ví dụ dưới đây sử dụng agent tích hợp sẵn của CopilotKit. Bạn có thể thay thế makeAgent bằng bất kỳ factory agent nào tương thích với AG-UI mà không cần thay đổi vòng đời của Channel.

4. Khởi chạy

Khi Intelligence báo trạng thái Online, hãy mời ứng dụng vào một kênh Slack và nhắc đến nó. Agent của bạn giờ đây sẽ nhận cuộc trò chuyện và phản hồi trong luồng (thread).

Bạn muốn sử dụng Microsoft Teams, một framework agent khác, phê duyệt tương tác, tệp tin hay hướng dẫn triển khai thực tế? Hãy tiếp tục trong tài liệu về Channels.

Muốn agent của bạn tự làm việc đó? Hãy chạy npx copilotkit@latest channels setup từ phần Con đường nhanh nhất ở trên. Hướng dẫn đó bao gồm cùng một thiết lập này cộng với các bước xác thực và nhà cung cấp.

Cách thức hoạt động

Mỗi lượt tương tác đều tuân theo cùng một lộ trình:

SDK là mã nguồn mở và được cấp phép theo giấy phép MIT. CopilotKit Intelligence có thể được lưu trữ bởi CopilotKit hoặc tự lưu trữ cho các triển khai doanh nghiệp.