Optymalizacja: metadane, umiejętności i zdarzenia
Na tej stronie
Lekcja przepisana 3 listopada 2026 r. na podstawie dokumentacji wtyczek OpenAI: Optimize Metadata, Build Skills, MCP Events oraz Plugin Extensions. Poprzednia wersja tej lekcji opierała się na nieistniejących modułach
analyticsiexperimentz SDK. Źródła: Optimize Metadata · Build Skills · MCP Events · Plugin Extensions.
Metadane to teksty produktowe
ChatGPT i Codex decydują, kiedy wywołać Twoje narzędzia, na podstawie dostarczonych metadanych. Dobrze napisane nazwy, opisy i parametry zapewniają, że narzędzie zostanie uruchomione wtedy, gdy jest potrzebne, i zapobiegają niepożądanym wywołaniom. OpenAI zaleca traktowanie tych metadanych jak tekstów produktowych: iteruj je, testuj i mierz ich skuteczność.
Zestaw referencyjnych promptów
Zanim dotkniesz metadanych, stwórz oznaczony zestaw testowych promptów:
- Prompty bezpośrednie, które wyraźnie wskazują Twój produkt lub źródło danych.
- Prompty pośrednie, które opisują pożądany rezultat bez nazywania Twojego narzędzia.
- Prompty negatywne, które powinny być obsłużone przez wbudowane narzędzia lub inne wtyczki.
Dla każdego promptu udokumentuj oczekiwane zachowanie: wywołaj Twoje narzędzie, nie rób nic lub przekaż sprawę innemu rozwiązaniu. Używaj tego zestawu do każdego testu regresji.
Metadane prowadzące model
- Nazwa powinna łączyć domenę z akcją, np.
calendar.create_event. - Opis powinien zaczynać się od „Używaj, gdy…“ i wyraźnie wymieniać przypadki wykluczone, np. „Nie używaj do przypomnień“.
- Każdy parametr musi być udokumentowany przykładami oraz listą dozwolonych wartości, jeśli dane wejściowe są ograniczone.
- Adnotacje muszą odzwierciedlać rzeczywiste zachowanie (zob. Lekcje 3 i 11).
Mierz, a następnie iteruj
Podłącz swój serwer, zainstaluj wtyczkę, uruchom zestaw promptów i zanotuj, które narzędzie zostało wybrane, jakie argumenty przekazano oraz czy wyświetlono jakiś komponent UI. Śledź dwie metryki: precyzję (czy wywołano właściwe narzędzie?) i pełność (czy narzędzie zostało wywołane za każdym razem, gdy powinno?). Najpierw dąż do wysokiej precyzji w przypadku promptów negatywnych, zanim zaczniesz gonić marginalne zyski w pełności.
Zmieniaj tylko jedno pole naraz, aby wyizolować czynnik wpływający na poprawę. Prowadź dziennik rewizji z datami i wynikami, a przed wdrożeniem poproś kogoś innego o przegląd zmian. W środowisku produkcyjnym przeglądaj użycie narzędzi co tydzień. Skok liczby potwierdzeń „niewłaściwe narzędzie“ zazwyczaj sygnalizuje dryf metadanych. Zbieraj opinie użytkowników i regularnie ponownie uruchamiaj testy promptów, zwłaszcza po dodaniu nowego narzędzia lub modyfikacji pola strukturalnego.
Umiejętności dla powtarzalnych przepływów pracy
Twój serwer dostarcza dane, uwierzytelnianie i kontrolowane akcje. Umiejętność (skill) zapewnia sekwencję wywołań narzędzi, punkty decyzyjne, formatowanie wyników, przykłady i szablony. Najszybszym sposobem na start jest wbudowany @skill-creator, w którym opisujesz cel użytkownika i narzędzia MCP, które go wspierają.
Solidny plik SKILL.md określa, jakie kroki należy podjąć, jaki rezultat powinien otrzymać użytkownik, jakich faktów model nie może zmyślać, kiedy zadawać pytania, zatrzymać się lub odmówić działania oraz z których plików korzystać. Preferuj skoncentrowaną umiejętność dla konkretnego przepływu pracy zamiast dużego zestawu rozproszonych instrukcji. Rozdzielaj przepływy pracy, które różnią się wyzwalaczem, danymi wejściowymi lub kryteriami sukcesu. Utrzymuj SKILL.md w zwięzłej formie, a szczegóły przechowuj gdzie indziej: użyj katalogu references/ dla polityk, schematów i przykładów; assets/ dla szablonów do kopiowania lub przekształcania; oraz scripts/ dla deterministycznych obliczeń – ale tylko wtedy, gdy istniejące instrukcje i narzędzia są niewystarczające.
Jeśli umiejętność zależy od serwera MCP, zadeklaruj tę zależność w pliku agents/openai.yaml. Udostępnia to narzędzie, ale nie zastępuje potrzeby jasnych instrukcji dotyczących tego, których narzędzi użyć, w jakiej kolejności i jak obsługiwać brakujące lub niejednoznaczne wyniki. W przypadku modelu GPT-6 Astra, OpenAI zaleca przegląd jego wytycznych dotyczących przestrzegania instrukcji: eliminuj niejasne lub sprzeczne dyrektywy i wyraźnie zaznacz, że instrukcje użytkownika mają pierwszeństwo przed instrukcjami umiejętności.
Przetestuj aktywację umiejętności i jakość wyników, używając promptów: bezpośrednich, pośrednich, niekompletnych (które powinny wywołać pytanie wyjaśniające), niezwiązanych z tematem oraz przypadków brzegowych, w których umiejętność musi unikać halucynacji lub działania poza swoim zakresem. Jeśli umiejętność aktywuje się w niewłaściwym momencie, popraw jej opis. Jeśli wybiera właściwy przepływ pracy, ale generuje niespójne wyniki, popraw jej instrukcje.
Zdarzenia MCP: Reagowanie na zmiany
Zdarzenia MCP (MCP Events) pozwalają ChatGPT subskrybować aktualizacje z Twojego serwera, takie jak nowe wiadomości, zmodyfikowana treść lub zmiany statusu. Użytkownik wybiera, co monitorować i jak ChatGPT powinien reagować po nadejściu aktualizacji – na przykład: „Monitoruj ten dokument i zastosuj poprawki requested w komentarzach“.
- Twój serwer wyświetla listę obsługiwanych zdarzeń.
- Użytkownik informuje ChatGPT, co monitorować i jak reagować.
- ChatGPT subskrybuje zdarzenia poprzez Twój serwer MCP, podając adres URL wywołania zwrotnego i sekret podpisu.
- Twój serwer wysyła odpowiednie zdarzenia na ten adres URL.
- ChatGPT otrzymuje zdarzenie w subskrybowanej konwersacji i postępuje zgodnie z instrukcjami użytkownika.
Funkcja ta jest dostępna w konwersacjach ChatGPT Work w przeglądarce internetowej oraz w aplikacji desktopowej z wybraną opcją Cloud. ChatGPT polega na dostarczaniu webhooków zgodnie z projektem specyfikacji MCP Events. Twój serwer musi trwale przechowywać subskrypcje i mieć możliwość łączenia się z adresami URL wywołania zwrotnego przez HTTPS.
Rozszerzenia interfejsu ChatGPT
Rozszerzenia MCP OpenAI pozwalają wtyczce integrować się z kluczowymi obszarami interfejsu ChatGPT: paskiem bocznym, obszarem wprowadzania tekstu i przeglądarkami plików. Wzmianki w obszarze wprowadzania tekstu są dostępne wyłącznie w aplikacji desktopowej. OpenAI publikuje przykładową wtyczkę Bits & Bolts, która demonstruje te rozszerzenia i śledzi ich wdrożenie. Jest to najlepszy punkt wyjścia do eksploracji tej funkcjonalności.
Kluczowe wnioski
- Traktuj metadane jak teksty produktowe: używaj referencyjnego zestawu promptów, śledź precyzję i pełność oraz zmieniaj tylko jedno pole naraz.
- Pisz opisy zaczynające się od „Używaj, gdy…“, wyraźnie wymieniaj przypadki wykluczone i dokumentuj wszystkie parametry.
- Twórz jedną skoncentrowaną umiejętność na każdy przepływ pracy, utrzymuj
SKILL.mdw zwięzłej formie, przechowuj zasoby oddzielnie i deklaruj zależności MCP. - Zdarzenia MCP subskrybują aktualizacje z Twojego serwera przez ChatGPT, dostarczane za pomocą webhooków.
- Rozszerzenia integrują Twoją wtyczkę z paskiem bocznym, obszarem wprowadzania tekstu i przeglądarkami plików.
Sprawdź swoją wiedzę
Od narzędzi MCP po publikację: upewnij się, że opanowałeś fundamenty.
1. Czy potrzebuję pakietu `@openai/apps-sdk`, aby utworzyć aplikację w ChatGPT?
Odpowiedź: Nie, taki pakiet nie istnieje. Budujesz serwer MCP, używając oficjalnych SDK protokołu (@modelcontextprotocol/sdk dla TypeScript, mcp dla Pythona), opcjonalnie dodajesz interfejs zgodny ze standardem MCP Apps i dystrybuujesz całość jako wtyczkę.
2. Czy narzędzie może istnieć bez interfejsu UI?
Odpowiedź: Tak, i powinno: narzędzie zwraca structuredContent i krótkie podsumowanie tekstowe, co wystarcza modelowi. Interfejs UI, dołączony przez _meta.ui.resourceUri, dodaje się tylko wtedy, gdy pomaga użytkownikom inspectować, porównywać, edytować, potwierdzać lub nawigować po informacjach.
3. Kto decyduje, czy użytkownik ma uprawnienia do dostępu do danych?
Odpowiedź: Serwer MCP decyduje o każdym żądaniu na podstawie zweryfikowanego tokena OAuth (podpis, wystawca, odbiorca, ważność, zakresy). Adnotacje pomagają ChatGPT wybrać odpowiedni poziom potwierdzenia, ale nigdy nie zastępują autoryzacji po stronie serwera.
4. Czy wtyczka może sprzedawać subskrypcję swojej usługi?
Odpowiedź: Nie. Zasady ograniczają handel do dóbr fizycznych. Istniejący subskrybent może się zalogować i korzystać z funkcji objętych jego planem. Wtyczka może wyjaśnić, że dana funkcja nie jest włączona, i podlinkować stronę informacyjną, ale nigdy nie może linkować do strony płatności.
5. Jak narzędzia aktualizują się dla opublikowanej wtyczki?
Odpowiedź: Bez nowego pliku ZIP: OpenAI ponownie skanuje serwer, a każde nowe lub zmodyfikowane narzędzie staje się dostępne po pomyślnym przejściu automatycznych sprawdzeń. Usunięte narzędzie znika natychmiast. Jednak metadane i umiejętności wymagają nowego pliku ZIP i nowej recenzji.
Dobrze opisane narzędzia, opcjonalne interfejsy UI, autoryzacja po stronie serwera i przestrzeganie zasad – to rama, która czyni wtyczkę niezawodną usługą w ChatGPT i Codex.