> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CometAPI ile DeepSeek Harness kullanın

> Chat Completions, Responses, Anthropic Messages veya Google generateContent aracılığıyla CometAPI kullanmak için DeepSeek Harness 0.1.0-rc.8'i yapılandırın.

CometAPI ile [DeepSeek Harness'ı](https://github.com/deepseek-ai/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.

<Warning>
  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.
</Warning>

Resmî başvurular:

* [DeepSeek Harness deposu](https://github.com/deepseek-ai/deepseek-harness)
* [DeepSeek Harness 0.1.0-rc.8 kaynak kodu](https://github.com/deepseek-ai/deepseek-harness/tree/dsh-v0.1.0-rc.8)
* [DeepSeek Harness CLI](https://github.com/deepseek-ai/deepseek-harness/blob/dsh-v0.1.0-rc.8/apps/cli/README.md)
* [DeepSeek Harness sağlayıcı kılavuzu](https://github.com/deepseek-ai/deepseek-harness/blob/dsh-v0.1.0-rc.8/docs/user/guide/providers.md)

## Ön koşullar

* Node.js ve npm
* Şuradan alınmış etkin bir API key'e sahip bir CometAPI hesabı [dashboard](https://www.cometapi.com/console/token)
* Şuradan bir model ID [CometAPI Models sayfası](/tr/overview/models) 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`         |

<Note>
  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.
</Note>

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

<Steps>
  <Step title="Test edilen Harness sürümünü doğrulayın">
    Harness'ı yapılandırmadan önce sabitlenmiş paket sürümünü doğrulayın:

    ```bash theme={null}
    npx @deepseek-ai/dsh@0.1.0-rc.8 --version
    ```

    Komut `0.1.0-rc.8` yazdırmalıdır.
  </Step>

  <Step title="CometAPI API anahtarınızı ayarlayın">
    Harness'ı başlatmadan önce anahtarınızı `COMETAPI_KEY` içinde saklayın:

    ```bash theme={null}
    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.
  </Step>

  <Step title="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:

    ```yaml theme={null}
    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:

    ```bash theme={null}
    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.
  </Step>

  <Step title="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:

    ```bash theme={null}
    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.
  </Step>

  <Step title="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:

    ```bash theme={null}
    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.
  </Step>
</Steps>

## İ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:

```yaml theme={null}
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

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

## İlgili kaynaklar

* [CometAPI hızlı başlangıç](/tr/overview/quick-start)
* [CometAPI Modeller sayfası](/tr/overview/models)
* [DeepSeek Harness deposu](https://github.com/deepseek-ai/deepseek-harness)
* [DeepSeek Harness sağlayıcı kılavuzu](https://github.com/deepseek-ai/deepseek-harness/blob/dsh-v0.1.0-rc.8/docs/user/guide/providers.md)

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/deepseek-harness#howto",
        "name": "DeepSeek Harness'ı CometAPI ile kullanın",
        "description": "DeepSeek Harness 0.1.0-rc.8'i Chat Completions, Responses, Anthropic Messages veya Google generateContent aracılığıyla CometAPI kullanacak şekilde yapılandırın.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/deepseek-harness#step-1",
            "position": 1,
            "name": "Test edilen Harness sürümünü doğrulayın",
            "text": "Sabitlenmiş DeepSeek Harness 0.1.0-rc.8 paket sürümünü doğrulayın."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/deepseek-harness#step-2",
            "position": 2,
            "name": "CometAPI API anahtarınızı ayarlayın",
            "text": "Harness'ı başlatmadan önce CometAPI API anahtarını COMETAPI_KEY içinde saklayın."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/deepseek-harness#step-3",
            "position": 3,
            "name": "CometAPI sağlayıcılarını ekleyin",
            "text": "Doğrulanmış sağlayıcı rotalarını Harness settings.yaml dosyasına ekleyin."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/deepseek-harness#step-4",
            "position": 4,
            "name": "Bir metin turunu doğrulayın",
            "text": "Sabitlenmiş başsız bir görevi çalıştırın ve beklenen metin yanıtını doğrulayın."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/deepseek-harness#step-5",
            "position": 5,
            "name": "Dosya aracı kullanımını doğrulayın",
            "text": "Harness'tan bir sentinel dosyasını okumasını isteyin ve kesin nihai yanıtı doğrulayın."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "CometAPI Dokümantasyonu",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Entegrasyonlar",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "DeepSeek Harness'ı CometAPI ile kullanın",
            "item": "https://apidoc.cometapi.com/integrations/deepseek-harness"
          }
        ]
      }
    ]
    }
    `}
</script>