#Zed

Zed cấu hình các dịch vụ bên thứ ba tương thích với OpenAI trong language_models.openai_compatible.<provider>. Hướng dẫn này dùng provider ID getrouter.

#1. Lưu API key

Mở Agent Settings của Zed bằng agent: open settings, thêm hoặc chọn provider tương thích với OpenAI có tên getrouter, rồi lưu YOUR_API_KEY trong giao diện thông tin xác thực của Zed. Thông tin xác thực do giao diện quản lý được lưu trong keychain của hệ thống, không nằm trong settings.json.

Ngoài ra, bạn có thể đặt biến môi trường được tạo từ provider ID trước khi khởi động Zed:

export GETROUTER_API_KEY="YOUR_API_KEY"

#2. Cấu hình provider và model

Mở settings.json của Zed và hợp nhất mẫu sau:

{
  "language_models": {
    "openai_compatible": {
      "getrouter": {
        "api_url": "https://getrouter.ai/v1",
        "available_models": [
          {
            "name": "MODEL_ID",
            "display_name": "GetRouter Model",
            "max_tokens": MODEL_MAX_TOKENS
          }
        ]
      }
    }
  }
}

MODEL_MAX_TOKENS là ký hiệu trong mẫu, không phải giá trị JSON có thể dùng trực tiếp. Trước khi lưu, hãy thay ký hiệu này bằng một số nguyên tương ứng với giới hạn cửa sổ ngữ cảnh thực tế của model đã chọn. Không sao chép hoặc phỏng đoán giới hạn của model khác.

Cấu trúc này tuân theo cấu hình endpoint tương thích với OpenAI chính thức của Zed.

#3. Xác minh

Mở Agent Panel, chọn GetRouter Model và gửi một Prompt văn bản ngắn. Sau khi chat cơ bản hoạt động, chỉ kiểm tra tính năng chỉnh sửa và công cụ nếu model đã chọn hỗ trợ chúng. Hướng dẫn này chưa được xác minh bằng cách chạy thực tế.

#Khắc phục sự cố

• Model không xuất hiện: Kiểm tra cấu trúc openai_compatible.getrouter.available_models và thay MODEL_MAX_TOKENS bằng số nguyên trước khi lưu.
• Không tìm thấy thông tin xác thực: Provider ID getrouter tương ứng với GETROUTER_API_KEY; hãy lưu key trong giao diện provider của Zed hoặc khởi động lại Zed sau khi export biến môi trường.
• Phản hồi 401: Xác nhận tiến trình Zed cục bộ có thể truy cập đúng thông tin xác thực.
• Agent hoặc công cụ gặp lỗi: Kiểm tra khả năng của model đã chọn và dùng giới hạn cửa sổ ngữ cảnh thực tế của model đó.