打造专属 AI 中台，WorkBuddy 接入 B.AI 模型全图解教程

Trong môi trường phát triển nhanh chóng hiện nay, WorkBuddy với khả năng điều phối luồng công việc linh hoạt và tích hợp hệ thống mạnh mẽ đã trở thành "trung tâm năng suất" không thể thiếu trên máy tính của nhiều nhà phát triển. Nó không chỉ có thể tổng hợp các công cụ phát triển phân tán, mà còn đóng vai trò như một nền tảng thông minh chuyên dụng, cho phép nhà phát triển gọi trực tiếp các năng lực AI hàng đầu trong môi trường đắm chìm mà không cần chuyển đổi ngữ cảnh, từ đó loại bỏ đáng kể ma sát thực thi trong các tác vụ hàng ngày, đưa sự tập trung cốt lõi trở lại vào việc tư duy và sáng tạo có giá trị cao.

Để giúp đông đảo nhà phát triển đưa ma trận mô hình hiệu suất cao và cơ sở hạ tầng cấp hệ thống của B.AI vào luồng công việc phát triển hàng ngày một cách hiệu quả hơn, bài viết này sẽ hướng dẫn chi tiết cách thêm mô hình tùy chỉnh B.AI trên máy tính WorkBuddy. Trước khi cấu hình, vui lòng chuẩn bị tài khoản WorkBuddy, B.AI API Key, và ID mô hình thực sự khả dụng cho tài khoản hiện tại. Tiếp theo, chỉ cần làm theo cấu hình đơn giản trong bài viết này, bạn có thể mở khóa trải nghiệm cộng tác AI mượt mà tối đa ngay tại máy cục bộ.

I. Trước khi bắt đầu

Bước 1: Cài đặt WorkBuddy

Truy cập trang tải xuống chính thức của WorkBuddy, chọn gói cài đặt phù hợp với môi trường hệ thống của bạn. Người dùng đã cài đặt WorkBuddy có thể bỏ qua bước này. Nếu không tìm thấy tùy chọn "Mô hình" hoặc "Thêm mô hình", trước tiên hãy chọn "Kiểm tra cập nhật" để nâng cấp phiên bản.

Windows

Trang chính thức hiện cung cấp gói cài đặt Windows x64 (tương thích ARM64), yêu cầu Windows 10 trở lên. Sau khi tải xuống trình cài đặt, nhấp đúp và làm theo hướng dẫn để hoàn tất cài đặt, sau đó khởi động WorkBuddy.

Lưu ý: Nếu hệ thống ngăn chặn cài đặt, trước tiên hãy xác nhận gói cài đặt đến từ trang chính thức, sau đó kiểm tra tên ứng dụng và thông tin nhà phát hành trong cửa sổ bật lên. Không bỏ qua kiểm tra bằng cách tắt bảo vệ an ninh Windows.

macOS

Trang chính thức hiện cung cấp riêng phiên bản chip Apple và phiên bản Intel dưới dạng .dmg, yêu cầu macOS 12.0 trở lên.

• Các dòng máy M1, M2, M3, M4 chọn phiên bản chip Apple.
• Các dòng máy dùng bộ xử lý Intel chọn phiên bản Intel.

Sau khi mở .dmg, kéo WorkBuddy vào "Ứng dụng", sau đó khởi động từ thư mục Ứng dụng. Nếu không chắc chắn về loại chip, có thể xem "Chip" hoặc "Bộ xử lý" trong "Giới thiệu về máy này".

Lưu ý về các hệ thống khác

Hiện tại WorkBuddy trên máy tính chỉ hỗ trợ Windows và macOS, chưa hỗ trợ Linux. Đồng thời, xét đến phạm vi tính năng khác nhau giữa thiết bị di động và HarmonyOS, mọi thao tác trong hướng dẫn này đều lấy máy tính làm chuẩn.

Bước 2: Đăng nhập WorkBuddy

Khi khởi động lần đầu, nhấp vào "Đăng nhập", hoàn tất xác thực theo cách hiển thị trên ứng dụng khách. Tài liệu chính thức phiên bản quốc tế liệt kê Google và GitHub OAuth. Nếu ứng dụng khách hiện tại hiển thị quét mã WeChat hoặc lối vào khác, hãy lấy tùy chọn thực tế trên ứng dụng khách làm chuẩn.

Bước 3: Lấy B.AI API Key

Trước tiên hãy đăng nhập B.AI, vào trang Quản lý API hoặc Quản lý API Key trong thanh điều hướng bên trái, nhấp vào "Tạo API Key" và đặt cho nó một tên dễ nhận biết (ví dụ: WorkBuddy). Do giới hạn cơ chế chính thức của B.AI, Key đầy đủ chỉ hiển thị một lần khi tạo thành công, vì vậy hãy nhớ sao chép và lưu trữ cẩn thận ngay sau khi tạo.

Những điều quan trọng cần xác nhận trước khi cấu hình:

