CometAPI ile DeepSeek Harness kullanın

CometAPI ile DeepSeek Harness’ı çalıştırmak için bu kılavuzu kullanın. DeepSeek Harness, özel model sağlayıcılarını $DSH_HOME/settings.yaml üzerinden yükler; bu değer varsayılan olarak ~/.dsh/settings.yaml olur. Bu sayfadaki yapılandırmalar @deepseek-ai/dsh@0.1.0-rc.8 ile doğrulandı. Her yol, temsilî bir modelle bir Streaming metin turunu ve dosya okuma araç döngüsünü tamamladı. Bu kapsam, her CometAPI modelinin her API formatını kabul ettiği anlamına gelmez.

DeepSeek Harness Geliştirici Önizlemesi aşamasındadır ve uyumluluğu bozan değişiklikler içerebilir. Bu kılavuzu izlerken test edilen paket sürümünü sabitleyin ve yükseltmeden önce ana kaynak sürüm notlarını inceleyin.

Resmî başvurular:

Ön koşullar

Node.js ve npm
Şuradan alınmış etkin bir API key’e sahip bir CometAPI hesabı dashboard
Şuradan bir model ID CometAPI Models sayfası kullanmayı planladığınız her API formatı için

Sağlayıcı yollarını anlayın

api değeri iletişim biçimini seçer. baseURL, Harness’ın eklediği işlem yolundan önce sona erer.

Sağlayıcı kimliği	`api` değer	`baseURL`	İstek yolu
`cometapi-chat`	`openai-completions`	`https://api.cometapi.com/v1`	`/v1/chat/completions`
`cometapi-responses`	`openai-responses`	`https://api.cometapi.com/v1`	`/v1/responses`
`cometapi-messages`	`anthropic-messages`	`https://api.cometapi.com`	`/v1/messages`

Her bir your-model-id değerini bağımsız olarak değiştirin. Sağlayıcı girişinin API formatını kabul eden bir model seçin.

Sağlayıcıları yapılandırın

Test edilen Harness sürümünü doğrulayın

Harness’ı yapılandırmadan önce sabitlenmiş paket sürümünü doğrulayın:

npx @deepseek-ai/dsh@0.1.0-rc.8 --version

Komut 0.1.0-rc.8 yazdırmalıdır.

CometAPI API anahtarınızı ayarlayın

Harness’ı başlatmadan önce anahtarınızı COMETAPI_KEY içinde saklayın:

read -rsp "CometAPI API key: " COMETAPI_KEY
printf '\n'
export COMETAPI_KEY

Değişkeni Harness’ı başlatan her kabuk oturumunda ayarlayın. API anahtarlarını sürüm kontrolüne kaydetmeyin.

CometAPI sağlayıcılarını ekleyin

$DSH_HOME/settings.yaml oluşturun. Dosyada zaten bir llm-pi-ai bölümü varsa, bu sağlayıcı girdilerini mevcut providers eşlemesiyle birleştirin:

llm-pi-ai:
  providers:
    cometapi-chat:
      displayName: CometAPI Chat Completions
      apiKeyEnv: COMETAPI_KEY
      api: openai-completions
      baseURL: https://api.cometapi.com/v1
      models:
        - id: your-model-id
    cometapi-responses:
      displayName: CometAPI Responses
      apiKeyEnv: COMETAPI_KEY
      api: openai-responses
      baseURL: https://api.cometapi.com/v1
      models:
        - id: your-model-id
    cometapi-messages:
      displayName: CometAPI Anthropic Messages
      apiKeyEnv: COMETAPI_KEY
      api: anthropic-messages
      baseURL: https://api.cometapi.com
      models:
        - id: your-model-id

agent-default-model:
  provider: cometapi-responses
  model: your-model-id

Örnek varsayılan olarak Responses sağlayıcısını seçer. Yapılandırılmış başka bir girdiyi seçmek için agent-default-model.provider ve agent-default-model.model değerlerini değiştirin.Web UI’yi tercih ediyorsanız, COMETAPI_KEY değerini dışa aktardıktan sonra başlatın; ardından sağlayıcı girdileri eklemek veya düzenlemek ve varsayılan modeli seçmek için model ayarlarını kullanın:

npx @deepseek-ai/dsh@0.1.0-rc.8 web

Varsayılan yerel adres http://127.0.0.1:3080 şeklindedir. YAML, bu kılavuzdaki rota adları ve temel URL’lerle eşleşmenin doğrudan yoludur.

Bir metin etkileşimini doğrulayın

Harness’ın kullanmasını istediğiniz proje dizininden tek seferlik başsız bir görev çalıştırın:

npx @deepseek-ai/dsh@0.1.0-rc.8 \
  --profile headless \
  "Reply exactly with: COMETAPI_DSH_OK"

