Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Optimizavimas: metaduomenys, įgūdžiai ir įvykiai

Paskaita 14 iš 14 Atnaujinta 2026 m. lapkričio 3 d. Kūrėjas
Šiame puslapyje
  1. Metaduomenys – tai produkto tekstas
  2. Įgūdžiai pasikartojantiems darbo eigoms
  3. MCP įvykiai: reakcija į pokyčius
  4. ChatGPT sąsajos plėtiniai
  5. Svarbiausi punktai
  6. Patikrinkite savo žinias

Pamoka perrašyta 2026 m. lapkričio 3 d. remiantis „OpenAI“ papildinių dokumentacijos puslapiais Optimize Metadata, Build Skills, MCP Events ir Plugin Extensions. Ankstesnė šios pamokos versija rėmėsi neegzistuojančio SDK moduliais analytics ir experiment. Šaltiniai: Optimize Metadata · Build Skills · MCP Events · Plugin Extensions.

Metaduomenys – tai produkto tekstas

ChatGPT ir Codex sprendžia, kada iškvieti tavo įrankius, remdamiesi tavo pateiktais metaduomenimis. gerai parašyti pavadinimai, aprašymai ir parametrai užtikrina, kad tavo įrankis bus iškvietas tik tada, kai reikia, ir neleis suveikti netinkamais atvejais. „OpenAI“ rekomenduoja traktuoti šiuos metaduomenis kaip produkto tekstą: juos reikia kartotinai tobulinti, testuoti ir vertinti jų veiksmingumą.

Etaloninis užklausų rinkinys

Prieš keisdami metaduomenis, sukurkite pažymėtą bandomųjų užklausų rinkinį:

  • Tiesioginės užklausos, kuriose aiškiai įvardijamas jūsų produktas arba duomenų šaltinis.
  • Netiesioginės užklausos, kuriose apibūdinamas norimas rezultatas neminant jūsų įrankio pavadinimo.
  • Neigiamos užklausos, kurias turi apdoroti integruoti įrankiai arba kiti papildiniai.

Kiekvienai užklausai užfiksuokite numatomą elgseną: iškviesti jūsų įrankį, nieko nedaryti arba perduoti kitam sprendimui. Naudokite šį rinkinį visiems regresijos testams.

Metaduomenys, nukreipiantys modelį

  • Pavadinimas turėtų derinti sritį ir veiksmą, pavyzdžiui, calendar.create_event.
  • Aprašymas turėtų prasidėti fraze „Naudoti, kai…“ ir aiškiai išvardyti neįtrauktus atvejus, pavyzdžiui, „Nenaudoti priminimams.“
  • Kiekvienas parametras turi būti dokumentuotas su pavyzdžiais ir leistinų reikšmių sąrašu, jei įvestis yra ribojama.
  • Anotacijos turi atspindėti faktinę elgseną (žr. 3 ir 11 pamokas).

Matuokite, tada tobulinkite

Prijunkite savo serverį, įdiekite papildinį, paleiskite savo užklausų rinkinį ir užfiksuokite, kuris įrankis buvo pasirinktas, kokie argumentai perduoti ir ar buvo rodomas kuris nors naudotojo sąsajos komponentas. Stebėkite du rodiklius: tikslumą (ar buvo iškvietas tinkamas įrankis?) ir išsamumą (ar įrankis buvo iškvietas kiekvieną kartą, kai turėjo būti?). Pirmiausia siekite aukšto tikslumo neigiamoms užklausoms, prieš gaudami menkus išsamumo pagerėjimus.

Keiskite tik vieną lauką vienu metu, kad išskirtumėte, kas lemia pagerėjimą. Veskite datuotą pakeitimų žurnalą su rezultatais ir prieš diegdami paprašykite ką nors kito peržiūrėti pakeitimus. Veikiančioje sistemoje kas savaitę peržiūrėkite įrankių naudojimą. Staigus „netinkamo įrankio“ patvirtinimų šuolis dažniausiai signalizuoja apie metaduomenų nukrypimą. Rinkite naudotojų atsiliepimus ir reguliariai iš naujo paleiskite savo užklausų testus, ypač pridėję naują įrankį arba pakeitę struktūrizuotą lauką.

