AI Aracı Kurulumu
DeepSeek Harness
DeepSeek Harness'ı yerel DeepSeek bağdaştırıcısı veya özel bir OpenAI uyumlu sağlayıcı üzerinden Felo'ya bağlayın.
Felo API Platform tarafından sunulan modellerle açık kaynak DeepSeek Harness aracını çalıştırmak için bu kılavuzu kullanın. Önerilen yol, harness'in yerleşik deepseek-official bağdaştırıcısını yeniden kullanır. Ayrıca Web arayüzünde Felo'yu ayrı bir özel OpenAI uyumlu sağlayıcı olarak ekleyebilirsiniz.
DeepSeek Harness şu anda bir geliştirici önizlemesidir ve uyumluluğu bozan değişiklikler getirebilir. Bir seçenek veya ekran bu kılavuzdan farklı olduğunda upstream sürüm notlarını kontrol edin.
Başlamadan önce
Node.js ve bir Felo API Platform anahtarına ihtiyacınız var. Anahtarı sürüm kontrolünün dışında tutun.
export FELO_API_KEY="YOUR_API_KEY"Örnekler deepseek-v4-flash kullanır. Farklı bir model kimliği seçmeden önce Modeller ve Fiyatlar bölümüne bakın.
Önerilen kurulum: yerleşik DeepSeek bağdaştırıcısı
DeepSeek Harness, yerleşik bağdaştırıcı kimlik bilgisini DEEPSEEK_API_KEY değişkeninden, endpoint'ini ise DEEPSEEK_BASE_URL değişkeninden okur.
export DEEPSEEK_API_KEY="$FELO_API_KEY"
export DEEPSEEK_BASE_URL="https://openapi.felo.ai/api/v1"
npx @deepseek-ai/dsh webhttp://127.0.0.1:3080 adresini açın, ardından:
- Proje çalışma alanınızı ekleyin veya seçin.
- Settings → Models bölümünü açın.
deepseek-officialsağlayıcısını vedeepseek-v4-flashmodelini seçin.- Yeni bir oturum başlatın ve küçük bir depo görevi gönderin.
Temel URL'ye /chat/completions eklemeyin. Yerleşik bağdaştırıcı istekleri kendisi {DEEPSEEK_BASE_URL}/chat/completions adresine gönderir.
Ortam değerlerini kalıcı hale getirme
DeepSeek Harness, başlattığınız dizindeki bir .env dosyasını okuyabilir. Her oturum için dışa aktarmak istemiyorsanız aşağıdaki değerleri izlenmeyen bir .env dosyasına ekleyin:
DEEPSEEK_API_KEY=YOUR_API_KEY
DEEPSEEK_BASE_URL=https://openapi.felo.ai/api/v1Bu dosyayı işlemeyin. Kullanıcı düzeyinde yapılandırmaya ihtiyaç duyduğunuzda $DSH_HOME altındaki harness kimlik bilgisi ve ayarlar dosyalarını da kullanabilirsiniz.
Alternatif kurulum: özel OpenAI uyumlu sağlayıcı
Felo'nun yerleşik DeepSeek bağlantısını geçersiz kılmak yerine ayrı bir sağlayıcı olarak görünmesini istediğinizde bu yolu kullanın.
- Web arayüzünü
npx @deepseek-ai/dsh webile başlatın. - Settings → Models bölümünü açın.
- Add custom provider seçeneğini seçin.
- Aşağıdaki değerleri girin ve sağlayıcıyı kaydedin.
| Alan | Değer |
|---|---|
| Sağlayıcı kimliği | felo |
| Görünen ad | Felo API Platform |
| Temel URL | https://openapi.felo.ai/api/v1 |
| API protokolü | OpenAI uyumlu Chat Completions (openai-completions) |
| API anahtarı | Felo API anahtarınız |
| Model kimliği | deepseek-v4-flash |
Model keşfi başarısız olursa model kimliğini elle ekleyin. Bir sağlayıcının Get available models eylemi OpenAI uyumlu bir GET /models rotasına bağlıdır ve manuel yapılandırma için gerekli değildir.
Kurulumu doğrulama
Yeni bir oturum başlatın ve şunu sorun:
Summarize this repository and identify its main packages.Oturum deepseek-v4-flash seçili olarak tamamlandığında ve kimlik doğrulama veya bilinmeyen model hatası görünmediğinde kurulum hazırdır.
Önerilen bağdaştırıcıyla etkileşimsiz bir duman testi için hedef çalışma alanından şunu çalıştırın:
npx @deepseek-ai/dsh --profile headless "List the top-level files in this workspace."Web araması notu
Bu kurulum model isteklerini Felo üzerinden yönlendirir. DeepSeek Harness'in yerleşik web_search sağlayıcısının, varsayılan kimlik bilgisi değişkeni de DEEPSEEK_API_KEY olsa bile ayrı endpoint gereksinimleri vardır. Açıkça uyumlu bir arama endpoint'i kullanmıyorsanız DEEPSEEK_SEARCH_BASE_URL değişkenini Felo'ya yönlendirmeyin. İş akışınız Felo araması gerektirdiğinde Felo'nun Chat API veya diğer Felo Skills'ini ayrı olarak kullanın.
Sorun giderme
| Sorun | Neyi kontrol etmeli |
|---|---|
MISSING_CREDENTIAL veya 401 | dsh aracını başlatan süreçte DEEPSEEK_API_KEY değişkeninin Felo anahtarını içerdiğini doğrulayın |
| İstek URL'si yolu iki kez içeriyor | /chat/completions ile biten bir URL değil, https://openapi.felo.ai/api/v1 kullanın |
UNKNOWN_MODEL | deepseek-v4-flash modelini seçin veya elle ekleyin ya da yayımlanmış başka bir Felo model kimliği kullanın |
| Felo ayrı olarak listelenmiyor | Özel sağlayıcı kurulumunu kullanın; önerilen yol deepseek-official sağlayıcı kimliğini korur |
| Ayarlar değişti ama eski bir oturum farklı davranıyor | Yeni seçilen sağlayıcıyı ve model rotasını kullanması için yeni bir oturum başlatın |
| Web araması kimlik doğrulaması başarısız oluyor | Harness arama sağlayıcısını ayrı olarak yapılandırın; model endpoint ayarları web aramasını yapılandırmaz |