• Kiểm tra trước: Trước khi cấu hình, hãy xác nhận tài khoản có hạn mức khả dụng, và API Key đó có quyền gọi mô hình mục tiêu.
• Lấy ID mô hình: ID mô hình phải dựa trên kết quả trả về của B.AI GET /v1/models hoặc danh sách bảng điều khiển hiện tại, không thể chỉ tham khảo tên ví dụ trong các hướng dẫn khác.
• Tương thích giao thức: Mô hình tùy chỉnh của WorkBuddy sử dụng giao thức OpenAI Chat Completions, do đó mô hình mục tiêu cũng phải mở cho endpoint này. Cấu hình chỉ hỗ trợ Anthropic Messages hoặc OpenAI Responses không thể điền trực tiếp.

Lưu ý: Không để lộ Key đầy đủ trong bài viết, ảnh chụp màn hình, lịch sử trò chuyện hoặc kho công khai. Nếu nghi ngờ Key đã bị rò rỉ, hãy xóa Key cũ ngay lập tức, tạo Key mới, và cập nhật cấu hình WorkBuddy.

II. Cấu hình B.AI API qua giao diện

Bước 1: Mở cấu hình mô hình tùy chỉnh

Mở WorkBuddy, nhấp vào ảnh đại diện tài khoản ở góc dưới bên trái, chọn "Cài đặt".

Chọn "Mô hình" ở bên trái, nhấp vào "Thêm mô hình".

Nếu trong danh sách hiện tại đã có mô hình tùy chỉnh khác, hãy đảm bảo nhấp vào "Thêm mô hình" để thêm cấu hình mới, tuyệt đối không ghi đè trực tiếp tham số của mô hình không liên quan. Nếu bạn cần sửa đổi mô hình B.AI hiện có, chỉ cần nhấp vào biểu tượng bút chì bên cạnh mô hình đó. Nếu bạn muốn giữ lại mô hình cũ trong khi sửa đổi, thì nên thêm một cấu hình mới như một mô hình hoàn toàn mới.

Bước 2: Điền tham số kết nối

Chọn "Tùy chỉnh" trong danh sách thả xuống "Nhà cung cấp", điền thông tin liên quan vào trang hiện ra.

Hướng dẫn điền như sau:

URL và "Giao thức tùy chỉnh" phải được thiết lập theo cặp:

Theo tài liệu chính thức của WorkBuddy, khi "Giao thức tùy chỉnh" tắt, ứng dụng khách sẽ tự động thêm đường dẫn /chat/completions vào cuối URL đã điền theo quy tắc OpenAI Chat Completions tiêu chuẩn; khi công tắc này bật, ứng dụng khách sẽ gửi yêu cầu trực tiếp đến URL đầy đủ mà bạn đã điền, không thực hiện bất kỳ nối đường dẫn nào nữa. Lưu ý không trộn lẫn hai cách này. Khi nối lặp thành /v1/chat/completions/chat/completions, thường sẽ trả về 404.

Bước 3: Thiết lập năng lực mô hình

Các công tắc trong "Cài đặt nâng cao" chỉ dùng để khai báo năng lực mô hình, sau khi tích chọn sẽ không khiến mô hình vốn không hỗ trợ tự động có được năng lực. Hãy cấu hình theo tình hình thực tế, tham khảo các nguyên tắc sau:

Khi không thể xác nhận giới hạn đầu vào, đầu ra, hãy giữ "Sử dụng giá trị mặc định của nhà cung cấp". Khi chưa được xác nhận qua tài liệu hoặc thử nghiệm thực tế, không bật tất cả năng lực theo mặc định.

Bước 4: Lưu cấu hình

Sau khi kiểm tra URL, API Key và ID mô hình, nhấp vào "Lưu". Mô hình mới sẽ xuất hiện trong danh sách "Mô hình đã lưu".

Nếu không hiển thị, lần lượt kiểm tra xem cửa sổ lưu có còn mở không, trường có báo lỗi không, bộ chọn mô hình có làm mới không và phiên bản ứng dụng khách. Khi cần thiết, hãy thoát hoàn toàn WorkBuddy rồi khởi động lại. Mô hình xuất hiện trong danh sách chỉ có nghĩa là cấu hình đã được lưu, không chứng minh cuộc gọi B.AI đã thành công, vẫn cần thực hiện xác minh tiếp theo.

III. Chọn mô hình và xác minh cấu hình

Bước 1: Chọn mô hình tùy chỉnh B.AI

Quay lại "Tạo tác vụ mới", mở bộ chọn mô hình gần hộp nhập liệu, chọn mô hình vừa thêm trong nhóm mô hình tùy chỉnh. Trong thời gian kiểm thử, không chọn chế độ "Auto", chế độ "Auto" có thể điều phối mô hình khác, không thể chứng minh yêu cầu lần này đã sử dụng B.AI.

Bước 2: Xác minh hội thoại thông thường

Gửi một câu hỏi đơn giản không phụ thuộc vào công cụ:

Vui lòng chỉ trả lời: Kiểm tra hội thoại