Skip to Content
aicentos

Junie

Kết nối aicentos trong Junie CLI qua model profile tùy chỉnh

Cập nhật lần cuối:

Junie là coding agent của JetBrains, có hai hình thái: plugin IDE và Junie CLI. Chỉ Junie CLI hỗ trợ trỏ về endpoint tùy chỉnh: nó kết nối tới dịch vụ OpenAI tương thích bất kỳ qua JSON profile trong $JUNIE_HOME/models/. Plugin IDE hiện không thể trỏ về endpoint tùy chỉnh.

Chuẩn bị

Trước tiên, tạo một Key chuyên dụng cho Junie tại trang "API Key" trong Console (khuyến nghị đặt tên junie-cli).

Cấu hình cần điền

TrườngGiá trị
baseUrlhttps://aicentos.com/v1/chat/completions
apiTypeOpenAICompletion
apiKeyKey tạo trong Console (hỗ trợ tham chiếu ${ENV_VAR})
idtên mô hình trong "Model Square" của Console
displayName / providerNametự đặt, ví dụ aicentos

Lưu ý: profile của Junie ngược với đa số client, baseUrl cần điền endpoint đầy đủ, phải kết thúc bằng /chat/completions, Junie không tự nối đường dẫn.

Các bước thiết lập

  • Tạo file profile (tên file bỏ .json chính là định danh profile):
    • Cấp người dùng: ~/.junie/models/aicentos.json ($JUNIE_HOME mặc định là ~/.junie)
    • Cấp dự án: <gốc dự án>/.junie/models/aicentos.json (cần dự án đã được tin cậy)
  • Ghi nội dung sau:
{
  "id": "gpt-5",
  "baseUrl": "https://aicentos.com/v1/chat/completions",
  "apiType": "OpenAICompletion",
  "apiKey": "${AICENTOS_API_KEY}",
  "displayName": "aicentos GPT",
  "providerName": "aicentos",
  "fasterModel": { "id": "gpt-5-mini" }
}
  • Xuất biến môi trường:
export AICENTOS_API_KEY="sk-Key-aicentos-của-bạn"
  • Khi khởi động chỉ định profile, hoặc trong giao diện tương tác dùng /model để chọn:
junie --model custom:aicentos

Kiểm tra

Sau khi khởi động, trước tiên test nhẹ bằng một câu prompt đơn giản, xác nhận có thể trả về kết quả bình thường rồi mới chính thức dùng quy trình agentic.

Lưu ý

  • Plugin JetBrains IDE không hỗ trợ endpoint tùy chỉnh, bộ profile này chỉ có hiệu lực trong Junie CLI.
  • baseUrl phải là endpoint đầy đủ (kèm /v1/chat/completions), điều này khác với nhiều client chỉ cần điền Base URL.
  • ${VAR} trong apiKey và extraHeaders được phân giải khi nạp profile; biến môi trường chưa thiết lập sẽ khiến việc nạp profile thất bại.
  • Profile cấp dự án chịu giới hạn tin cậy dự án, dự án chưa tin cậy sẽ báo Unknown custom model profile.
  • Mô hình nhỏ khó đảm nhiệm các tác vụ gọi công cụ nhiều bước và ngữ cảnh dài của Junie, khuyến nghị chọn mô hình có năng lực mạnh hơn.
  • Xem thêm giải thích tại trang tài liệu: https://docs.aicentos.com