Лекції

У цій лекції розберемо «мозок» застосунків ChatGPT: як модель обирає між звичайною текстовою відповіддю та викликом інструмента ( tool-call), що саме вона бачить (system prompt, список tools, історію діалогу), чому критично важливі name/ description/ inputSchema, як виглядає виклик на рівні API ( tool_calls, finish_reason) і як дозволи/анотації ( readOnly, destructive) впливають на поведінку моделі та UX.

У цій лекції ви розберетеся, як описувати інструменти в MCP і ChatGPT Apps за допомогою JSON Schema: як влаштований inputSchema, чому це частина підказки (prompt) для моделі, як правильно писати description, коли використовувати enum та обмеження ( minItems, format). Далі ви зберете «єдине джерело істини» на TypeScript через Zod + zod-to-json-schema, розберете типові проблеми з полями optional і побачите роль _meta/анотацій (наприклад, readOnlyHint, destructiveHint, openai/outputTemplate) для UX і безпеки.

Розгляньмо серверний шлях виклику інструментів в екосистемі Apps SDK + MCP. Поговоримо про те, як ChatGPT викликає інструмент через JSON-RPC; де в Next.js‑шаблоні розташований MCP-сервер ( app/mcp/route.ts); як проєктувати inputSchema і повертати результат через content та structuredContent; як привʼязати UI через _meta і openai/outputTemplate. Також розберемо, як організувати валідацію, авторизацію, інтеграцію із зовнішніми API, логування й обробку помилок.

Розглянемо повний шлях даних: від серверного інструмента до React‑інтерфейсу в ChatGPT Apps. Ви побачите, як ToolOutput потрапляє у віджет через Apps SDK; чим відрізняються structuredContent, content і _meta; як безпечно читати toolOutput через хуки ( useWidgetProps) замість прямого доступу до window; а також як будувати UI‑стани (loading/empty/error) навколо результату виклику інструмента.

У цій лекції розберемося, чому в застосунках ChatGPT той самий інструмент може викликатися повторно (повторні спроби, Regenerate, мережеві збої), як проєктувати ідемпотентні операції через idempotency_key, як повертати помилки так, щоб їх однаково розуміли і модель, і UI ( ok/ error, code, retryable), а також як безпечно налаштовувати віджет через text/html+skybridge і _meta (CSP, домен, візуальні прапорці).