Jan Agent

Một dòng `jan config set --base-url https://api.kunavo.com/v1` ghi Kunavo vào ~/.jan/config.toml, và CLI xem trước Jan Agent — không đi kèm engine suy luận — chạy bằng key đó.

# Jan Agent is a preview on a nightly channel — check your build first.
jan --version

jan config set \
  --provider kunavo \
  --api-key sk-kn-... \
  --base-url https://api.kunavo.com/v1 \
  --model claude-sonnet-5 \
  --model claude-haiku-4-5 \
  --api-type openai

jan config list   # configured providers as JSON, keys redacted

Từng bước

1. Tạo khóa tại /app/keys rồi sao chép khóa — khóa chỉ hiển thị một lần.
2. Kiểm tra bạn đang cấu hình đúng chương trình: jan --version. Jan Desktop cũng có một CLI được gọi bằng jan, nhưng bộ lệnh khác; vì vậy hãy xác nhận jan config set --help liệt kê --base-url trước khi nhập phần còn lại.
3. Chạy dòng lệnh jan config set ở trên. --provider là ID do bạn chọn, không phải tên trong một danh sách cố định — ví dụ về phần cứng cục bộ trong tài liệu dùng --provider local — còn --model có thể lặp lại và thay thế danh sách hiện có thay vì thêm vào đó.
4. Xác nhận cấu hình đã được ghi bằng jan config list (các khóa được ẩn) hoặc jan config path để xem chính tệp, rồi chạy jan cli models list để xem mọi provider đang cung cấp những gì. ID mô hình nhập thủ công vẫn được giữ lại ngay cả khi endpoint ngừng liệt kê ID đó; còn jan cli models refresh --provider kunavo lấy danh sách của endpoint làm nguồn chính xác.
5. Chuyển vào một dự án rồi chạy jan, sau đó chọn mô hình bằng /model. Nên dùng jan --plan cho lần chạy đầu tiên: chế độ chỉ đọc giúp phát hiện lỗi không khớp giao thức trước khi có nội dung nào được ghi vào đĩa.
6. Giao cho nó một tác vụ chỉnh sửa tệp. Jan Agent là một agent, vì vậy lần chạy đầu tiên nên kiểm tra khả năng gọi công cụ và truyền phát — đây là những phần có thể lỗi trước tiên nếu endpoint chỉ tương thích một phần; còn lời chào hỏi thì không kiểm tra được cả hai.

Đã kiểm tra đối chiếu với Trang Providers của Jan Agent vào 21 tháng 9, 2026. Cài đặt của bên thứ ba có thể thay đổi; nếu tên trường ở đây không còn khớp với những gì bạn thấy, trang đó là nguồn có thẩm quyền, không phải trang này.

Xác minh trước khi gỡ lỗi ứng dụng khách

Một yêu cầu sẽ xác định liệu lỗi nằm ở endpoint, khóa hay tệp cấu hình. Nếu lệnh này trả về JSON, cùng base URL và khóa sẽ hoạt động trong Jan Agent.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Đặt model id nào vào trường

Mọi mô hình văn bản đều có thể truy cập bằng model id — danh sách đang hoạt động là GET /v1/models, còn danh mục kèm giá nằm trên trang mô hình. Mức giá tính bằng USD trên mỗi 1M token, đầu vào / đầu ra.

Có hai thứ khác nhau cùng được gọi là khóa API Jan

Chúng nằm trong cùng một tệp nhưng có ý nghĩa trái ngược nhau; vì thế jan config list có thể trông sai nếu bạn đang mong đợi loại kia.

Jan Desktop không cấp ra cả hai loại: ứng dụng không có tài khoản nên không có gì để tạo. Máy chủ API cục bộ của ứng dụng nhận khóa do bạn tự nghĩ ra, đó lại là ý nghĩa thứ ba và thuộc về một máy chủ khác.

Jan Desktop cung cấp những gì và giới hạn ở đâu

Jan Agent đọc cài đặt nhà cung cấp từ bốn nguồn, mỗi nguồn có mức ưu tiên cao hơn các nguồn đứng trước; nguồn thứ hai là điều khiến nhiều người bất ngờ.

1. ~/.jan/config.toml — tệp cơ sở và là tệp duy nhất được jan config set ghi.
2. settings.json của Jan Desktop — chỉ kế thừa. Tệp này bổ sung các nhà cung cấp bạn chưa cấu hình trong Agent, không bao giờ ghi đè nhà cung cấp đã có và không bao giờ được ghi ngược lại.
3. Một khối [provider] trong agent.toml của dự án — lựa chọn tường minh cho từng dự án nên được ưu tiên hơn cả hai nguồn kia. Tệp đó thường được đưa vào kho mã, vì vậy hãy để api_key ngoài tệp.
4. --provider / --api-key trên dòng lệnh, hoặc JAN_API_KEY / <PROVIDER>_API_KEY — tường minh nhất và chỉ tồn tại tạm thời.

Có hai hệ quả cần biết để tránh gỡ lỗi nhầm chỗ. jan config list có thể báo không có nhà cung cấp nào trong khi jan cli models list trả về nhiều — kết quả thứ hai bao gồm các nhà cung cấp được kế thừa từ Desktop, vốn không được lưu trong ~/.jan/config.toml. Nhà cung cấp được kế thừa cũng không bao giờ được làm mới, vì ở đây không có mục nào để ghi lại: nếu muốn danh sách mô hình của Kunavo luôn được cập nhật, bạn phải tự tạo một mục jan config set, như khối phía trên.

Khi hai nhà cung cấp có cùng model id

Kunavo cung cấp các ID như claude-sonnet-5, và mục nhà cung cấp trỏ thẳng đến nhà cung cấp dịch vụ cũng vậy. Jan Agent phải chọn một mục; thứ tự được tài liệu nêu như sau: trước tiên là kết quả khớp chính xác trong danh sách models của nhà cung cấp, tiếp theo là tiền tố <provider>/<model> chỉ định nhà cung cấp đã cấu hình; nếu nhiều nhà cung cấp có cùng ID, nhà cung cấp có thông tin xác thực được ưu tiên hơn bản sao không có khóa. Vì vậy, kunavo/claude-sonnet-5 dùng để chỉ rõ bạn muốn chọn nhà cung cấp nào. Phần định danh bổ sung này chỉ dành cho Jan — nó được loại bỏ trước khi gửi yêu cầu vì các dịch vụ upstream từ chối ID có tiền tố nhà cung cấp.

Cùng mục cấu hình đó, ngay trong bảng điều khiển

Nếu bạn không muốn nhập cờ dòng lệnh: /settings > providers quản lý cùng các mục ~/.jan/config.toml, còn a mở biểu mẫu thêm mới với các trường name, base url, api key và models phân tách bằng dấu cách. Biểu mẫu có hai điểm khác với cờ dòng lệnh: URL cơ sở phải là https:// (hoặc http:// đối với endpoint localhost), để khóa không bao giờ được gửi qua kết nối từ xa dạng văn bản thuần — Kunavo là https://, nên điều này không gây trở ngại — và khi chỉnh sửa, trường khóa API hiển thị (unchanged) và giữ nguyên giá trị đã lưu trừ khi bạn nhập giá trị mới. Để trống trường đó sẽ xóa khóa, chứ không giữ nguyên.