Bạn muốn dùng mô hình AI riêng để lập trình mà không cần thiết lập phức tạp? Droid hỗ trợ API bên ngoài trong CLI, giúp bạn dễ dàng kết nối một mô hình tùy chỉnh phù hợp với quy trình làm việc. Hướng dẫn này sẽ chỉ bạn cách thiết lập API, khắc phục các sự cố thường gặp và sử dụng Kimi trong Droid. Hãy đọc tiếp để bắt đầu.
Droid là gì?
Droid là công cụ lập trình AI giúp nhà phát triển viết mã, xử lý lỗi và thực hiện các tác vụ phát triển hiệu quả hơn. Công cụ này hỗ trợ mô hình AI tích hợp, đồng thời cho phép người dùng kết nối mô hình tùy chỉnh qua CLI để linh hoạt hơn. Nhờ đó, Droid phù hợp với nhiều quy trình lập trình khác nhau, dù bạn cần hỗ trợ nhanh hay một thiết lập cá nhân hóa hơn.
Cách sử dụng mô hình AI tích hợp trong Droid?
Mô hình AI tích hợp giúp bạn dễ dàng bắt đầu lập trình với Droid vì không cần kết nối với bất kỳ API bên ngoài nào trước đó. Sau khi cài đặt ứng dụng, bạn có thể chọn một mô hình ngay trong nền tảng và bắt đầu dùng AI để phân tích mã nguồn, phát triển tính năng, sửa lỗi và đánh giá mã. Sau đây là cách bắt đầu với Droid:
Bước 1: Cài đặt và mở Droid
Trước tiên, hãy tải ứng dụng Factory về thiết bị và hoàn tất cài đặt. Sau đó, mở ứng dụng và đăng nhập vào tài khoản của bạn. Việc này cho phép bạn truy cập Droid và các tính năng AI tích hợp của nó trong ứng dụng.
Bước 2: Kết nối Droid với thư mục dự án
Đặt thư mục làm việc là cơ sở mã mà bạn muốn làm việc. Thao tác này liên kết Droid với dự án cục bộ để công cụ có thể đọc tệp, hiểu cấu trúc mã và hỗ trợ các tác vụ phát triển của bạn với ngữ cảnh tốt hơn.
Bước 3: Chọn mô hình tích hợp và bắt đầu nhập prompt
Mở trình chọn mô hình và chọn một trong các mô hình AI tích hợp có trong Droid. Sau khi chọn mô hình, bạn có thể bắt đầu đưa ra prompt, chẳng hạn yêu cầu mô hình phân tích cơ sở mã, sửa lỗi, đánh giá mã hoặc xây dựng tính năng.
Cách kết nối Droid với API bên ngoài?
Kết nối Droid với API bên ngoài giúp bạn tự do hơn khi sử dụng mô hình mình muốn thay vì chỉ giới hạn ở các tùy chọn tích hợp. Việc thiết lập được thực hiện trong Droid CLI bằng cách thêm mô hình tùy chỉnh vào tệp cài đặt; sau khi lưu, mô hình sẽ xuất hiện trong menu /model. Các bước dưới đây dùng Kimi làm ví dụ đơn giản để bạn thấy toàn bộ quy trình thiết lập, từ khóa API đến chọn mô hình:
Bước 1: Lấy khóa Kimi API từ Moonshot AI
Trước tiên, hãy tạo hoặc sao chép khóa Kimi API của bạn từ Moonshot AI. Bạn sẽ cần khóa này vì Droid dùng nó để kết nối với Kimi API và gửi yêu cầu qua tài khoản của chính bạn. Tốt nhất nên lưu khóa dưới dạng biến môi trường, chẳng hạn MOONSHOT_API_KEY, để có thể sử dụng an toàn trong tệp cài đặt.
Bước 2: Mở tệp cài đặt Droid
Tiếp theo, mở tệp cài đặt nơi thêm các mô hình tùy chỉnh trong Droid CLI. Trên macOS, đường dẫn tệp là ~/.factory/settings.json. Trên Windows PowerShell, dùng %USERPROFILE%\.factory\settings.json. Đây là tệp chính mà Droid đọc cấu hình mô hình tùy chỉnh của bạn.
Bước 3: Thêm Kimi làm mô hình tùy chỉnh
Trong settings.json, thêm Kimi vào mảng customModels. Thao tác này cho Droid biết cần dùng mô hình nào, gọi điểm cuối API nào, tuân theo định dạng nhà cung cấp nào và dùng khóa API nào để xác thực. Nếu tệp đã có các cài đặt khác, đừng thay thế toàn bộ; chỉ cần thêm đối tượng mô hình này vào mảng customModels hiện có.
Bước 4: Lưu tệp và khởi động lại Droid
Sau khi thêm cấu hình, hãy lưu tệp và khởi động lại Droid CLI. Việc này đảm bảo Droid tải lại các cài đặt đã cập nhật và nhận diện đúng mô hình tùy chỉnh mới thêm.
Bước 5: Chọn mô hình Kimi bằng /model trong Droid
Mở Droid CLI và chạy lệnh /model. Cấu hình Kimi của bạn giờ sẽ xuất hiện trong mục Custom models. Chọn cấu hình đó trong danh sách để đặt Kimi làm mô hình đang hoạt động cho phiên lập trình của bạn.
Bước 6: Chạy một tác vụ
Sau khi chọn Kimi, bạn có thể bắt đầu dùng mô hình này cho công việc thực tế trong Droid. Hãy thử một prompt như rà soát mã, sửa lỗi hoặc giải thích một codebase. Droid sẽ gửi yêu cầu qua Kimi API và dùng mô hình đó cho tác vụ.
Lợi ích khi sử dụng Kimi API
Sau khi kết nối Kimi với Droid, đây không còn chỉ là một mô hình bên ngoài trong CLI. Kimi trở thành trợ lý lập trình thiết thực, phù hợp với quy trình phát triển hằng ngày và hỗ trợ cả những việc lập trình nhỏ lẫn các tác vụ kỹ thuật lớn hơn. Dưới đây là một số lợi ích khi sử dụng Kimi API:
Nâng cao hiệu quả phát triển
Kimi có thể giúp bạn xử lý các tác vụ lập trình hằng ngày nhanh hơn bằng cách tạo mã, giải thích logic và gợi ý cách khắc phục khi bạn làm việc. Nhờ đó, bạn không cần chuyển đổi giữa nhiều công cụ chỉ để nhận hỗ trợ phát triển đơn giản. Với Kimi trong Droid, các công việc lập trình thường lệ sẽ nhanh và dễ quản lý hơn.
Viết mã đáng tin cậy hơn
Kimi có thể rà soát mã, chỉ ra các vấn đề tiềm ẩn và giúp cải thiện cấu trúc trước khi những sai sót nhỏ trở thành vấn đề lớn hơn. Loại phản hồi sớm này hữu ích khi bạn muốn có logic rõ ràng hơn và khả năng bảo trì tốt hơn. Theo thời gian, điều này có thể giúp bạn xây dựng mã dễ kiểm thử, cập nhật và hiểu hơn.
Xử lý đa dạng tác vụ phát triển
Kimi không chỉ giới hạn ở việc viết mã từ đầu. Mô hình này còn có thể hỗ trợ tái cấu trúc mã, viết tài liệu cho mã, tìm hiểu các dự án chưa quen thuộc và hỗ trợ phát triển tính năng trong nhiều tác vụ khác nhau. Điều này khiến Kimi trở thành lựa chọn linh hoạt cho các nhà phát triển muốn dùng một mô hình AI hỗ trợ nhiều phần của quy trình làm việc.
Khắc phục các lỗi thường gặp khi kết nối API
Việc kết nối khóa API bên ngoài trong Droid thường khá đơn giản, nhưng những lỗi nhỏ khi thiết lập vẫn có thể gây sự cố. Phần lớn vấn đề xuất phát từ tệp cài đặt, tên nhà cung cấp, khóa API hoặc cấu hình máy chủ mô hình, thay vì từ chính Droid. Điểm tích cực là các lỗi này thường dễ khắc phục khi bạn biết cần kiểm tra ở đâu.
Mô hình không xuất hiện trong bộ chọn
Kiểm tra cú pháp JSON trong
~/.factory/settings.jsonhoặcconfig.jsonnếu bạn đang dùng định dạng cũCác thay đổi cài đặt được phát hiện tự động thông qua việc theo dõi tệp
Xác minh rằng cấu hình mô hình tùy chỉnh có đầy đủ mọi trường bắt buộc
Lỗi "Invalid provider"
Đảm bảo giá trị nhà cung cấp chính xác là
anthropic,openaihoặcgeneric-chat-completion-apiKiểm tra lỗi chính tả và cách viết hoa chính xác trong trường nhà cung cấp
Lỗi xác thực
Kiểm tra API key của bạn hợp lệ và còn tín dụng khả dụng
Kiểm tra API key có đúng quyền cần thiết cho nhà cung cấp hay không
Xác nhận URL cơ sở khớp với điểm cuối API trong tài liệu của nhà cung cấp
Không thể kết nối mô hình cục bộ
Đảm bảo máy chủ mô hình cục bộ của bạn đang chạy, chẳng hạn như
ollama serveKiểm tra URL cơ sở có chính xác và bao gồm
/v1/nếu nhà cung cấp yêu cầuKiểm tra mô hình đã được tải về hoặc có sẵn trên máy cục bộ
Lỗi giới hạn tốc độ hoặc hạn ngạch
Kiểm tra giới hạn tốc độ API và hạn ngạch sử dụng của nhà cung cấp
Theo dõi mức sử dụng trên bảng điều khiển của nhà cung cấp để xem liệu đã chạm giới hạn hay chưa
Kết luận
Việc sử dụng API tùy chỉnh trong Droid giúp bạn kiểm soát tốt hơn cách xây dựng, kiểm thử và cải thiện mã bằng AI. Khi hoàn tất thiết lập, bạn sẽ dễ dàng điều chỉnh quy trình lập trình xoay quanh mô hình phù hợp với nhu cầu của mình. Dù tiếp tục dùng các lựa chọn tích hợp sẵn hay kết nối một mô hình bên ngoài, Droid vẫn mang đến cách linh hoạt để đưa AI vào phát triển phần mềm. Nếu muốn bắt đầu đơn giản với một thiết lập tùy chỉnh, Kimi là lựa chọn đáng thử trong Droid. Đây có thể là lựa chọn thực tế giúp công việc lập trình hằng ngày diễn ra mượt mà và nhanh hơn.