Başarılı bir çalıştırma COMETAPI_DSH_OK yazdırır. Başka bir sağlayıcıyı denetlemek için agent-default-model değerini güncelleyin ve komutu yeniden çalıştırın.

Dosya aracı kullanımını doğrulayın

Geçici bir işaretçi dosyası oluşturun, ardından Harness’tan bir dosya aracıyla bunu okumasını isteyin:

printf 'COMETAPI_DSH_TOOL_OK\n' > /tmp/cometapi-dsh-sentinel.txt
npx @deepseek-ai/dsh@0.1.0-rc.8 \
  --profile headless \
  "Read /tmp/cometapi-dsh-sentinel.txt with a file tool, then reply with only its contents."

Nihai yanıtın COMETAPI_DSH_TOOL_OK olduğunu doğrulayın. Harness’ı yalnızca dosya, işlem ve ağ erişimini kabul ettiğiniz bir çalışma alanında çalıştırın.

İsteğe bağlı rota

Harness, google adlı yerleşik bir sağlayıcı rotasına sahiptir. Aşağıdaki yapılandırma bu rotayı CometAPI’ye yönlendirir; böylece ikinci bir Google rotası eklemek yerine rotanın yerel Google endpoint’ini değiştirir. Bu girdiyi llm-pi-ai.providers ile birleştirin, ardından agent-default-model içinde seçin:

llm-pi-ai:
  providers:
    google:
      displayName: CometAPI Google generateContent
      apiKeyEnv: COMETAPI_KEY
      baseURL: https://api.cometapi.com/v1beta
      models:
        - id: your-model-id

agent-default-model:
  provider: google
  model: your-model-id

Bu girdiye bir api alanı eklemeyin. Yerleşik google rotası yerel Google protokolünü korur ve Streaming isteklerini /v1beta/models/{model}:streamGenerateContent?alt=sse adresine x-goog-api-key kimlik doğrulamasıyla gönderir.

Sorun giderme

Harness, API anahtarının eksik olduğunu bildiriyor

COMETAPI_KEY değerinin Harness’ı başlatan aynı kabukta ayarlandığını doğrulayın. Ortam değişkenini değiştirdikten sonra Harness’ı yeniden başlatın.

Harness yapılandırılmış modeli göstermiyor

$DSH_HOME/settings.yaml öğesinin geçerli YAML olduğunu, sağlayıcının llm-pi-ai.providers altında bulunduğunu ve modelin bu sağlayıcının models altında listelendiğini doğrulayın. Varsayılan DSH_HOME değeri ~/.dsh şeklindedir.

Chat Completions veya Responses yanlış yolu kullanıyor

https://api.cometapi.com/v1 değerini baseURL olarak kullanın. /chat/completions veya /responses eklemeyin; Harness işlem yolunu ekler.

Anthropic Messages bir yol hatası döndürüyor

Messages https://api.cometapi.com olarak, /v1 olmadan baseURL kullanın. Anthropic bağdaştırıcısı /v1/messages ekler.

Google yinelenen bir v1beta yolu oluşturuyor

https://api.cometapi.com/v1beta değerini tam olarak kullanın. Model yolu eklemeyin ve yerleşik api rotasına google alanı eklemeyin.

Bir model bir sağlayıcıda çalışırken diğerinde çalışmıyor

Model kullanılabilirliği ve kabul edilen API biçimleri farklılık gösterebilir. Tek bir modelin dört biçimin tümünde çalışacağını varsaymak yerine her sağlayıcı girdisi için bir model seçin.

Yapılandırma, yükseltmeden sonra çalışmayı durduruyor

DeepSeek Harness, Developer Preview aşamasındadır. @deepseek-ai/dsh@0.1.0-rc.8 sürümüne geri dönün; ardından yapılandırmayı başka bir sürüme uyarlamadan önce kaynak değişiklikleri inceleyin.

Genel Bakış

AI kodlama ajanları

AI ajanları

AI sohbet istemcileri

Çeviri ve dil

Otomasyon platformları

Gözlemlenebilirlik ve değerlendirme

AI framework'leri

CometAPI ile DeepSeek Harness kullanın

Ön koşullar

Sağlayıcı yollarını anlayın

Sağlayıcıları yapılandırın

İsteğe bağlı rota

Sorun giderme

İlgili kaynaklar

​Ön koşullar

​Sağlayıcı yollarını anlayın

​Sağlayıcıları yapılandırın

​İsteğe bağlı rota

​Sorun giderme

​İlgili kaynaklar

Ön koşullar

Sağlayıcı yollarını anlayın

Sağlayıcıları yapılandırın

İsteğe bağlı rota

Sorun giderme

İlgili kaynaklar