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

# Pi'yi CometAPI ile kullanma

> Bu kılavuzu kullanarak base URL, API key ve model veya provider seçeneklerini ayarlayıp Pi'yi CometAPI ile yapılandırın.

[Pi](https://github.com/earendil-works/pi), Pi Agent Harness projesidir. `@earendil-works/pi-coding-agent` paketi; dosya, shell, düzenleme, yazma, oturum, yazdırma, JSON, RPC ve SDK iş akışlarıyla etkileşimli bir coding agent CLI sağlar. Pi, `~/.pi/agent/models.json` içinden özel provider'ları yükleyebilir; böylece Pi kaynak kodunu değiştirmeden CometAPI'yi OpenAI-compatible provider girdileri olarak ekleyebilirsiniz.

Resmi başvurular:

* [Pi repository](https://github.com/earendil-works/pi)
* [Pi quickstart](https://github.com/earendil-works/pi/blob/main/packages/coding-agent/docs/quickstart.md)
* [Pi providers](https://github.com/earendil-works/pi/blob/main/packages/coding-agent/docs/providers.md)
* [Pi custom models](https://github.com/earendil-works/pi/blob/main/packages/coding-agent/docs/models.md)
* [Pi CLI usage](https://github.com/earendil-works/pi/blob/main/packages/coding-agent/docs/usage.md)

<Note>
  Model kullanılabilirliği zaman içinde değişir. `your-model-id` değerini [CometAPI Models page](/tr/overview/models) üzerinde bulunan kullanılabilir bir model ID ile değiştirin.
</Note>

## Ön koşullar

* Node.js `>=22.19.0`
* npm
* [dashboard](https://www.cometapi.com/console/token) üzerinden alınmış etkin bir API key'e sahip bir CometAPI hesabı
* Resmi npm paketinden kurulmuş Pi

## Çalışma zamanı izinlerini anlayın

Pi, onu başlatan kullanıcı ve sürecin izinleriyle çalışır. Pi'yi üzerinde çalışmasını istediğiniz proje dizininde başlatın, git gibi bir geri alma yolu bulundurun ve daha güçlü dosya sistemi, süreç, ağ veya kimlik bilgisi sınırlarına ihtiyacınız varsa bir container ya da sandbox kullanın.

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

<Steps>
  <Step title="Pi'yi yükleyin">
    Pi'yi npm ile global olarak yükleyin:

    ```bash theme={null}
    npm install -g --ignore-scripts @earendil-works/pi-coding-agent
    ```

    CLI'nin kullanılabilir olduğunu doğrulayın:

    ```bash theme={null}
    pi --version
    ```
  </Step>

  <Step title="CometAPI API anahtarınızı ayarlayın">
    CometAPI API anahtarınızı `COMETAPI_KEY` ortam değişkeninde saklayın:

    ```bash theme={null}
    read -rsp "CometAPI API key: " COMETAPI_KEY
    printf '\n'
    export COMETAPI_KEY
    ```

    Terminal oturumları arasında kalıcı olmasını istiyorsanız export komutunu shell profilinize ekleyin. API anahtarlarını sürüm kontrolüne commit etmeyin.
  </Step>

  <Step title="models.json dosyasına CometAPI sağlayıcılarını ekleyin">
    `~/.pi/agent/models.json` yoksa oluşturun. Dosya zaten sağlayıcılar içeriyorsa, `cometapi-responses` ve `cometapi-chat` girdilerini mevcut `providers` nesnesiyle birleştirin:

    ```json theme={null}
    {
      "providers": {
        "cometapi-responses": {
          "name": "CometAPI Responses",
          "baseUrl": "https://api.cometapi.com/v1",
          "api": "openai-responses",
          "apiKey": "$COMETAPI_KEY",
          "models": [
            {
              "id": "your-model-id",
              "name": "CometAPI Responses model"
            }
          ]
        },
        "cometapi-chat": {
          "name": "CometAPI Chat Completions",
          "baseUrl": "https://api.cometapi.com/v1",
          "api": "openai-completions",
          "apiKey": "$COMETAPI_KEY",
          "models": [
            {
              "id": "your-model-id",
              "name": "CometAPI Chat model"
            }
          ]
        }
      }
    }
    ```

    OpenAI Responses API gerektiren model veya iş akışları için `cometapi-responses` kullanın. OpenAI Chat Completions ile uyumlu modeller için `cometapi-chat` kullanın. Pi, istek sırasında `$COMETAPI_KEY` değerini çözümler. API anahtarını ortamınızda veya kendi secrets iş akışınızda tutun.
  </Step>

  <Step title="Her iki sağlayıcıyı da doğrulayın">
    Pi'nin Responses sağlayıcısı için görebildiği modelleri listeleyin:

    ```bash theme={null}
    pi --list-models cometapi-responses
    ```

    Responses sağlayıcısıyla kısa bir tek seferlik Prompt çalıştırın:

    ```bash theme={null}
    pi --provider cometapi-responses --model your-model-id -p "Reply with one short sentence confirming the Responses connection."
    ```

    Pi'nin Chat Completions sağlayıcısı için görebildiği modelleri listeleyin:

    ```bash theme={null}
    pi --list-models cometapi-chat
    ```

    Chat Completions sağlayıcısıyla kısa bir tek seferlik Prompt çalıştırın:

    ```bash theme={null}
    pi --provider cometapi-chat --model your-model-id -p "Reply with one short sentence confirming the Chat Completions connection."
    ```

    Etkileşimli kullanım için projenizde Pi'yi başlatın ve `/model` ile CometAPI sağlayıcısını ve modelini seçin. Etkileşimli bir oturum sırasında `models.json` dosyasını düzenlerseniz, Pi'nin özel model girdilerini yeniden yüklemesi için `/model` komutunu tekrar açın.
  </Step>
</Steps>

## Sorun giderme

<AccordionGroup>
  <Accordion title="Pi, CometAPI modelini göstermiyor">
    `~/.pi/agent/models.json` dosyasının geçerli JSON olduğunu ve her provider girişinin üst düzey `providers` nesnesinin içinde olduğunu doğrulayın. Dosyayı kaydettikten sonra `pi --list-models cometapi-responses` veya `pi --list-models cometapi-chat` komutunu çalıştırın.
  </Accordion>

  <Accordion title="Pi, kullanılabilir bir API anahtarı olmadığını bildiriyor">
    `COMETAPI_KEY` değişkeninin Pi'yi başlatan aynı shell oturumunda ayarlandığını doğrulayın. Bir shell profili kullanıyorsanız, Pi'yi çalıştırmadan önce yeni bir terminal açın veya profili source edin.
  </Accordion>

  <Accordion title="İstekler base URL nedeniyle başarısız oluyor">
    `models.json` içinde `baseUrl` olarak `https://api.cometapi.com/v1` kullanın. Pi'yi dashboard URL'sine yönlendirmeyin ve OpenAI-compatible route'lar için `/v1` son ekini kaldırmayın.
  </Accordion>

  <Accordion title="Pi, model isteği göndermeden önce başarısız oluyor">
    Node.js sürümünüzü `node --version` ile kontrol edin. Pi paketi Node.js `>=22.19.0` gerektirir.
  </Accordion>

  <Accordion title="Model bir route'ta çalışıyor ama diğerinde çalışmıyor">
    Modelinizin desteklediği route ile `api` alanı eşleşen provider girişini kullanın. `openai-responses` Responses API'yi kullanırken, `openai-completions` Chat Completions kullanır.
  </Accordion>

  <Accordion title="Pi'nin beklenenden daha fazla erişimi var">
    Pi, onu başlatan kullanıcı ve sürecin izinleriyle çalışır. Dosyalar, süreçler, ağ erişimi veya kimlik bilgileri etrafında daha güçlü sınırlar gerektiğinde Pi'yi bir container ya da sandbox içinde çalıştırın.
  </Accordion>
</AccordionGroup>

## İlgili kaynaklar

* [CometAPI hızlı başlangıç](/tr/overview/quick-start)
* [CometAPI Models sayfası](/tr/overview/models)
* [Pi özel modelleri](https://github.com/earendil-works/pi/blob/main/packages/coding-agent/docs/models.md)
* [Pi CLI kullanımı](https://github.com/earendil-works/pi/blob/main/packages/coding-agent/docs/usage.md)

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/pi#howto",
        "name": "Pi'yi CometAPI ile kullanın",
        "description": "Base URL, API key ve model veya provider seçeneklerini ayarlayarak Pi'yi CometAPI ile yapılandırmak için bu kılavuzu kullanın.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/pi#step-1",
            "position": 1,
            "name": "Pi'yi yükleyin",
            "text": "Pi'yi CometAPI ile kullanın kılavuzundaki Pi'yi yükleyin adımını tamamlayın."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/pi#step-2",
            "position": 2,
            "name": "CometAPI API key'inizi ayarlayın",
            "text": "CometAPI API key'inizi, entegrasyon tarafından kullanılan environment variable veya ayar alanında saklayın."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/pi#step-3",
            "position": 3,
            "name": "CometAPI provider'larını models.json dosyasına ekleyin",
            "text": "Pi'yi CometAPI ile kullanın kılavuzundaki CometAPI provider'larını models.json dosyasına ekleyin adımını tamamlayın."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/pi#step-4",
            "position": 4,
            "name": "Her iki provider'ı doğrulayın",
            "text": "Pi'yi CometAPI ile kullanın kılavuzundaki Her iki provider'ı doğrulayın adımını tamamlayı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": "Pi'yi CometAPI ile kullanın",
            "item": "https://apidoc.cometapi.com/integrations/pi"
          }
        ]
      }
    ]
    }
    `}
</script>