Mục lụcChạm để xem nhanh các phần+
- Onyx phát hành bản 5.0.0 ngày 24/10/2026, đưa máy chủ MCP, công cụ OpenAPI và Craft Apps về cùng trang Plugins. Với doanh nghiệp đang kết nối trợ lý AI vào tài liệu và hệ thống nội bộ, thay đổi đáng chú ý là quyền sử dụng công cụ, cách xác thực và các bước nâng cấp đều cần được rà lại.
- Trang Plugins gom ba loại tích hợp trước đây nằm rải rác. MCP là giao thức để trợ lý gọi công cụ; OpenAPI mô tả các thao tác của dịch vụ qua API; Craft Apps là nhóm ứng dụng tích hợp trong Onyx. Cấu hình và thông tin xác thực hiện có được giữ lại, các đường dẫn cũ được chuyển hướng.
Onyx 5.0 đổi cách quản lý công cụ cho trợ lý AI
Onyx phát hành bản 5.0.0 ngày 24/10/2026, đưa máy chủ MCP, công cụ OpenAPI và Craft Apps về cùng trang Plugins. Với doanh nghiệp đang kết nối trợ lý AI vào tài liệu và hệ thống nội bộ, thay đổi đáng chú ý là quyền sử dụng công cụ, cách xác thực và các bước nâng cấp đều cần được rà lại.
Ghi chú phiên bản trên trang tài liệu mang ngày 23/10; bản phát hành GitHub được công bố lúc 06:46 UTC ngày 24/10. Đây là đợt phát hành nền tảng mới, không chỉ đổi tên một trang cài đặt. Đơn vị tự vận hành Onyx nên thử trên bản sao trước khi đưa vào hệ thống đang phục vụ nhân viên.
Một nơi quản lý kết nối, nhưng vẫn có nhiều lớp quyền
Trang Plugins gom ba loại tích hợp trước đây nằm rải rác. MCP là giao thức để trợ lý gọi công cụ; OpenAPI mô tả các thao tác của dịch vụ qua API; Craft Apps là nhóm ứng dụng tích hợp trong Onyx. Cấu hình và thông tin xác thực hiện có được giữ lại, các đường dẫn cũ được chuyển hướng.
Quản trị viên quyết định khả năng truy cập và trạng thái mặc định của plugin trong Chat, Craft. Từng người dùng vẫn phải kết nối tài khoản của mình khi công cụ yêu cầu. Việc nhìn thấy một plugin trong danh sách không đồng nghĩa mọi nhân viên được dùng mọi thao tác của plugin đó.
Onyx cũng kiểm tra xác thực và nhận diện công cụ trước khi lưu cấu hình MCP. Theo tài liệu phiên bản, lỗi thiết lập mới không được ghi đè lên kết nối đang hoạt động. Friday Works khuyến nghị kiểm tra riêng công cụ chỉ đọc và công cụ có thể ghi dữ liệu, thay vì thử một câu hỏi rồi coi toàn bộ tích hợp đã đạt.
Các thay đổi bảo mật cần xử lý ngay khi nâng cấp
Bản 5.0 sửa việc đổi hoặc đặt lại mật khẩu vẫn để phiên đăng nhập cũ tồn tại. Đặt lại mật khẩu nay đăng xuất mọi phiên; đổi mật khẩu đăng xuất các phiên khác. Cả hai thao tác thu hồi token truy cập cá nhân, nên các tác vụ dùng token của nhân viên có thể cần cấp lại. Khóa API của tài khoản dịch vụ không bị ảnh hưởng; phiên dùng cơ chế JWT không trạng thái có giới hạn thu hồi riêng.
Công cụ OpenAPI tùy chỉnh nay chịu chính sách kiểm tra đích kết nối: không theo chuyển hướng, có thời gian chờ và luôn chặn địa chỉ link-local, địa chỉ metadata cloud. Mạng riêng trên bản tự vận hành vẫn có thể được truy cập; doanh nghiệp cần giới hạn kết nối ra ngoài ở lớp mạng nếu muốn ngăn trợ lý chạm tới dịch vụ nội bộ ngoài phạm vi cho phép.
Ghi chú phát hành còn nêu bản sửa lỗi chèn mã qua ảnh đại diện agent có thể kết hợp với đánh cắp token phiên. Các nguồn này không xác nhận một chiến dịch khai thác Onyx đang diễn ra. Đội vận hành cần phân biệt bản sửa được công bố với bằng chứng doanh nghiệp đã bị tấn công.

