Оптимизация: Метаданни, Умения и Събития
На тази страница
Урокът е пренаписан на 3 ноември 2026 г. въз основа на документацията на OpenAI за плъгини: Optimize Metadata, Build Skills, MCP Events и Plugin Extensions. Предишната версия на този урок разчиташе на модули
analyticsиexperimentот несъществуващ SDK. Източници: Optimize Metadata · Build Skills · MCP Events · Plugin Extensions.
Метаданните са продуктово описание
ChatGPT и Codex решават кога да извикат Вашите инструменти въз основа на предоставените от Вас метаданни. Добре написаните имена, описания и параметри гарантират, че Вашият инструмент ще бъде задействан, когато е необходимо, и предотвратяват нежелани активации. OpenAI препоръчва да третирате тези метаданни като продуктово описание:迭代ирайте ги, тествайте ги и измервайте тяхната ефективност.
Референтен набор от подкани
Преди да промените метаданните си, изградете маркиран набор от тестови подкани:
- Директни подкани, които изрично назовават Вашия продукт или източник на данни.
- Индиректни подкани, които описват желания резултат, без да назовават Вашия инструмент.
- Негативни подкани, които трябва да бъдат обработени от вградени инструменти или други плъгини.
За всяка подкана документирайте очакваното поведение: извикване на Вашия инструмент, липса на действие или прехвърляне към друго решение. Използвайте този набор за всеки тест за предотвратяване на регресия.
Метаданни, които насочват модела
- Името трябва да комбинира домейна и действието, например
calendar.create_event. - Описанието трябва да започва с „Използвай, когато…“ и изрично да изброява изключените случаи, например „Не използвай за напомняния.“
- Всеки параметър трябва да бъде документиран с примери и списък с позволени стойности, ако входът е ограничен.
- Анотациите трябва да отразяват действителното поведение (виж Уроци 3 и 11).
Измерване и последваща итерация
Свържете Вашия сървър, инсталирайте плъгина, стартирайте Вашия набор от подкани и запишете кой инструмент е избран, какви аргументи са предадени и дали е показан някой UI компонент. Следете два показателя: прецизност (дали е извикан правилният инструмент?) и пълнота (дали инструментът е извикан всеки път, когато е трябвало?). Първо стремете се към висока прецизност при негативните подкани, преди да търсите边际ни подобрения в пълнотата.
Променяйте само едно поле наведнъж, за да изолирате фактора, който води до подобрение. Водете дневник на ревизиите с дати и резултати и накарайте някой друг да прегледа промените преди внедряване. В производствена среда преглеждайте използването на инструментите седмично. Рязък скок в потвържденията за „грешен инструмент“ обикновено сигнализира за отклонение в метаданните. Събирайте обратна връзка от потребителите и преизпълнявайте тестовете си с подкани редовно, особено след добавяне на нов инструмент или модифициране на структурирано поле.
Умения за повтарящи се работни потоци
Вашият сървър предоставя данни, удостоверяване и контролирани действия. Едно умение предоставя последователността от извиквания на инструменти, точки на вземане на решения, форматиране на изхода, примери и шаблони. Най-бързият начин да започнете е чрез вградения @skill-creator, където описвате целта на потребителя и MCP инструментите, които я подкрепят.
Един силен файл SKILL.md определя кои стъпки да се следват, какъв резултат трябва да получи потребителят, какви факти моделът не трябва да измисля, кога да задава въпроси, да спира или да отказва, и кои файлове да консултира. Предпочитайте фокусирано умение за конкретен работен поток пред голям набор от разпокъсани инструкции. Разделяйте работните потоци, които се различават по своя тригер, входове или критерии за успех. Поддържайте SKILL.md кратък и съхранявайте детайлите на други места: използвайте references/ за политики, схеми и примери; assets/ за шаблони за копиране или трансформиране; и scripts/ за детерминирани изчисления – но само ако съществуващите инструкции и инструменти са недостатъчни.
Ако едно умение зависи от MCP сървър, декларирайте тази зависимост в agents/openai.yaml. Това прави инструмента достъпен, но не замества нуждата от ясни инструкции кои инструменти да се използват, в какъв ред и как да се обработват липсващи или неясни резултати. За GPT-6 Astra, OpenAI съветва да прегледате нейните насоки за следване на инструкции: премахнете неясните или противоречиви директиви и направете изрично, че инструкциите на потребителя имат приоритет пред инструкциите на умението.
Тествайте активацията на умението и качеството на изхода, използвайки директни, индиректни, непълни (които трябва да предизвикат изясняващ въпрос), извън темата и гранични подкани, при които умението трябва да избягва халюцинации или действия извън обхвата си. Ако умение се активира в грешно време, поправете описанието му. Ако избира правилния работен поток, но произвежда непоследователни резултати, поправете инструкциите му.
MCP Събития: Реагиране на промени
MCP Events позволява на ChatGPT да се абонира за актуализации от Вашия сървър, като нови съобщения, модифицирано съдържание или промени в статуса. Потребителят избира какво да наблюдава и как ChatGPT да реагира, когато пристигне актуализация – например „Наблюдавай този документ и приложи корекциите, поискани в коментарите.“
- Вашият сървър изброява събитията, които поддържа.
- Потребителят казва на ChatGPT какво да наблюдава и как да реагира.
- ChatGPT се абонира чрез Вашия MCP сървър, предоставяйки URL за обратно извикване и таен ключ за подписване.
- Вашият сървър изпраща съответните събития до този URL.
- ChatGPT получава събитието в абониранния разговор и следва инструкциите на потребителя.
Тази функция е налична в разговорите на ChatGPT Work в уеб версията и в десктоп приложението с избран режим Cloud. ChatGPT разчита на доставката чрез уебхук, както е дефинирано в проекта на спецификацията за MCP Events. Вашият сървър трябва да запазва абонаментите и да може да достигне до URL адресите за обратно извикване чрез HTTPS.
Разширения на интерфейса на ChatGPT
OpenAI MCP Extensions позволяват на един плъгин да се интегрира в ключови области на интерфейса на ChatGPT: страничната лента, областта за въвеждане и визуализаторите на файлове. Споменаванията в областта за въвеждане са налични само в десктоп приложението. OpenAI публикува примерен плъгин, Bits & Bolts, който демонстрира тези разширения и проследява тяхното внедряване. Това е най-добрата отправна точка за изследване на тази възможност.
Ключови изводи
- Третирайте метаданните като продуктово описание: използвайте референтен набор от подкани, следете прецизността и пълнотата и променяйте по едно поле наведнъж.
- Пишете описания, започващи с „Използвай, когато…“, изброявайте изрично изключените случаи и документирайте всички параметри.
- Създавайте по едно фокусирано умение за работен поток, поддържайте
SKILL.mdкратко, съхранявайте ресурсите отделно и декларирайте MCP зависимостите. - MCP Events абонира ChatGPT за актуализации от Вашия сървър, доставяни чрез уебхук.
- Разширенията интегрират Вашия плъгин в страничната лента, областта за въвеждане и визуализаторите на файлове.
Проверете знанията си
От MCP инструменти до публикуване: уверете се, че сте усвоили основите.
1. Нужен ли е пакетът `@openai/apps-sdk`, за да създадете приложение в ChatGPT?
Отговор: Не, такъв пакет не съществува. Вие изграждате MCP сървър, използвайки официалните SDK за протокола (@modelcontextprotocol/sdk за TypeScript, mcp за Python), по желание добавяте интерфейс, съвместим със стандарта MCP Apps, и разпространявате цялото нещо като плъгин.
2. Може ли един инструмент да съществува без потребителски интерфейс (UI)?
Отговор: Да, и трябва: един инструмент връща structuredContent и кратко текстово обобщение, което е достатъчно за модела. Потребителският интерфейс, прикрепен чрез _meta.ui.resourceUri, се добавя само когато помага на потребителите да инспектират, сравняват, редактират, потвърждават или навигират в информацията.
3. Кой решава дали потребителят има разрешение за достъп до данни?
Отговор: MCP сървърът решава за всяка заявка въз основа на verificirания OAuth токен (подпис, издател, аудитория, срок на валидност, обхвати). Анотациите помагат на ChatGPT да избере подходящото ниво на потвърждение, но никога не заместват оторизацията от страна на сървъра.
4. Може ли един плъгин да продава абонамент за своята услуга?
Отговор: Не. Правилата ограничават търговията до физически стоки. Съществуващ абонат може да влезе и да използва функциите, включени в неговия план. Плъгинът може да обясни, че дадена функция не е включена, и да предостави връзка към информационна страница, но никога не трябва да предоставя връзка към страница за плащане.
5. Как се актуализират инструментите за публикуван плъгин?
Отговор: Без нов ZIP файл: OpenAI повторно сканира сървъра и всеки нов или модифициран инструмент става наличен след преминаване на автоматичните проверки. Изтрит инструмент изчезва незабавно. Въпреки това, метаданните и уменията изискват нов ZIP файл и ново разглеждане.
Добре описани инструменти, опционални потребителски интерфейси, оторизация от страна на сървъра и спазване на правилата: това е рамката, която превръща един плъгин в надеждна услуга в ChatGPT и Codex.