Премини към основното съдържание
Български— Изберете език
Меню

Тестване и отстраняване на грешки

Урок 9 от 14 Обновен 3 ноември 2026 г. Програмист
На тази страница
  1. Тестване на нива
  2. MCP сървърът
  3. Целият плъгин
  4. Диагностика по нива
  5. Ключови изводи

Урокът е пренаписан на 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 след всяка промяна на метаданните, след което започнете нов разговор
  • При възникване на проблеми първо изолирайте слоя: сървър, компонент или клиент