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

Начните с задачи
Два интерфейса могут принимать диалог, но вести себя по-разному. Одному приложению нужен только текст, другому — изображения, структурированный ответ или вызовы инструментов. Выберите модель и интерфейс, для которых нужные возможности описаны вместе. Совместимый формат не гарантирует поддержку каждого поля.
Похожие названия интерфейсов обычно указывают на сходные структуры, но не гарантируют понимание каждого параметра всеми моделями. Ограничения вывода, структурированный формат, изображения и инструменты могут различаться. Поставщик, шлюз и клиентская библиотека способны проверять или преобразовывать данные. Отдельно проверяйте доступность вызова и нужные продукту возможности.
Составьте небольшую таблицу
Для каждой пары модели и интерфейса запишите поддерживаемые входы, потоковую передачу, инструменты, формат ответа и ограничения. Проверьте каждую важную возможность минимальным запросом. Успешный текстовый ответ ещё не доказывает поддержку изображений или инструментов.
Успешный текстовый запрос не доказывает поддержку потоковой передачи, инструментов и изображений той же моделью. Отдельно проверьте маркер завершения, имена инструментов и аргументы, способ передачи изображения и ошибки при отсутствии поддержки. Не считайте поля одного поставщика общим стандартом; сверяйтесь с документацией конкретной модели и интерфейса.
Сохраните небольшой набор обычного текста, граничных параметров, прерванного потока, инструментов и нужных мультимодальных входов. Запускайте его после смены модели, клиента или шлюза и сравнивайте структуру ответа, а не только статус. Уберите секреты и клиентские данные; до выпуска зафиксируйте затронутые сценарии и план отката.
Полезная запись содержит версию модели, интерфейс, тип входа, ожидаемый и фактический результат и дату. Одного слова «совместимо» мало: сочетание может работать с текстом, но отклонять определённый вход изображения. Непроверенные поля остаются неизвестными до отдельной проверки.
Адаптер соединяет протоколы, но может передать не все возможности.Проверьте обе стороны обмена
Сохраните обезличенные примеры запросов и ответов в тестах. Посмотрите, отклоняются ли необязательные поля, игнорируются или преобразуются, и есть ли в ответе нужные данные. Не помещайте реальные ключи, частные запросы и данные клиентов в открытые тесты. Повторяйте проверки после смены модели или поставщика.
Для важного параметра отметьте: принят и действует, явно отклонён, проигнорирован или преобразован с иным смыслом. Проверяйте запрос и ответ, включая разницу между отсутствием поля и явным нулём или false. Успешный статус не доказывает действие параметра. Используйте входы, на которых различие заметно, и сохраняйте обезличенный результат в регрессионных тестах.
Заранее решите, что делать с отличиями
Отключайте в интерфейсе неподдерживаемые возможности либо выбирайте другую модель или интерфейс, если функция необходима. Показывайте понятную ошибку вместо незаметного удаления инструкции. Держите документацию и результаты испытаний рядом с таблицей совместимости.
Непроверенное поле следует помечать как неизвестное, а не поддерживаемое. Записывайте дату, ID модели, интерфейс, результат и ограничения. Если возможность нельзя преобразовать, отключите элемент управления, объясните ограничение или предложите другую модель. Если меняется смысл запроса, явная ошибка безопаснее незаметного удаления инструкции.
Проверьте значение каждого поля
Совместимость — не только переименование полей. Один API может представлять сообщение строкой, другой — блоками текста и изображений. Системные инструкции, инструменты и причины завершения тоже могут различаться. Принятый запрос ещё не гарантирует сохранения нужного смысла.
Отдельно проверьте отсутствие поля, пустое значение и явные ноль или false. Если возможность нельзя преобразовать, сообщите об этом или предложите проверенную альтернативу, а не удаляйте инструкцию молча.
Проверяйте потоковую передачу и вызовы инструментов отдельно
Для потока проверяйте границы событий, фрагменты, завершение и ошибки. Вызов инструмента может приходить частями; перед выполнением соберите и проверьте аргументы по правилам используемого протокола.
Предложение модели не заменяет разрешения пользователя. Проверьте права, обработайте ошибку инструмента и верните результат в нужном формате. Для структурированного вывода предусмотрите обработку ответа, не соответствующего схеме.
Поддерживайте запись о совместимости в актуальном состоянии
Ведите запись для каждой комбинации: модель и версия, интерфейс, входы, поток, инструменты, формат, дата и результат. Различайте «проверено», «ошибка» и «не проверено»; не включайте реальные ключи в примеры.
Для помощника по заказам проверьте корректные и отсутствующие аргументы, отказ в доступе и тайм-аут. После смены модели или настроек повторите те же случаи и используйте заранее проверенный запасной вариант.
Конкретный пример
Допустим, помощнику поддержки нужны текстовые ответы и поиск карточки клиента. Задайте каждому кандидату один вопрос, затем проверьте корректный поиск и неверный аргумент. Запишите, запросила ли модель инструмент, отклонил ли сервер ошибочные данные и использовал ли итоговый ответ результат. Поддержку изображений позже проверяйте отдельно.