Nâng cấp còn liên quan kho tệp và quyền Enterprise
Onyx chuyển kho lưu tệp đi kèm từ MinIO sang SeaweedFS. Tệp đính kèm, tài liệu tải lên và dữ liệu làm việc của Craft cần được chuyển đầy đủ; chỉ sao lưu cơ sở dữ liệu là chưa đủ. Theo nhà phát triển, giai đoạn chuyển tiếp dùng hai kho song song và có cơ chế đọc dự phòng. Hệ thống đã dùng kho S3, GCS hoặc Azure bên ngoài không chịu thay đổi kho đi kèm này.
Các tính năng Enterprise nay phụ thuộc giấy phép, thay vì cờ cấu hình cũ. Một hệ thống trước đây bật tính năng trả phí khi tắt kiểm tra giấy phép có thể trở về Community Edition. Việc quay về phiên bản cũ cũng cần hạ cấu trúc cơ sở dữ liệu đúng trình tự; một số dữ liệu chỉ có ở 5.0 sẽ bị xóa khi hạ cấu trúc. Không nên thử hoàn tác trực tiếp trên dữ liệu thật.
Doanh nghiệp nên kiểm tra điều gì trước khi mở rộng?
Friday Works đề xuất thử với một nhóm nhỏ: sao lưu và thử khôi phục tệp cùng cơ sở dữ liệu; kiểm tra giấy phép; đối chiếu plugin được bật mặc định; thử tài khoản quản trị và tài khoản thường; kiểm tra token sau thao tác đặt lại mật khẩu; xác nhận công cụ ghi dữ liệu luôn đi qua cơ chế phê duyệt đã chọn.
Một ví dụ là trợ lý hỗ trợ khách hàng vừa tra tài liệu, vừa tạo phiếu xử lý. Doanh nghiệp nên đo riêng khả năng đọc đúng nguồn và khả năng chỉ tạo phiếu sau khi người có quyền chấp thuận. Đây là bài kiểm tra được đề xuất, chưa phải kết quả triển khai hay bằng chứng tiết kiệm chi phí của Friday Works.
Nguồn ảnh và bước tiếp theo
Ảnh bìa là trang Plugins và ảnh trong thân là phần phê duyệt công cụ của hệ thống Onyx 5.0. Hai ảnh được bổ sung trong commit tài liệu ngày 21/10 dành riêng cho hệ thống plugin 5.0; các thành phần được đối chiếu với mã nguồn v5.0.0. DeepWiki, Slack và Support Tickets là dữ liệu mẫu của nhà cung cấp. Friday Works truy xuất ngày 25/10, giữ nguyên nhãn và giá trị, chỉ cắt khung và thu nhỏ; nguồn cố định theo commit và giấy phép MIT được ghi dưới đây.
Doanh nghiệp cần triển khai trợ lý có kiểm soát quyền có thể trao đổi với Friday Works về phạm vi dữ liệu, công cụ được phép gọi và tiêu chí kiểm thử trước khi mở rộng.
Nguồn tham khảo
Tài liệu đã dùng để biên soạn
Ưu tiên tài liệu chính thức và nguồn kỹ thuật gốc. Truy cập để kiểm tra chi tiết hoặc theo dõi cập nhật mới nhất.
- Onyx 5.0.0 release — published 2026-10-24 06:46 UTCOnyx ↗︎
- Onyx release notes — documentation dated 2026-10-23Onyx ↗︎
- Plugins: workspace controls and account accessOnyx ↗︎
- OpenAPI security policy and configurationOnyx ↗︎
- Object store migration and rollback requirementsOnyx ↗︎
- Cover: actual Plugins directory, focused crop showing sample DeepWiki/Slack; retrieved 2026-10-25; crop x650 y70 1050×850, resize 716×580, neutral square framing, no UI edits; version evidence: October 21 documentation commit for unified Onyx 5.0 plugin system, matches source tagv5.0.0Onyx documentation contributors ↗︎
- Inline: MCP tool approvals; official sample UI; cropped dialog, proportional resize and framing, no value edits; version evidence: October 21 documentation commit for unified Onyx 5.0 plugin system, matches source tagv5.0.0Onyx documentation contributors ↗︎
- Image reuse: MIT License, Copyright (c) 2023 Yuhong Sun, Chris Weaver; full permission and warranty noticeOnyx documentation ↗︎
