Kodlama araçları

DeepSeek Harness

Harness üzerinde bir TokenLab modeli yapılandırın, bir isteği doğrulayın ve MCP, Skills veya sağlayıcı paketini seçin

İhtiyacınız olan bağlantıyı seçin

TokenLab'i ajanın ana modeli olarak kullanmak için, Harness Web Arayüzü'nde bir özel sağlayıcı (custom provider) ekleyin. Bu, isteğe bağlı TokenLab sağlayıcı paketinden bağımsız olarak çalışır. Medya ve diğer API'ler için MCP araçlarını veya API talimatları için bir Skill ekleyin; bunların hiçbiri tek başına ana modeli değiştirmez.

Harness bir geliştirici önizlemesidir. Bu Web Arayüzü adımları, 12 Ekim 2026 itibarıyla güncel npm latest etiketi olan @deepseek-ai/dsh 0.2.0-rc.2 sürümünün resmi belgelerini takip eder. En son 0.1.5-rc.3 sürümünde uçtan uca test edilmişlerdir; aşağıdaki istek kontrolleri henüz 0.2.0-rc.2 sürümüne karşı yeniden çalıştırılmamıştır. Aşağıdaki isteğe bağlı paket hala 0.1.5-rc.3 sürümünü hedeflemektedir; diğer Harness sürümleriyle uyumluluğu ayrıca kontrol edin.

Bu görevi ajanıza verin

Read https://tokenlab.sh/docs/tr/integrations/deepseek-harness and check my installed version and operating system.
Confirm whether I need TokenLab as the main model, MCP tools, or API Skills.
Preserve existing accounts, provider configuration, and permissions; explain how to restore changed settings.
Keep API keys local; do not ask me to paste them into chat. I will enter the key locally and perform required UI steps.
Explain the cost of a small verification request. Only after I explicitly choose that test, help run it and match the TokenLab request record.

Harness'i başlatın

macOS, Linux veya Windows üzerinde desteklenen bir Node sürümüyle Node CLI'yı kullanın; Node 24 LTS uygun bir başlangıç noktasıdır. Proje dizininizden, bir terminal veya PowerShell'de şunu çalıştırın:

node --version
npx @deepseek-ai/dsh web

Bir sürüm belirtilmediğinde, npx bu adımların kontrol edildiği 0.2.0-rc.2 sürümünden daha yeni olabilen npm latest etiketini yükler. alpha etiketini yüklemez.

Komut tarafından yazdırılan yerel URL'yi açın. Yeni bir Web Arayüzünde, bir mesaj göndermeden önce proje dizininizi eklemek ve seçmek için Choose workspace seçeneğini kullanın. Bu komutlar web profilini kullanır; Electron uygulamasının desktop profili bu CLI iş akışı tarafından yönetilmez. Resmi başlangıç kılavuzuna ve Web Arayüzü kılavuzuna bakın.

Bir TokenLab sağlayıcısı yapılandırın

  1. Settings → Models kısmını açın, Add model provider seçeneğini seçin, ardından kartı Custom model API olarak değiştirin. (Harness 0.1.5-rc.3 sürümünde bu Add a custom provider olarak adlandırılıyordu.) Mevcut sağlayıcıları ve izinleri koruyun.
  2. tokenlab-chat gibi küçük harfli bir Sağlayıcı Kimliği (Provider ID) girin ve aşağıdan bir protokol ile eşleşen Temel URL'sini (Base URL) seçin. Her sağlayıcı bir protokol kullanır.
  3. TokenLab API anahtarınızı yerel forma girin. Harness, arayüz tarafından yönetilen anahtarları $DSH_HOME/.credentials.yaml dosyasında saklar; ayarlar yalnızca kimlik bilgisi referansını tutar. Anahtarı sohbette göndermeyin veya commit etmeyin. Sağlayıcı ve protokolü $DSH_HOME/profiles/<profile>/cordis.patch.yml dosyasında kaydedilir; bu, standart dsh web profili için $DSH_HOME/profiles/web/cordis.patch.yml dosyasıdır.
  4. TokenLab Modelleri sayfasından güncel bir model kimliği ekleyin. Adından destek tahmini yapmak yerine, model detay API'sindeki tokenlab.accepted_request_formats değerini kontrol edin.
  5. Sağlayıcıyı kaydedin, modelini seçin ve yeni bir oturum başlatın. Zaten bir istek göndermiş olan mevcut bir oturum, kaydedilmiş modelini korur.
Sağlayıcı Kimliği örneğiHarness API protokolüTemel URLGerekli genel istek formatı
tokenlab-chatopenai-completionshttps://api.tokenlab.sh/v1openai_chat_completions
tokenlab-responsesopenai-responseshttps://api.tokenlab.sh/v1openai_responses
tokenlab-messagesanthropic-messageshttps://api.tokenlab.shanthropic_messages