Įgūdžiai pasikartojantiems darbo eigoms

Jūsų serveris teikia duomenis, autentifikavimą ir valdomus veiksmus. Įgūdis (skill) nusako įrankių iškvietimų seką, sprendimų taškus, išvesties formatavimą, pavyzdžius ir šablonus. Greičiausias būdas pradėti – naudoti integruotą @skill-creator, kuriame aprašote naudotojo tikslą ir jį palaikančius MCP įrankius.

Stiprus SKILL.md failas nurodo, kurių veiksmų laikytis, kokį rezultatą naudotojas turi gauti, kokių faktų modelis neturi išgalvoti, kada klausti, sustoti arba atsisakyti, ir kuriuos failus konsultuoti. Konkretaus darbo eigos įgūdį rinkitės vietoj didelio skirtingų instrukcijų rinkinio. Skirkite darbo eigas, kurios skiriasi savo suaktyvinimo sąlygomis, įvestimis arba sėkmės kriterijais. Laikykite SKILL.md glaustą, o detales saugokite kitur: naudokite references/ politikoms, schemoms ir pavyzdžiams; assets/ – šablonams kopijuoti arba transformuoti; ir scripts/ – deterministiniams skaičiavimams, bet tik tada, kai esamų instrukcijų ir įrankių nepakanka.

Jei įgūdis priklauso nuo MCP serverio, deklaruokite tą priklausomybę faile agents/openai.yaml. Tai padaro įrankį prieinamą, tačiau nepanaikina poreikio turėti aiškias instrukcijas, kuriuos įrankius naudoti, kokia tvarka ir kaip tvarkyti trūkstamus arba dviprasmiškus rezultatus. GPT-6 Astra atveju „OpenAI“ rekomenduoja peržiūrėti jų gaires dėl instrukcijų vykdymo: pašalinkite neaiškius arba prieštaraujančius nurodymus ir aiškiai nurodykite, kad naudotojo instrukcijos turi viršenybę prieš įgūdžio instrukcijas.

Testuokite įgūdžio suaktyvinimą ir išvesties kokybę naudodami tiesiogines, netiesiogines, neišsamias (kurios turėtų sukelti patikslinimo klausimą), ne temai priklausančias ir ribines užklausas, kai įgūdis turi vengti haliucinacijų arba veikti už savo ribų. Jei įgūdis suaktyvėja netinkamu laiku, pataisykite jo aprašymą. Jei jis pasirenka tinkamą darbo eigą, bet generuoja nenuoseklius rezultatus, pataisykite jo instrukcijas.

MCP įvykiai: reakcija į pokyčius

MCP įvykiai leidžia ChatGPT prenumeruoti atnaujinimus iš jūsų serverio, pavyzdžiui, naujus pranešimus, pakeistą turinį arba būsenos pokyčius. Naudotojas pasirenka, ką stebėti ir kaip ChatGPT turi reaguoti gavus atnaujinimą, pavyzdžiui: „Stebėk šį dokumentą ir taikyk komentaruose prašomus pataisymus.“

  1. Jūsų serveris išvardija palaikomus įvykius.
  2. Naudotojas nurodo ChatGPT, ką stebėti ir kaip reaguoti.
  3. ChatGPT prisijungia per jūsų MCP serverį, pateikdamas grįžtamojo ryšio URL ir pasirašymo slaptąjį raktą.
  4. Jūsų serveris siunčia atitinkamus įvykius tuo URL adresu.
  5. ChatGPT gauna įvykį prenumeruotame pokalbyje ir laikosi naudotojo instrukcijų.

Ši funkcija galima ChatGPT Work pokalbiuose žiniatinklyje ir darbalaukio programėlėje pasirinkus Cloud. ChatGPT remiasi „webhook“ pristatymu, kaip apibrėžta MCP įvykių specifikacijos projekte. Jūsų serveris turi išsaugoti prenumeratas ir gebėti pasiekti grįžtamojo ryšio URL adresus per HTTPS.

