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

# Użyj Promptfoo z CometAPI

> Skorzystaj z tego przewodnika, aby skonfigurować Promptfoo z CometAPI poprzez ustawienie base URL, klucza API oraz opcji model lub provider.

[Promptfoo](https://www.promptfoo.dev/) to framework do oceny promptów, testów regresji i AI red teaming. Promptfoo zawiera provider `cometapi`, który wywołuje CometAPI przez endpointy zgodne z OpenAI.

## Wymagania wstępne

* Node.js 18+
* Promptfoo zainstalowany lokalnie lub uruchamiany przez `npx`
* Konto CometAPI z aktywnym kluczem API — [pobierz go w panelu](https://www.cometapi.com/console/token)
* model ID ze strony [CometAPI Models](/pl/overview/models)

## Skonfiguruj integrację

<Steps>
  <Step title="Ustaw klucz API CometAPI">
    Ustaw `COMETAPI_KEY` przed uruchomieniem ocen:

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

  <Step title="Wybierz format provider">
    Promptfoo używa następującego formatu provider ID dla CometAPI:

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

    Użyj tych typów provider:

    | Type         | Use case                                           |
    | ------------ | -------------------------------------------------- |
    | `chat`       | Chat completions, vision i promptów multimodalnych |
    | `completion` | Modele uzupełniania tekstu                         |
    | `embedding`  | Oceny osadzania tekstu                             |
    | `image`      | Oceny generowania obrazów                          |

    Możesz również użyć `cometapi:your-model-id` dla domyślnego trybu chat.
  </Step>

  <Step title="Uruchom ocenę z CLI">
    Następujące polecenie uruchamia ocenę chat z jednym promptem:

    ```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="Utwórz plik konfiguracyjny Promptfoo">
    Następujący plik `promptfooconfig.yaml` ocenia ten sam prompt względem modelu CometAPI:

    ```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
    ```

    Uruchom plik konfiguracyjny za pomocą Promptfoo:

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

## Przykłady provider

Użyj typu provider, który odpowiada zachowaniu modelu, jakie chcesz ocenić:

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

W testach multimodalnych zachowaj typ provider `chat` i przekazuj zmienne obrazów przez zmienne testowe Promptfoo.

## Rozwiązywanie problemów

<AccordionGroup>
  <Accordion title="Promptfoo nie może znaleźć klucza API">
    Potwierdź, że `COMETAPI_KEY` jest wyeksportowany w tej samej sesji powłoki, w której uruchamiasz `promptfoo eval`.
  </Accordion>

  <Accordion title="Typ provider nie pasuje do modelu">
    Użyj `chat` dla modeli konwersacyjnych i multimodalnych, `embedding` dla modeli embedding, a `image` dla modeli generowania obrazów.
  </Accordion>

  <Accordion title="model ID nie działa">
    Zastąp `your-model-id` dokładnym model ID ze strony [CometAPI Models](/pl/overview/models).
  </Accordion>
</AccordionGroup>

## Powiązane zasoby

* [Dostawca CometAPI dla Promptfoo](https://www.promptfoo.dev/docs/providers/cometapi/)
* [Szybki start CometAPI](/pl/overview/quick-start)
* [Strona modeli CometAPI](/pl/overview/models)

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/promptfoo#howto",
        "name": "Używanie Promptfoo z CometAPI",
        "description": "Skorzystaj z tego przewodnika, aby skonfigurować Promptfoo z CometAPI poprzez ustawienie podstawowego URL, klucza API oraz opcji model lub provider.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/promptfoo#step-1",
            "position": 1,
            "name": "Ustaw klucz API CometAPI",
            "text": "Zapisz klucz API CometAPI w zmiennej środowiskowej lub polu ustawień używanym przez integrację."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/promptfoo#step-2",
            "position": 2,
            "name": "Wybierz format provider",
            "text": "Wykonaj krok Wybierz format provider w przewodniku Używanie Promptfoo z CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/promptfoo#step-3",
            "position": 3,
            "name": "Uruchom ocenę CLI",
            "text": "Wykonaj krok Uruchom ocenę CLI w przewodniku Używanie Promptfoo z CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/promptfoo#step-4",
            "position": 4,
            "name": "Utwórz plik konfiguracyjny Promptfoo",
            "text": "Wykonaj krok Utwórz plik konfiguracyjny Promptfoo w przewodniku Używanie Promptfoo z CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "Dokumentacja CometAPI",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Integracje",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Używanie Promptfoo z CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/promptfoo"
          }
        ]
      }
    ]
    }
    `}
</script>