Как получить Structured Outputs в Grok API по JSON Schema

response_format={"type":"json_schema","json_schema":{"name":"ticket","schema":{"type":"object","properties":{"intent":{"type":"string","enum":["order","support","other"]},"order_id":{"type":["string","null"]}},"required":["intent","order_id"],"additionalProperties":False}}}

• Поддерживаемые конструкции схемы ограничены официальной матрицей.
• Tool-call аргументы у xAI строго соответствуют входной JSON Schema (strict фактически включён).
• Схема не проверяет существование order_id.
• После ответа нужна бизнес-валидация.

Как внедрить

1. Зафиксируйте задачу и формат результата.
2. Храните ключ только на сервере и ограничьте доступ.
3. Выполните запрос и разберите структурированные поля ответа.
4. Добавьте таймаут, ограниченный retry и метрики usage/latency.
5. Прогоните положительные, отрицательные и пограничные тесты.

Как проверить результат

Проверьте запрос с номером, без номера, с двумя номерами и ложным ID. Последний должен быть отклонён при сверке с БД, хотя JSON формально валиден.

Чего не делать

• Не публикуйте API-ключ.
• Не считайте уверенный текст доказательством.
• Не записывайте данные без валидации.
• Не повторяйте 429 или 5xx бесконечно.

Ограничения

Доступность моделей, регионов, функций и тарифов может меняться. Проверяйте официальный каталог на дату внедрения и не отправляйте чувствительные данные без оценки политики обработки.

FAQ