ChatGPT sąsajos plėtiniai

OpenAI MCP plėtiniai leidžia papildiniui integruotis į pagrindines ChatGPT sąsajos sritis: šoninę juostą, įvesties sritį ir failų peržiūros programas. Paminėjimai įvesties srityje galimi tik darbalaukio programėlėje. „OpenAI“ publikuoja pavyzdinį papildinį Bits & Bolts, kuris demonstruoja šiuos plėtinius ir stebi jų diegimą. Tai geriausias startinis taškas norint išnaršyti šią galimybę.

Svarbiausi punktai

  • Traktuokite metaduomenis kaip produkto tekstą: naudokite etaloninį užklausų rinkinį, stebėkite tikslumą ir išsamumą, keiskite po vieną lauką vienu metu.
  • Rašykite aprašymus, pradedant fraze „Naudoti, kai…“, aiškiai išvardykite neįtrauktus atvejus ir dokumentuokite visus parametrus.
  • Sukurkite po vieną sutelktą įgūdį kiekvienai darbo eigai, laikykite SKILL.md glaustą, išteklius saugokite atskirai ir deklaruokite MCP priklausomybes.
  • MCP įvykiai leidžia ChatGPT prenumeruoti jūsų serverio atnaujinimus, pristatomus per „webhook“.
  • Plėtiniai integruoja jūsų papildinį į šoninę juostą, įvesties sritį ir failų peržiūros programas.

Patikrinkite savo žinias

Nuo MCP įrankių iki publikavimo: įsitikinkite, kad įvaldėte pagrindus.

1. Ar man reikia `@openai/apps-sdk` paketo norint sukurti programėlę ChatGPT?

Atsakymas: Ne, toks paketas neegzistuoja. Jūs kuriate MCP serverį naudodami oficialius protokolo SDK (@modelcontextprotocol/sdk" TypeScript kalbai, mcp` Python kalbai), pasirinktinai pridėsite sąsają, atitinkančią MCP Apps standartą, ir visą tai platinate kaip papildinį.

2. Ar įrankis gali egzistuoti be naudotojo sąsajos?

Atsakymas: Taip, ir taip turėtų būti: įrankis grąžina structuredContent ir trumpą teksto santrauką, ko modeliui pakanka. Naudotojo sąsaja, prijungiama per _meta.ui.resourceUri, pridedama tik tada, kai ji padeda naudotojams tikrinti, lyginti, redaguoti, patvirtinti arba naršyti informaciją.

3. Kas sprendžia, ar naudotojas turi leidimą pasiekti duomenis?

Atsakymas: MCP serveris priima sprendimą dėl kiekvieno užklausos, remdamasis patikrintu OAuth prieigos raktu (parašu, leidėju, auditorija, galiojimo laiku, apimtimis). Anotacijos padeda ChatGPT pasirinkti tinkamą patvirtinimo lygį, tačiau jos niekada nepakeičia serverio pusės autorizacijos.

4. Ar papildinys gali parduoti savo paslaugos prenumeratą?

Atsakymas: Ne. Taisyklės prekybą riboja fizinėmis prekėmis. Esamas prenumeratorius gali prisijungti ir naudotis funkcijomis, įtrauktomis į jo planą. Papildinys gali paaiškinti, kad funkcija neįtraukta, ir pateikti nuorodą į informacinį puslapį, tačiau jis niekada neturi nukreipti į mokėjimo puslapį.

5. Kaip atnaujinami įrankiai publikuotam papildiniui?

Atsakymas: Be naujo ZIP failo: „OpenAI“ iš naujo nuskenuoja serverį, ir bet koks naujas arba pakeistas įrankis tampa prieinamas po automatinių patikrų. Ištrintas įrankis išnyksta iškart. Tačiau metaduomenims ir įgūdžiams reikia naujo ZIP failo ir naujos peržiūros.

Gerai aprašyti įrankiai, pasirenkamos naudotojo sąsajos, serverio pusės autorizacija ir taisyklių laikymasis – tai sistema, kuri paverčia papildinį patikima paslauga ChatGPT ir Codex环境中.