İlk metin isteği için, şu anda mevcut olan bir gpt-5.6-luna girişi Chat satırını kullanabilir. Fetch available models → Add selected seçeneği özel bir sağlayıcıyı doldurmaya yardımcı olabilir, ancak listelemenin başarılı olması protokol desteğini veya ücretli bir isteği doğrulamaz; sağlayıcıyı sonrasında kaydedin. Keşif özelliği kullanılamıyorsa kimliği manuel olarak girin.

Harness burada Gemini'ye özgü bir özel sağlayıcı protokolü sunmaz. Yalnızca modelin detaylarında kabul edilen istek formatı olarak Chat Completions listelendiğinde Chat'i kullanın. Görüntü girişi ve muhakeme kontrolleri $DSH_HOME/profiles/web/cordis.patch.yml dosyasında ek alanlar gerektirebilir; bunları etkinleştirmeden önce Harness sağlayıcı yapılandırmasını ve seçilen modelin desteklenen alanlarını takip edin. (0.2.0-rc.2 sürümünde henüz yeniden test edilmemiştir.)

Küçük bir isteği doğrulayın

Yeni oturumda şunu gönderin:

Reply only with TOKENLAB_CONNECTION_OK. Do not use tools or modify files.

Bu istek ücretlidir. Yanıtı ve TokenLab İstekleri kısmındaki eşleşen modeli, zamanı ve durumu kontrol edin. Bu metin kontrolünden sonra durun; ilk bağlantıyı kurmak için üç protokolü test etmek veya ücretli medya oluşturmak gerekli değildir. Yalnızca model listeleme veya MCP keşfi, anahtarın oluşturma erişimini doğrulamaz.

İsteğe bağlı: TokenLab paketi

@tokenlabai/dsh-provider@0.1.6, Harness 0.1.5-rc.3 sürümünü hedefler: eş bağımlılıkları hala @deepseek-ai/dsh-tools ve @deepseek-ai/dsh-mcp-client 0.1.5-rc.3'tür. Harness 0.2 ile test edilmemiştir. Paketi kullanmak için eşleşen sürümü başlatın: npx @deepseek-ai/dsh@0.1.5-rc.3 web. Bir model yapılandırmak için yukarıdaki yerel özel sağlayıcı adımlarını kullanın veya önceden ayarlanmış model rotaları ve araçları için paketi yükleyin.

Paket, 3 Ekim 2026'da kontrol edilen 145 genel sohbet modelinin sabit bir anlık görüntüsünü içerir: 28 Responses, 11 Messages ve 106 Chat. Her model tam olarak bir rotada görünür. @tokenlabai/mcp-server@0.6.25 sürümünü sabitler ve ayrı tokenlab_wait_task aracını içerir. Bu sürümü yüklemek model kataloğunu yenilemez. Kimlikleri canlı katalogla karşılaştırın ve gerektiğinde özel bir sağlayıcı aracılığıyla daha yeni modeller ekleyin.

Mevcut uyumlu bir Harness kurulumu için, önce pnpm'in PATH üzerinde olduğundan emin olun. Kurulum ve başlatma için aynı dsh çalıştırılabilir dosyasını/sürümünü ve profilini kullanın; npx aracılığıyla başlatıyorsanız, aşağıdaki dsh yerine aynı sürümlü başlatıcıyı kullanın:

dsh --version
pnpm --version
dsh plugin --profile web add --workspace-root @tokenlabai/dsh-provider@0.1.6

Bu profili başlatmadan önce, anahtarı başlatma ortamında veya .env dosyasında ayarlayın:

TOKENLAB_API_KEY=sk-your-tokenlab-key

Harness, .env dosyasını başlattığınız dizinde ve $DSH_HOME (normalde ~/.dsh) içinde okur; devralınan bir ortam değişkeni önceliklidir. Daha sonra bir çalışma alanı seçmek farklı bir .env seçmez. Bu dosyayı git dışında tutun ve değiştirdikten sonra yeniden başlatın. Arayüzde özel bir sağlayıcı için kaydedilen bir anahtar, bu paketin TOKENLAB_API_KEY değerini otomatik olarak sağlamaz.

Aynı profili yeniden başlatın, ardından model ve araç listelerini inceleyin. headless için, web yerine headless içine yükleyin ve başlatın; bir profile yükleme yapmak diğerini yapılandırmaz.

Harness 0.1.5-rc.3 sürümünde (paketin hedefi), Harness kaydedilmiş llm-pi-ai.providers dosyalarını sağlayıcı anahtarına göre birleştirir. Farklı anahtarlara sahip sağlayıcılar bir arada bulunur. Kaydedilmiş tokenlab-responses, tokenlab-messages veya tokenlab-chat girişleri, karşılık gelen paketlenmiş rotayı geçersiz kılar; eski bir kataloğu yükseltirken bu girişleri gözden geçirin. $DSH_HOME/settings.yaml içindeki diğer sağlayıcıları ve modelleri koruyun; tüm ayarlar belgesini Cordis yamasıyla değiştirmeyin.

