Блог Neurospace

Как получить от нейросети ответ в JSON для интеграции с CRM

Специалист и ИИ-помощник превращают сообщения в строки таблицы

Чтобы передавать ответ нейросети в CRM, опишите структуру JSON, используйте структурированный вывод, если его поддерживает выбранный API, и проверяйте результат перед записью. Корректный JSON подтверждает формат, но не достоверность сведений: город, количество и другие значения всё равно нужно сверять с исходным сообщением.

Сначала определите поля

Не начинайте с просьбы «извлеки всё полезное». Согласуйте с интегратором небольшой набор полей, который действительно нужен следующему шагу.

Например, для предварительной заявки:

  • city — строка с городом либо null, если город не указан;
  • quantity — целое число либо null, если количество неизвестно;
  • delivery_date — дата в согласованном формате либо null.

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

Не подменяйте неизвестное количество нулём. Эти значения описывают разные ситуации и могут по-разному обрабатываться в CRM. Также заранее определите, разрешает ли сама CRM пустое значение в выбранном поле.

Используйте схему, а не только промпт

Просьба «ответь только JSON» задаёт пожелание к тексту. Режим структурированного вывода позволяет передать JSON Schema — описание полей и типов — средствами API.

В документации Gemini такой режим предназначен в том числе для извлечения данных; поддерживается не вся спецификация JSON Schema. У других поставщиков ограничения могут отличаться. Поэтому схему нужно проверять на выбранной модели и версии API, а не переносить настройки без проверки.

Пример исходного сообщения: «Нужно 12 комплектов в Казань, дату доставки уточню».

Ожидаемый результат для этого примера: {"city":"Казань","quantity":12,"delivery_date":null}

В инструкции к извлечению уточните: брать сведения только из сообщения, не дополнять отсутствующие данные предположениями. JSON здесь — пример формата, а не готовая команда создания заявки.

Проверьте ответ до записи

Разделите проверку на три уровня: удалось ли разобрать JSON; соответствует ли он схеме; подтверждены ли значения исходным текстом. Google прямо рекомендует проверять значения даже при синтаксически корректном структурированном ответе.

Учитывайте и завершение генерации. В документации Claude описаны исключения: отказ модели и достижение лимита выходных токенов могут привести к ответу, не соответствующему схеме. Такой результат нельзя считать готовыми данными только из-за успешного HTTP-ответа.

При обрыве не «чините» результат добавлением закрывающей скобки: часть полей могла потеряться. Не отправляйте непроверенные сведения в CRM; направьте их на разбор или повторную обработку.

Перед запуском испытайте сообщения без города, с неизвестным количеством и с исправлением вроде «не 12, а 10». Интеграция готова к следующему этапу, когда такие случаи обрабатываются по заранее согласованным правилам, а не молча превращаются в ошибочные записи.

Источники

Читайте также

Neurospace для бизнеса

Создайте своего ИИ-бота

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

Создать бота
← Все статьи блога