От Apps SDK до плъгини за ChatGPT
На тази страница
Курсът е пренаписан на 3 ноември 2026 г. въз основа на документацията на OpenAI за Плъгини. Предишната версия разчиташе на несъществуващия пакет
@openai/apps-sdk(включващdefineAction,defineWidgetи манифестchatgpt-app.json). Вече изграждате приложения за ChatGPT, използвайки протокола MCP, неговите официални SDK и стандарта за интерфейс MCP Apps. Пренаписахме и четиритенадесетте урока и премахнахме неподдържаните списъци със съвместимост на модели, структурите на комисионни и стъпките за публикуване от старата версия. Източници: Бързо стартиране · Архитектура на плъгините.
Какво представлява един плъгин?
Плъгинът е пакетът, който откривате, инсталирате, споделяте и публикувате в рамките на ChatGPT и Codex. Той разширява възможностите на асистента, като предоставя нови знания, инструменти или и двете. Документацията на OpenAI идентифицира четири основни градивни елемента:
- Умения (Skills), които предоставят на модела инструкции и ресурси за справяне с повтарящи се работни потоци;
- MCP сървър, който излага инструменти и свързва асистента с външни системи – Вашия API, база данни или услуга;
- И двете, когато моделът се нуждае както от наръчник с правила, така и от възможности, предоставени от Вашата инфраструктура;
- Куки за жизнения цикъл (Lifecycle hooks), команди, изпълнявани в конкретни моменти от работната среда на Codex, включително в рамките на ChatGPT Work.
ChatGPT и Codex споделят една обща директория с плъгини: един публичен плъгин се публикува веднъж и става видим във всички съвместими повърхности в двата продукта. Някои възможности остават специфични за дадена повърхност – например, скрипт за куката трябва да съществува в работната среда, така че инсталирането на плъгина в уеб версията не го разполага автоматично и там.
А какво става с „Apps SDK“?
Този термин се отнася до набора от инструменти на OpenAI за изграждане на приложения вътре в ChatGPT: протоколът MCP и неговите официални SDK, откритият стандарт MCP Apps, който ChatGPT реализира за рендиране на интерфейси, специфични разширения за ChatGPT, система за дизайн (@openai/apps-sdk-ui) и хранилище с примери. Документацията вече групира тези елементи под заглавието „Плъгини за ChatGPT и Apps SDK“: едно приложение се центрира около MCP сървър, включва по избор интерфейс и се разпространява като част от плъгин.
Изборът на MCP е умишлен. Протоколът за контекст на модела (Model Context Protocol) е отворена спецификация за свързване на AI клиенти с инструменти и данни. Сървърът, който пишете за ChatGPT, говори протокол, разбираем и от други хостове, а интерфейс, съвместим с MCP Apps, работи във всеки хост, поддържащ този стандарт.
Четири възможни форми
Започнете с най-малката форма, която покрива Вашите случаи на употреба; можете да добавите сървър или интерфейс по-късно, без да променяте основната цел на плъгина.
| Форма | Изберете това, когато |
|---|---|
| Само умения | Съществуващите инструкции и инструменти са достатъчни за справяне с работния поток |
| Само MCP сървър | Плъгинът се нуждае от MCP инструменти, но не и от допълнителни инструкции за работния поток |
| Умения и MCP сървър | Уменията трябва да насочват модела през работни потоци, използващи Вашите инструменти |
| MCP сървър с интерфейс | Визуалното взаимодействие значително подобрява част от работния поток |
Плъгин, който изготвя протоколи от срещи според правилата на Вашата компания, може да се нуждае само от умения. Щом обаче трябва да чете данни в реално време, да удостоверява потребител или да действа в система, която управлявате, той изисква MCP сървър. Накрая, интерфейсът никога не е задължителен: един инструмент трябва да остава полезен и без него.
Къде се изпълнява плъгинът
В ChatGPT можете да извикате инсталиран плъгин директно, като въведете @ в полето за въвеждане и го изберете. Моделът може също така да го извика автоматично, когато заявката съвпада с неговите инструменти или умения. Ръководството за бързо стартиране на OpenAI препоръчва тестването на Вашия първи плъгин в ChatGPT Work, раздела Work на началната уеб страница на ChatGPT. Същите плъгини се появяват и в Codex, ограничени от специфичните възможности на всяка повърхност.
Какво ще изградите
Този курс следва пътя, очертан в документацията. Ще започнете, като дефинирате своите инструменти въз основа на потребностите на потребителите, ще свържете първия MCP сървър към ChatGPT и след това ще изградите свой собствен: добре документирани инструменти, интерфейс MCP Apps там, където той добавя стойност, OAuth удостоверяване за частни данни и, ако Вашият бизнес модел позволява, поток на покупка, използващ Checkout API. Ще завършите с пакетиране, правила за публикуване и подаване на заявление за включване в директорията.
Ключови изводи
- Един плъгин комбинира умения, MCP сървър или и двете; интерфейсът е по избор
- ChatGPT и Codex споделят една обща директория с плъгини
- „Apps SDK“ се отнася до инструментите на OpenAI за изграждане на приложения: MCP, стандартът MCP Apps, разширенията за ChatGPT и системата за дизайн
- Няма пакет
@openai/apps-sdk: започнете с официалните MCP SDK - Изберете най-малката форма на плъгин, която покрива Вашите случаи на употреба