Przejdź do głównej treści
Polski— Wybierz język
Menu

Podłącz swojego GPT do zewnętrznych API

Lekcja 9 z 17 Zaktualizowano 5 listopada 2026 Średnio zaawansowani
Na tej stronie
  1. Wyjście poza izolowanego GPT-a
  2. Czym jest akcja?
  3. Schemat OpenAPI
  4. Konfigurowanie akcji w edytorze GPT
  5. Czas na Ciebie: Publiczne API
  6. Kluczowe wnioski

Stan na 5 listopada 2026 r.: GPT-y są w ostatnich tygodniach swojego istnienia. OpenAI wycofuje niestandardowe GPT-y 11 grudnia 2026 r. (11 lutego 2027 r. dla wybranych przestrzeni roboczych Enterprise z wyjątkiem). Konta osobiste, Free, Go, Plus i Pro nie mogą już tworzyć ani publikować nowych GPT-ów; w przestrzeniach roboczych Business, Enterprise i Edu tworzenie zależy od ustawień, a w dotkniętych tym przestrzeniach Enterprise ustało 26 października 2026 r. Istniejące GPT-y pozostają używalne i edytowalne, jeśli Twój plan na to pozwala, aż do momentu wycofania; Twoje rozmowy z nimi będą nadal dostępne. Migracja (Migrate to plugin, w sekcji My GPTs) konwertuje instrukcje na umiejętność (skill), bazę wiedzy na pliki referencyjne, a podłączone aplikacje na aplikacje; niestandardowe akcje nie są przenoszone. Ta lekcja wyjaśnia, jak działają GPT-y, aby pomóc Ci je utrzymać, migrować i dostosować ich zasady działania do wtyczki (lekcje 15–17).

Wyjście poza izolowanego GPT-a

Do tej pory Twój GPT działał w izolacji: jego instrukcje definiują zachowanie, a Wiedza dostarcza dokumentów. To potężne narzędzie, ale pozostaje odcięte od żywego świata. Nie może sprawdzić Twojego CRM-u w czasie rzeczywistym, utworzyć wydarzenia w kalendarzu ani odpytać bazy danych – wie tylko tyle, co przesłałeś, w stanie zamrożonym w momencie przesyłania. Akcje usuwają to ograniczenie: pozwalają Twojemu GPT-owi wywoływać zewnętrzne API, aby odczytywać i zapisywać dane w Twoich narzędziach podczas rozmowy.

Czym jest akcja?

Akcja to połączenie między Twoim GPT-em a usługą zewnętrzną poprzez jej API. Przepływ jest zawsze taki sam: użytkownik zadaje pytanie lub wydaje polecenie, GPT rozpoznaje, że potrzebuje zewnętrznych danych, aby odpowiedzieć, wywołuje API usługi, otrzymuje odpowiedź i integruje ją z finalną odpowiedzią. Weźmy pod uwagę GPT-a sprzedażowego podłączonego do CRM-u: gdy użytkownik pyta: „Jaki jest status sprawy Dupont?“, GPT odpytuje API CRM-u, pobiera rekord klienta i odpowiada danymi z dzisiaj – a nie wspomnieniem pliku przesłanego trzy miesiące temu. Wszystko to dzieje się przezroczyście dla użytkownika, który ma po prostu wrażenie rozmowy z dobrze poinformowanym asystentem.

Schemat OpenAPI

Aby GPT mógł wywołać API, musisz je opisać. Tę rolę pełni schemat OpenAPI (dawniej Swagger), plik JSON lub YAML służący jako instrukcja obsługi API. Opisuje on punkty końcowe (endpoints) – adresy URL, które GPT może wywołać – powiązane metody (GET do odczytu, POST do tworzenia, PUT do aktualizacji, DELETE do usuwania), parametry oczekiwane przez każdy punkt końcowy oraz format zwracanych odpowiedzi. Na podstawie tego dokumentu GPT samodzielnie decyduje podczas rozmowy, który punkt końcowy wywołać i z jakimi parametrami.

Oto jak wygląda minimalny schemat dla fikcyjnego API pogodowego:

openapi: 3.1.0
info:
  title: Weather API
  version: 1.0.0
servers:
  - url: https://example.com
paths:
  /forecast:
    get:
      operationId: getForecast
      summary: Get weather forecast for a city
      parameters:
        - name: city
          in: query
          required: true
          schema:
            type: string
      responses:
        "200":
          description: Weather forecast

Dobra wiadomość: prawie nigdy nie będziesz musiał pisać tego pliku od zera. Wiele usług publikuje swój schemat OpenAPI bezpośrednio w dokumentacji API. Jeśli go nie ma, narzędzia takie jak Swagger Editor – lub sam ChatGPT, jeśli opiszesz mu API – mogą go wygenerować. A jeśli Twój zespół techniczny pracuje z Postmanem, jego kolekcje eksportują się do formatu OpenAPI.

