Тестване и отстраняване на грешки
Урокът е пренаписан на 3 ноември 2026 г. въз основа на страниците Connect and test your plugin и Troubleshooting от документацията на OpenAI за плъгини. Бившата „разработъческа пясъчник“ среда и нейните команди принадлежат на несъществуващия SDK от първата версия на този курс. Източници: Свързване и тестване · Отстраняване на грешки.
Тестване на нива
OpenAI препоръчва да тествате всяка възможност преди внедряването на целия инсталиран плъгин: първо самостоятелния MCP сървър, свързан с ChatGPT, след това пакетирания плъгин с неговите умения. Запазете своите оценъчни подкани и техните резултати по време на разработката, за да можете да сравнявате поведението между различните версии.
MCP сървърът
Подготовка на крайната точка
Преди тестване в ChatGPT, уверете се, че сървърът е достъпен чрез публичен HTTPS – или чрез Secure MCP Tunnel – че използва streamable HTTP (обикновено на /mcp), че имената на инструментите, описанията, схемите и анотациите са налични, и че откриването на автентикация работи за инструменти, изискващи акаунт. Разработъчески тунел е подходящ за проби, но не и за подаване за одобрение.
Инспекция
MCP Inspector извиква вашите инструменти директно, без модел:
npx @modelcontextprotocol/inspector@latest
Подложете всеки инструмент на щателна проверка: представителни входни данни, гранични случаи, липсващи удостоверителни данни и празни резултати. Проверете валидирането на схемата, грешките при автентикация, анотациите, поведението при потвърждение и резултата, четим от модела.
Оценка на избора на инструмент
След като сървърът е свързан като личен плъгин (Урок 4), инсталирайте го, отворете нов разговор, въведете @ и го изберете. Създайте оценъчен набор, съдържащ:
- Директни заявки, които трябва да задействат конкретен инструмент;
- Индиректни заявки, които изразяват същата цел по различен начин;
- Последващи заявки, които използват идентификатори, получени по-рано;
- Операции за запис, изискващи оторизация или потвърждение;
- Заявки извън обхвата, които не трябва да задействат никакъв инструмент.
За всяка от тях запишете избрания инструмент, неговите аргументи, резултата, всички грешки и поведението при потвърждение. Възпроизвеждайте целия набор всеки път, когато промените име, описание, схема или анотация. Ако сървърът връща UI компонент, тествайте както самия компонент, така и резултата, четим от модела.
Преглед на суровите размени
За да прочетете пълните заявки и отговори, API Playground приема MCP сървър: отидете на Tools → Add → MCP Server, въведете HTTPS адреса, свържете се и след това изпълнете вашите тестови подкани.
Опресняване на метаданните
След всяка промяна на име, описание, схема, анотация, метод на автентикация или UI ресурс: преинсталирайте или рестартирайте сървъра, отворете връзката на chatgpt.com/plugins, изберете Refresh, проверете дали рекламираните метаданни са се променили и възпроизведете съответните тестове в нов разговор. Това опресняване важи за директно свързани сървъри; за публикуван плъгин актуализациите на инструментите попадат под непрекъснат преглед (Урок 11).
Преди пакетиране проверете дали списъкът с инструменти съответства на рекламираните възможности, дали структурираните резултати отговарят на изходните схеми, дали грешките при автентикация връщат полезни съобщения, дали правилните подкани задействат правилните инструменти, докато грешните не задействат никой, и дали UI се визуализира без грешки в конзолата, като същевременно правилно възстановява своето състояние.
Целият плъгин
След като сървърът е готов – или незабавно за плъгин, състоящ се само от умения – пакетирайте плъгина (Урок 10), добавете го към локален маркетплейс, инсталирайте го от директорията с плъгини и след това възпроизведете заявките от вашия инвентар с случаи на употреба: директни, индиректни, последващи, отрицателни и умишлено изключени гранични случаи. Уверете се, че плъгинът следва инструкциите за уменията, използва правилните ресурси, завършва всяка стъпка и произвежда полезен резултат; че уменията извикват правилните инструменти; и че автентикацията работи след инсталацията.
Диагностика по нива
Когато нещо се обърка, започнете с изолиране на дефектния слой: сървър, компонент или клиент на ChatGPT.
| Симптом | Насока |
|---|---|
| Няма изброени инструменти | Сървърът работи ли? Адресът завършва ли на /mcp? |
| Структурирани данни, но няма компонент | Инструментът включва ли _meta.ui.resourceUri, сочещо към регистриран ресурс от тип text/html;profile=mcp-app, който се зарежда без CSP грешки? |
| Грешки в схемата | Вашите Python или TypeScript модели съвпадат ли с рекламираната outputSchema? |
| Бавен компонент | Извикванията на инструменти надвишават ли няколкостотин милисекунди? Профилирайте и кештирайте. |
| Компонентът не се зарежда | Конзола на браузъра: нарушение на CSP, непълен пакет? |
| Загубено състояние (влачене и пускане, редактиране) | Извиквайте window.openai.setWidgetState след всяка актуализация и възстановявайте от window.openai.widgetState при монтиране. |
| Счупен оформление на мобилни устройства | Прочетете window.openai.displayMode и window.openai.maxHeight; избягвайте фиксирани височини и действия при задържане на курсора. |
| Инструментът никога не се избира | Пренапишете описанието като „Използвай, когато…“, прегледайте стартовите подкани. |
| Избран е грешен инструмент | Изяснете съседните инструменти, посочете изключените случаи, разделете твърде общите инструменти. |
| Грешки 401 | Включете WWW-Authenticate в отговора; проверете издателя и аудиторията. |
invalid_client при съществуваща връзка | Регистрираният OAuth клиент все още съществува ли? Възстановете го, вместо да създавате нов. |
| ngrok тунелът изтича | Рестартирайте го, проверете дали локалният сървър работи; в производствена среда използвайте стабилно хостинг решение със здравни сонди. |
| Стриймингът е прекъснат зад прокси | Balancer-ът или CDN трябва да пропускат HTTP стрийминг без буфериране. |
Ако проблемът продължава, съберете логове от сървъра, конзолата на компонента, транскрипт на извикванията на инструменти и екранни снимки. Отбележете използваната подкана и изпратете всичко на вашия контакт в OpenAI.
Ключови изводи
- Тествайте на нива: първо сървъра самостоятелно (Inspector, след това ChatGPT), после целия плъгин
- Създайте оценъчен набор: директни, индиректни, последващи, за запис и заявки извън обхвата
- API Playground показва суровите MCP размени
- Refresh след всяка промяна на метаданните, след което започнете нов разговор
- При възникване на проблеми първо изолирайте слоя: сървър, компонент или клиент