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

Od Apps SDK do wtyczek ChatGPT

Lekcja 1 z 14 Zaktualizowano 3 listopada 2026 Programista
Na tej stronie
  1. Czym jest wtyczka?
  2. A co z „Apps SDK“?
  3. Cztery możliwe formy
  4. Gdzie działa wtyczka
  5. Co zbudujesz
  6. Kluczowe wnioski

Kurs przepisany 3 listopada 2026 r. na podstawie dokumentacji Wtyczek firmy OpenAI. Poprzednia wersja opierała się na nieistniejącym pakiecie @openai/apps-sdk (zawierającym defineAction, defineWidget oraz manifest chatgpt-app.json). Teraz aplikacje ChatGPT budujesz, korzystając z protokołu MCP, jego oficjalnych zestawów SDK oraz standardu interfejsu MCP Apps. Przepisaliśmy wszystkie czternaście lekcji i usunęliśmy niewspierane listy kompatybilności modeli, struktury prowizji oraz kroki publikacji ze starej wersji. Źródła: Szybki start · Architektura wtyczek.

Czym jest wtyczka?

Wtyczka to pakiet, który odkrywasz, instalujesz, udostępniasz i publikujesz wewnątrz ChatGPT oraz Codex. Rozszerza ona możliwości asystenta, dostarczając nową wiedzę, narzędzia lub jedno i drugie. Dokumentacja OpenAI wyróżnia cztery elementy składowe:

  • Umiejętności (Skills), które dostarczają modelowi instrukcji i zasobów do obsługi powtarzalnych przepływów pracy;
  • Serwer MCP, który udostępnia narzędzia i łączy asystenta z systemami zewnętrznymi – Twoim API, bazą danych lub usługą;
  • Oba elementy, gdy model potrzebuje zarówno instrukcji postępowania, jak i możliwości świadczonych przez Twoją infrastrukturę;
  • Haki cyklu życia (Lifecycle hooks), czyli polecenia wykonywane w określonych momentach środowiska uruchomieniowego Codex, w tym w ramach ChatGPT Work.

ChatGPT i Codex współdzielą jeden katalog wtyczek: wtyczka publiczna jest publikowana raz i staje się widoczna we wszystkich kompatybilnych miejscach obu produktów. Niektóre możliwości pozostają specyficzne dla danej powierzchni – na przykład skrypt haka musi istnieć w środowisku uruchomieniowym, więc zainstalowanie wtyczki w wersji internetowej nie powoduje jej automatycznego wdrożenia w tym miejscu.

A co z „Apps SDK“?

Termin ten odnosi się do zestawu narzędzi OpenAI do budowania aplikacji wewnątrz ChatGPT: protokołu MCP i jego oficjalnych zestawów SDK, otwartego standardu MCP Apps, który ChatGPT implementuje do renderowania interfejsów, rozszerzeń specyficznych dla ChatGPT, systemu projektowania (@openai/apps-sdk-ui) oraz repozytorium przykładów. Dokumentacja grupuje teraz te elementy pod hasłem „Wtyczki ChatGPT i Apps SDK“: aplikacja koncentruje się na serwerze MCP, zawiera opcjonalny interfejs i jest dystrybuowana jako część wtyczki.

Wybór protokołu MCP jest świadomy. Model Context Protocol to otwarta specyfikacja służąca do łączenia klientów AI z narzędziami i danymi. Serwer, który napiszesz dla ChatGPT, komunikuje się w protokole zrozumiałym dla innych hostów, a interfejs zgodny z MCP Apps działa w każdym hoście obsługującym ten standard.

Cztery możliwe formy

Zacznij od najmniejszej formy, która pokrywa Twoje przypadki użycia; serwer lub interfejs możesz dodać później, nie zmieniając głównego celu wtyczki.

FormaWybierz ją, gdy
Tylko umiejętnościIstniejące instrukcje i narzędzia wystarczają do obsługi przepływu pracy
Tylko serwer MCPWtyczka potrzebuje narzędzi MCP, ale nie wymaga dodatkowych instrukcji przepływu pracy
Umiejętności i serwer MCPUmiejętności muszą prowadzić model przez przepływy pracy wykorzystujące Twoje narzędzia
Serwer MCP z interfejsemInterakcja wizualna znacząco poprawia część przepływu pracy

Wtyczka sporządzająca notatki ze spotkań zgodnie z zasadami Twojej firmy może potrzebować tylko umiejętności. Gdy tylko musi odczytywać dane na żywo, uwierzytelniać użytkownika lub działać w systemie, którym zarządzasz, wymaga serwera MCP. Na koniec: interfejs nigdy nie jest obowiązkowy; narzędzie musi pozostać użyteczne nawet bez niego.

Gdzie działa wtyczka

W ChatGPT wywołujesz zainstalowaną wtyczkę bezpośrednio, wpisując @ w polu wprowadzania i wybierając ją z listy. Model może również wywołać ją automatycznie, gdy żądanie odpowiada jej narzędziom lub umiejętnościom. Przewodnik szybkiego startu OpenAI zaleca przetestowanie pierwszej wtyczki w ChatGPT Work, czyli w zakładce Work na stronie głównej ChatGPT w przeglądarce. Te same wtyczki pojawiają się w Codex, z ograniczeniami wynikającymi ze specyficznych możliwości każdej powierzchni.

Co zbudujesz

Ten kurs podąża ścieżką nakreśloną w dokumentacji. Zaczniesz od zdefiniowania swoich narzędzi w oparciu o potrzeby użytkowników, podłączysz pierwszy serwer MCP do ChatGPT, a następnie zbudujesz własny: dobrze udokumentowane narzędzia, interfejs MCP Apps tam, gdzie wnosi wartość, uwierzytelnianie OAuth dla danych prywatnych oraz, jeśli pasuje to do Twojego modelu biznesowego, proces zakupu z wykorzystaniem Checkout API. Kurs zakończysz pakowaniem, zasadami publikacji i zgłoszeniem do katalogu.

Kluczowe wnioski

  • Wtyczka łączy umiejętności, serwer MCP lub oba te elementy; interfejs jest opcjonalny
  • ChatGPT i Codex współdzielą jeden katalog wtyczek
  • „Apps SDK“ odnosi się do narzędzi OpenAI do budowania aplikacji: MCP, standardu MCP Apps, rozszerzeń ChatGPT i systemu projektowania
  • Nie istnieje pakiet @openai/apps-sdk: zacznij od oficjalnych zestawów SDK dla MCP
  • Wybierz najmniejszą formę wtyczki, która pokrywa Twoje przypadki użycia