Genel model detayları muhakeme yeteneğini tanımlar ancak model başına desteklenen çaba değerlerini numaralandırmaz. Bu nedenle paket reasoningEfforts değerini bildirilmemiş bırakır. Harness bu özel rotalar için çaba seviyeleri sunmaz; bu, sunucu tarafı muhakemeyi devre dışı bırakmaz. reasoningEfforts değerini kendiniz yapılandırırsanız, yalnızca sağlayıcının models listesindeki model girişinde ayrı olarak doğrulanmış değerleri kullanın ve diğer modelleri koruyun. Muhakeme yeteneği tek başına xhigh veya max desteğini oluşturmaz.

Paket, 32 MCP aracı ve TOKENLAB_MCP_SCHEMA_MODE=portable ile TOKENLAB_MCP_TOOL_PROFILE=core varsayılanını kullanır. Yalnızca keşif için catalog (6 araç) veya ek yanıt yaşam döngüsü, toplu işlem, Seedance varlık/grup ve dünya operasyonları dahil olmak üzere 89 aracın tamamı için full seçeneğini belirleyin. Ayrı tokenlab_wait_task yoklayıcısı her profilde kullanılabilir kalır ve bu MCP sayımlarına dahil değildir. TOKENLAB_API_BASE ve TOKENLAB_ANTHROPIC_BASE_URL varsayılan olarak https://api.tokenlab.sh değerini alır; TOKENLAB_OPENAI_BASE_URL varsayılan olarak https://api.tokenlab.sh/v1 değerini alır.

Paket medya araçları için delivery.mode değerini inceleyin: complete çıktısını doğrudan tüketin; bir async sonucunun delivery.task_id değerini tokenlab_wait_task aracına iletin ve terminal status, response ve result_urls değerlerini okuyun. Bekleme zaman aşımı tamamlanmış bir görev değildir. Ücretli veya yıkıcı araçlar için onayları saklayın. Bkz. async tasks.

Paketi kaldırmak için aynı başlatıcıyı ve profili kullanın, ardından yeniden başlatın:

dsh plugin --profile web remove --workspace-root @tokenlabai/dsh-provider

Hata durumunda

  • Composer devre dışı: hem bir çalışma alanı hem de bir model seçin.
  • MISSING_CREDENTIAL veya 401: seçilen sağlayıcının kimlik bilgilerini kontrol edin. Paket araçları için başlatma ortamındaki TOKENLAB_API_KEY değerini kontrol edin; arayüzde kaydedilen model anahtarı ayrı bir ayardır.
  • UNKNOWN_MODEL veya kullanımdan kaldırılmış bir kimlik: canlı kataloğu kontrol edin, güncel tam kimliği yapılandırın, ardından yeni bir oturum oluşturun. 0.1.6 paketini yeniden yüklemek anlık görüntüsünü güncellemez.
  • URL'ye erişilebiliyor ancak oluşturma başarısız: protokolü, Temel URL'yi ve modelin kabul edilen formatlarını karşılaştırın. Bir hatayı başarılı bir kontrole dönüştürmek için geçmişi, araçları veya görüntü girişini kaldırmayın.
  • dsh veya pnpm eksik: npx @deepseek-ai/dsh web (veya paket için @0.1.5-rc.3) kullanın; eklenti komutlarını kullanmadan önce pnpm yükleyin. Eklenti yükleme hatası bir API anahtarı hatası değildir.

MCP ve Skills ayrı seçimlerdir

Manuel bir özel sağlayıcı araçları yüklemez. Paket olmadan çağrılabilir API araçlarına ihtiyacınız varsa TokenLab MCP kılavuzunu takip edin ve herhangi bir oluşturma işleminden önce keşif özelliğini kontrol edin.

TokenLab Skills için, SKILL.md ve referans verilen dosyalar dahil olmak üzere tüm skill klasörünü proje kök dizinindeki .dsh/skills/tokenlab-api-integration/ altında tutun. Harness ayrıca .agents/skills/ dizinini de keşfeder. Bu talimatlar bir sağlayıcı, MCP sunucusu veya anahtar yüklemez. Resmi dosya sistemi Skills referansı desteklenen konumları tanımlar.

Jev / System One & Webhooks

Jev (POST /v1/systemone) için core veya full içinde mcp__tokenlab__evaluate_decisions kullanın. Önce category=decision değerini keşfedin ve modeli inceleyin. Bunlar sohbet modelleri veya asenkron görevler değil, senkron kararlardır; model seçiciyi veya tokenlab_wait_task aracını kullanmayın.

Webhook yönetimi full sürümünü ve başlatma ortamında, paket tarafından MCP'ye açıkça iletilen ayrı bir TOKENLAB_MANAGEMENT_TOKEN=mt-... değerini gerektirir. Bir çıkarım (inference) anahtarı bunun yerine geçemez. Yönetim anahtarları, webhook'ların ötesinde çalışma alanı düzeyinde yetkiye sahiptir; bir webhook kaydetmek Harness'i bir alıcı yapmaz.

Bu sayfada