Konfigurowanie akcji w edytorze GPT

Konfiguracja odbywa się w edytorze GPT w przeglądarce: przejdź do sekcji Actions, kliknij Create new action, wklej swój schemat OpenAPI do odpowiedniego pola, skonfiguruj uwierzytelnianie (omówione w następnej lekcji), a następnie przetestuj akcję z poziomu panelu podglądu.

Jakość Twojego schematu determinuje jakość wywołań. Miej na uwadze trzy nawyki. Po pierwsze, nadawaj jawne nazwy wartościom operationId: GPT polega na nich, aby zdecydować, którą akcję wywołać, a getForecast prowadzi go znacznie lepiej niż op_42. Następnie pisz jasne opisy dla każdego punktu końcowego i parametru – językiem naturalnym, jakbyś wyjaśniał API koledze. Wreszcie, udostępniaj tylko te punkty końcowe, których naprawdę potrzebujesz: jeśli Twój GPT potrzebuje tylko dwóch lub trzech tras, nie wystawiaj wszystkich czterdziestu tras pełnego API. Każdy udostępniony punkt końcowy zajmuje miejsce w kontekście GPT-a i zwiększa ryzyko, że wybierze on niewłaściwy.

Akcja w czterech krokach Cztery kroki: opisz API za pomocą schematu OpenAPI w formacie JSON lub YAML; wybierz uwierzytelnianie: brak, klucz lub OAuth; przetestuj w podglądzie; następnie GPT wywołuje API, gdy jest to potrzebne. PODŁĄCZ API Akcja w czterech krokach 1 Schemat OpenAPI, JSON lub YAML 2 Dostęp Brak, klucz lub OAuth 3 Test W podglądzie 4 Użycie GPT wywołuje API Brak akcji w trybie Pro, a akcje nie są przenoszone do wtyczki.
Na podstawie artykułu „Configuring actions in GPTs“ z Centrum Pomocy OpenAI (listopad 2026).

Czas na Ciebie: Publiczne API

Twoja pierwsza akcja lub jej plan. Najlepszym poligonem doświadczalnym jest darmowe, publiczne API – pogodowe, kursów walut, wiadomości – które nie wymaga złożonego uwierzytelniania. Wybierz jedno, pobierz lub stwórz jego schemat OpenAPI i dodaj je jako akcję w swoim GPT-cie. Nie zapomnij powiązać akcji z instrukcjami, określając, kiedy jej użyć: „Gdy użytkownik pyta o pogodę, użyj akcji getForecast“. Następnie przetestuj to, używając kilku różnych sformułowań, aby upewnić się, że GPT wywołuje akcję we właściwym momencie.

Na pierwsze próby czyhają pułapki. Źle sformatowany schemat – choćby jeden brakujący przecinek w JSON-ie – blokuje wszystko: zawsze waliduj swój schemat w Swagger Editor przed wklejeniem. Brakujące opisy oślepiają GPT-a: bez nich nie wie, kiedy akcja jest istotna. Zaplanuj też obsługę błędów API, które prędzej czy później wystąpią: określ zachowanie w instrukcjach, na przykład: „Jeśli API nie odpowiada, powiedz użytkownikowi, aby spróbował później“ – w przeciwnym razie GPT będzie improwizował, czasem wymyślając dane. I nie polegaj wyłącznie na panelu podglądu: testuj w rzeczywistych warunkach, z prawdziwymi danymi i rzeczywistymi sformułowaniami użytkowników.

Zanim zaczniesz, poznaj dwa ograniczenia: GPT używa podłączonych aplikacji lub akcji, ale nie obu naraz, a akcje nie działają w trybie Pro. Co najważniejsze, niestandardowe akcje nie są przenoszone do wtyczki podczas migracji: najpierw sprawdź, czy katalog wtyczek oferuje już aplikację dla Twojej docelowej usługi; jeśli nie, będziesz musiał odbudować integrację, na przykład za pomocą serwera MCP.

Źródła oficjalne: Configuring actions in GPTs (Centrum Pomocy OpenAI: uwierzytelnianie, schemat OpenAPI, testowanie, limity) · Custom GPT retirement and migration FAQ (akcje nie są przenoszone) · OpenAPI Specification (format schematu)

Kluczowe wnioski

  • Akcje łączą Twojego GPT-a z usługami zewnętrznymi poprzez ich API
  • Musisz dostarczyć schemat OpenAPI opisujący dostępne punkty końcowe
  • Opisy w schemacie są kluczowe – GPT używa ich do decyzji, którą akcję wywołać
  • Zacznij od darmowego, publicznego API, aby oswoić się z procesem
  • Ogranicz liczbę udostępnionych punktów końcowych do ścisłego minimum wymaganego dla Twojego przypadku użycia