> ## 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żywanie Pi z CometAPI

> Skorzystaj z tego przewodnika, aby skonfigurować Pi z CometAPI, ustawiając bazowy URL, klucz API oraz opcje modelu lub dostawcy.

[Pi](https://github.com/earendil-works/pi) to projekt Pi Agent Harness. Jego pakiet `@earendil-works/pi-coding-agent` udostępnia interaktywny agent CLI do kodowania z obsługą workflow opartych na plikach, shell, edit, write, session, print, JSON, RPC oraz SDK. Pi może ładować niestandardowych dostawców z `~/.pi/agent/models.json`, więc możesz dodać CometAPI jako wpisy dostawcy zgodnego z OpenAI bez zmiany kodu źródłowego Pi.

Oficjalne materiały:

* [Repozytorium Pi](https://github.com/earendil-works/pi)
* [Szybki start Pi](https://github.com/earendil-works/pi/blob/main/packages/coding-agent/docs/quickstart.md)
* [Dostawcy Pi](https://github.com/earendil-works/pi/blob/main/packages/coding-agent/docs/providers.md)
* [Niestandardowe modele Pi](https://github.com/earendil-works/pi/blob/main/packages/coding-agent/docs/models.md)
* [Użycie CLI Pi](https://github.com/earendil-works/pi/blob/main/packages/coding-agent/docs/usage.md)

<Note>
  Dostępność modeli zmienia się z czasem. Zastąp `your-model-id` dostępnym model ID ze strony [CometAPI Models page](/pl/overview/models).
</Note>

## Wymagania wstępne

* Node.js `>=22.19.0`
* npm
* Konto CometAPI z aktywnym kluczem API z [panelu](https://www.cometapi.com/console/token)
* Pi zainstalowane z oficjalnego pakietu npm

## Zrozumienie uprawnień środowiska uruchomieniowego

Pi działa z uprawnieniami użytkownika i procesu, który je uruchamia. Uruchamiaj Pi w katalogu projektu, nad którym ma pracować, zachowaj ścieżkę wycofania zmian, na przykład git, i użyj kontenera lub sandboxa, jeśli potrzebujesz silniejszych granic dla systemu plików, procesów, sieci lub poświadczeń.

## Skonfiguruj dostawcę

<Steps>
  <Step title="Zainstaluj Pi">
    Zainstaluj Pi globalnie za pomocą npm:

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

    Potwierdź, że CLI jest dostępne:

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

  <Step title="Ustaw swój klucz API CometAPI">
    Zapisz swój klucz API CometAPI w zmiennej środowiskowej `COMETAPI_KEY`:

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

    Dodaj polecenie export do profilu swojej powłoki, jeśli chcesz, aby ustawienie było zachowywane między sesjami terminala. Nie zapisuj kluczy API w systemie kontroli wersji.
  </Step>

  <Step title="Dodaj dostawców CometAPI do models.json">
    Utwórz `~/.pi/agent/models.json`, jeśli jeszcze nie istnieje. Jeśli plik zawiera już dostawców, scal wpisy `cometapi-responses` i `cometapi-chat` z istniejącym obiektem `providers`:

    ```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"
            }
          ]
        }
      }
    }
    ```

    Użyj `cometapi-responses` dla modeli lub workflow, które wymagają OpenAI Responses API. Użyj `cometapi-chat` dla modeli zgodnych z OpenAI Chat Completions. Pi rozwiązuje `$COMETAPI_KEY` w momencie wykonywania żądania. Przechowuj klucz API w swoim środowisku lub we własnym workflow zarządzania sekretami.
  </Step>

  <Step title="Zweryfikuj obu dostawców">
    Wyświetl listę modeli, które Pi widzi dla dostawcy Responses:

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

    Uruchom krótki jednorazowy Prompt z dostawcą Responses:

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

    Wyświetl listę modeli, które Pi widzi dla dostawcy Chat Completions:

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

    Uruchom krótki jednorazowy Prompt z dostawcą Chat Completions:

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

    Do użytku interaktywnego uruchom Pi w swoim projekcie i wybierz dostawcę oraz model CometAPI za pomocą `/model`. Jeśli edytujesz `models.json` podczas sesji interaktywnej, otwórz ponownie `/model`, aby Pi przeładowało niestandardowe wpisy modeli.
  </Step>
</Steps>

## Rozwiązywanie problemów

<AccordionGroup>
  <Accordion title="Pi nie pokazuje modelu CometAPI">
    Potwierdź, że `~/.pi/agent/models.json` jest prawidłowym JSON-em oraz że każdy wpis providera znajduje się w obiekcie najwyższego poziomu `providers`. Po zapisaniu pliku uruchom `pi --list-models cometapi-responses` lub `pi --list-models cometapi-chat`.
  </Accordion>

  <Accordion title="Pi zgłasza, że żaden klucz API nie jest dostępny">
    Potwierdź, że `COMETAPI_KEY` jest ustawiony w tej samej sesji shella, z której uruchamiasz Pi. Jeśli używasz profilu shella, otwórz nowy terminal lub wczytaj profil przed uruchomieniem Pi.
  </Accordion>

  <Accordion title="Żądania kończą się niepowodzeniem z powodu bazowego URL">
    Użyj `https://api.cometapi.com/v1` jako `baseUrl` w `models.json`. Nie kieruj Pi na URL dashboardu i nie pomijaj sufiksu `/v1` dla tras zgodnych z OpenAI.
  </Accordion>

  <Accordion title="Pi kończy działanie przed wysłaniem żądania do modelu">
    Sprawdź wersję Node.js za pomocą `node --version`. Pakiet Pi wymaga Node.js `>=22.19.0`.
  </Accordion>

  <Accordion title="Model działa na jednej trasie, ale nie na drugiej">
    Użyj wpisu providera, którego pole `api` odpowiada trasie obsługiwanej przez Twój model. `openai-responses` używa API Responses, a `openai-completions` używa Chat Completions.
  </Accordion>

  <Accordion title="Pi ma większy dostęp, niż oczekiwano">
    Pi działa z uprawnieniami użytkownika i procesu, które go uruchomiły. Uruchom Pi w kontenerze lub sandboxie, gdy potrzebujesz silniejszych ograniczeń dotyczących plików, procesów, dostępu do sieci lub poświadczeń.
  </Accordion>
</AccordionGroup>

## Powiązane zasoby

* [Szybki start CometAPI](/pl/overview/quick-start)
* [Strona modeli CometAPI](/pl/overview/models)
* [Niestandardowe modele Pi](https://github.com/earendil-works/pi/blob/main/packages/coding-agent/docs/models.md)
* [Użycie Pi CLI](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": "Używanie Pi z CometAPI",
        "description": "Skorzystaj z tego przewodnika, aby skonfigurować Pi z CometAPI poprzez ustawienie bazowego URL, klucza API oraz opcji modelu lub dostawcy.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/pi#step-1",
            "position": 1,
            "name": "Zainstaluj Pi",
            "text": "Wykonaj krok Zainstaluj Pi w przewodniku Używanie Pi z CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/pi#step-2",
            "position": 2,
            "name": "Ustaw swój klucz API CometAPI",
            "text": "Zapisz swój klucz API CometAPI w zmiennej środowiskowej lub polu ustawień używanym przez integrację."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/pi#step-3",
            "position": 3,
            "name": "Dodaj dostawców CometAPI do models.json",
            "text": "Wykonaj krok Dodaj dostawców CometAPI do models.json w przewodniku Używanie Pi z CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/pi#step-4",
            "position": 4,
            "name": "Zweryfikuj obu dostawców",
            "text": "Wykonaj krok Zweryfikuj obu dostawców w przewodniku Używanie Pi 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 Pi z CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/pi"
          }
        ]
      }
    ]
    }
    `}
</script>