Felo API PlatformFelo API Platform

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 web

http://127.0.0.1:3080 adresini açın, ardından:

  1. Proje çalışma alanınızı ekleyin veya seçin.
  2. Settings → Models bölümünü açın.
  3. deepseek-official sağlayıcısını ve deepseek-v4-flash modelini seçin.
  4. 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/v1

Bu 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.

  1. Web arayüzünü npx @deepseek-ai/dsh web ile başlatın.
  2. Settings → Models bölümünü açın.
  3. Add custom provider seçeneğini seçin.
  4. Aşağıdaki değerleri girin ve sağlayıcıyı kaydedin.
AlanDeğer
Sağlayıcı kimliğifelo
Görünen adFelo API Platform
Temel URLhttps://openapi.felo.ai/api/v1
API protokolüOpenAI uyumlu Chat Completions (openai-completions)
API anahtarıFelo API anahtarınız
Model kimliğideepseek-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

SorunNeyi kontrol etmeli
MISSING_CREDENTIAL veya 401dsh 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_MODELdeepseek-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ıyorYeni 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 oluyorHarness arama sağlayıcısını ayrı olarak yapılandırın; model endpoint ayarları web aramasını yapılandırmaz

Sonraki adımlar