basforge

Ищем по названиям, тексту и разборам «Если не работает».

    EN

    Нужен JSON — задаём схему, а не просим «ответь в JSON»

    «Ответь в формате JSON» иногда даёт JSON в обёртке из пояснений, с лишней запятой или без поля. Структурированный вывод (output_config.format у Claude, response_format у OpenAI) гарантирует ответ строго по JSON-схеме: скрипт разбирает его без проверок «а вдруг там текст».

    Как это выглядит

    Разбираем письмо с заказом в поля:

    "output_config": {
      "format": {
        "type": "json_schema",
        "schema": {
          "type": "object",
          "properties": {
            "customer": { "type": "string" },
            "email":    { "type": ["string", "null"] },
            "plan":     { "type": "string", "enum": ["basic", "pro", "enterprise", "unknown"] },
            "urgent":   { "type": "boolean" }
          },
          "required": ["customer", "email", "plan", "urgent"],
          "additionalProperties": false
        }
      }
    }

    Ответ — ровно такой объект, первым и единственным текстом: jq -r '.content[] | select(.type == "text") | .text' answer.json | jq .plan.

    На что смотрим в схеме

    • null для пустого. Без ["string", "null"] модель обязана что-то вписать — и впишет придуманное.
    • enum для меток. Закрытый список вместо свободного текста: "unknown" — выход для случая, который не подходит ни под одну метку.
    • additionalProperties: false — без лишних полей, которые сломают разбор.
    • Описания полей. "description": "почта из подписи, не из адреса отправителя" работает как инструкция.

    Чем это лучше старых способов

    Способ Что ломается
    «ответь только JSON» в промпте пояснение до или после, обёртка в блок кода, обрезанный ответ
    предзаполнение { на Claude 4.6 и новее — 400
    вызов инструмента ради JSON работает, но с tool_choice под принуждение на Opus 5.5 и Sonnet 5.5 — 400
    структурированный вывод ничего: ответ проверен на соответствие схеме до отправки

    Схема гарантирует форму, но не правду: поле email будет строкой, только это может быть не та почта. Значения проверяем так же, как любой ответ модели («Повторяемый ответ»).