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

# Promptfoo'yu CometAPI ile kullanın

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

[Promptfoo](https://www.promptfoo.dev/), prompt değerlendirmesi, regresyon testi ve AI red teaming için bir framework'tür. Promptfoo, CometAPI'yi OpenAI uyumlu endpoint'ler üzerinden çağıran bir `cometapi` provider içerir.

## Ön koşullar

* Node.js 18+
* Promptfoo'nun yerel olarak kurulmuş olması veya `npx` üzerinden çalıştırılması
* Etkin bir API key'e sahip bir CometAPI hesabı — [sizinkini dashboard'dan alın](https://www.cometapi.com/console/token)
* [CometAPI Models sayfasından](/tr/overview/models) bir model ID

## Entegrasyonu yapılandırın

<Steps>
  <Step title="CometAPI API key'inizi ayarlayın">
    Değerlendirmeleri çalıştırmadan önce `COMETAPI_KEY` ayarlayın:

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

  <Step title="Bir provider formatı seçin">
    Promptfoo, CometAPI için aşağıdaki provider ID formatını kullanır:

    ```yaml theme={null}
    providers:
      - cometapi:<type>:<model>
    ```

    Şu provider türlerini kullanın:

    | Type         | Use case                                          |
    | ------------ | ------------------------------------------------- |
    | `chat`       | Chat completions, vision ve multimodal prompt'lar |
    | `completion` | Metin tamamlama modelleri                         |
    | `embedding`  | Metin embedding değerlendirmeleri                 |
    | `image`      | Görsel üretimi değerlendirmeleri                  |

    Varsayılan chat modu için `cometapi:your-model-id` de kullanabilirsiniz.
  </Step>

  <Step title="Bir CLI değerlendirmesi çalıştırın">
    Aşağıdaki komut, tek prompt'lu bir chat değerlendirmesi çalıştırır:

    ```bash theme={null}
    npx promptfoo@latest eval \
      --prompts "Write a concise release note for {{feature}}" \
      --vars feature="a unified API dashboard" \
      -r cometapi:chat:your-model-id
    ```
  </Step>

  <Step title="Bir Promptfoo yapılandırma dosyası oluşturun">
    Aşağıdaki `promptfooconfig.yaml`, aynı prompt'u bir CometAPI modeline karşı değerlendirir:

    ```yaml theme={null}
    prompts:
      - "Classify this support request: {{message}}"

    providers:
      - id: cometapi:chat:your-model-id
        config:
          temperature: 0.2
          max_tokens: 256

    tests:
      - vars:
          message: "The API key works locally but fails in production."
        assert:
          - type: contains-any
            value:
              - authentication
              - configuration
    ```

    Yapılandırma dosyasını Promptfoo ile çalıştırın:

    ```bash theme={null}
    npx promptfoo@latest eval -c promptfooconfig.yaml
    ```
  </Step>
</Steps>

## Provider örnekleri

Değerlendirmek istediğiniz model davranışına uygun bir provider türü kullanın:

```yaml theme={null}
providers:
  - cometapi:chat:your-model-id
  - cometapi:completion:your-model-id
  - cometapi:embedding:your-model-id
  - cometapi:image:your-model-id
```

Multimodal testler için `chat` provider türünü koruyun ve görsel değişkenlerini Promptfoo test değişkenleri üzerinden geçirin.

## Sorun giderme

<AccordionGroup>
  <Accordion title="Promptfoo API key'i bulamıyor">
    `COMETAPI_KEY` değişkeninin, `promptfoo eval` komutunu çalıştırdığınız aynı shell oturumunda export edildiğini doğrulayın.
  </Accordion>

  <Accordion title="Provider türü modelle eşleşmiyor">
    Konuşma tabanlı ve multimodal modeller için `chat`, embedding modelleri için `embedding`, görsel üretim modelleri için ise `image` kullanın.
  </Accordion>

  <Accordion title="model ID başarısız oluyor">
    `your-model-id` değerini [CometAPI Models sayfasındaki](/tr/overview/models) tam bir model ID ile değiştirin.
  </Accordion>
</AccordionGroup>

## İlgili kaynaklar

* [Promptfoo CometAPI sağlayıcısı](https://www.promptfoo.dev/docs/providers/cometapi/)
* [CometAPI hızlı başlangıç](/tr/overview/quick-start)
* [CometAPI Models sayfası](/tr/overview/models)

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/promptfoo#howto",
        "name": "Promptfoo'yu CometAPI ile kullanın",
        "description": "Bu kılavuzu, base URL, API key ve model veya provider seçeneklerini ayarlayarak Promptfoo'yu CometAPI ile yapılandırmak için kullanın.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/promptfoo#step-1",
            "position": 1,
            "name": "CometAPI API key'inizi ayarlayın",
            "text": "CometAPI API key'inizi, entegrasyon tarafından kullanılan environment variable veya settings alanında saklayın."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/promptfoo#step-2",
            "position": 2,
            "name": "Bir provider biçimi seçin",
            "text": "Promptfoo'yu CometAPI ile kullanın kılavuzundaki Bir provider biçimi seçin adımını tamamlayın."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/promptfoo#step-3",
            "position": 3,
            "name": "Bir CLI değerlendirmesi çalıştırın",
            "text": "Promptfoo'yu CometAPI ile kullanın kılavuzundaki Bir CLI değerlendirmesi çalıştırın adımını tamamlayın."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/promptfoo#step-4",
            "position": 4,
            "name": "Bir Promptfoo yapılandırma dosyası oluşturun",
            "text": "Promptfoo'yu CometAPI ile kullanın kılavuzundaki Bir Promptfoo yapılandırma dosyası oluşturun adımını tamamlayın."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "CometAPI Belgeleri",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Entegrasyonlar",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Promptfoo'yu CometAPI ile kullanın",
            "item": "https://apidoc.cometapi.com/integrations/promptfoo"
          }
        ]
      }
    ]
    }
    `}
</script>