Лекции

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

В этой лекции разбираем, как описывать инструменты в MCP и ChatGPT Apps через JSON Schema: как устроен inputSchema, почему это часть «промпта» для модели, как правильно писать description, когда использовать enum и ограничения ( minItems, format). Затем собираем «single source of truth» на TypeScript через Zod + zod-to-json-schema, обсуждаем проблемы optional-полей, и показываем роль _meta/annotations (например, readOnlyHint, destructiveHint, openai/outputTemplate) для UX и безопасности.

Разбираем серверный путь вызова инструментов в экосистеме Apps SDK + MCP: как ChatGPT вызывает tool через JSON-RPC, где в Next.js-шаблоне живёт MCP-сервер ( app/mcp/route.ts), как проектировать inputSchema и возвращать результат через content и structuredContent, как привязать UI через _meta и openai/outputTemplate, а также как делать валидацию, авторизацию, работу с внешними API, логирование и обработку ошибок.

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

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