Структурированные ответы

Структурированный ответ нужен, когда результат должен соответствовать машинно проверяемой схеме.

JSON-инструкция и строгая схема

Просьба «верни JSON» не гарантирует набор полей и типы. Если модель и API поддерживают schema enforcement, передайте JSON Schema и включите строгий режим.

{
"type": "object",
"properties": {
  "summary": {"type": "string"},
  "risk": {"type": "string", "enum": ["low", "medium", "high"]}
},
"required": ["summary", "risk"],
"additionalProperties": false
}

Практика

• Проверяйте поддержку функции выбранной моделью.
• Валидируйте ответ на сервере даже в строгом режиме.
• Различайте отказ модели, incomplete-ответ и ошибку схемы.
• Версионируйте схемы, которые используются внешними потребителями.
• Не выполняйте действия только на основании непроверенного JSON.

Для новых интеграций используйте Responses API.