Песочница SenDev: AI Core

Страница «Песочница» предназначена для ручной проверки AI Core. Через неё можно протестировать подключение к провайдеру, модель, промпт, переменные и параметры запроса до того, как этот сценарий будет использоваться другим модулем.

Песочница выполняет запрос тем же общим механизмом AI Core, который используется рабочими интеграциями. Поэтому успешный тест здесь — хороший способ проверить, что профиль и промпт настроены корректно.

[Скриншот 1: общий вид Песочницы с переключателем «Текст / Генерация изображений»]

Два режима работы

В верхней части страницы выбирается тип теста:

• Текст — генерация или обработка текста;
• Генерация изображений — создание изображения через графический профиль.

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

Кто может запускать тест

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

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

Бесплатная проверка без API-ключа

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

• Dummy — для текста;
• Dummy Image — для изображений.

Dummy Image формирует локальный тестовый результат и не отправляет запрос во внешний AI-сервис. Это позволяет проверить работу графического режима без API-ключа, квоты и оплаты.

Если Dummy работает, а реальный профиль — нет, значит основная структура AI Core исправна и проблему следует искать в настройках подключения, модели, авторизации или ограничениях внешнего провайдера.

Поле «Режим теста»

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

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

Провайдер

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

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

Сценарий

Сценарий выбирает промпт из библиотеки AI Core. После выбора система анализирует шаблон и показывает поля для обнаруженных переменных.

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

Модель

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

При тестировании можно выбрать другую модель и сравнить результат. Это полезно, если:

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

Ручной ID модели

Песочница позволяет при необходимости вручную указать идентификатор модели. Такое значение имеет приоритет над выбором из списка.

Обычному пользователю это поле не требуется. Используйте его для проверки новой модели до добавления в профиль или по указанию администратора.

Если ручной ID оставлен после теста случайно, запрос может уйти не в ту модель, которая выбрана в выпадающем списке. При обычной проверке оставляйте поле пустым.

Данные для промпта

Если шаблон содержит переменные, Песочница создаёт для них понятные поля. Например, для переменной {{TEXT}} можно вставить исходный текст, а для {{PRODUCT_NAME}} — название товара.

Это позволяет проверить промпт в том виде, в котором его будет использовать рабочий модуль.

Сообщение пользователя

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

Для чистого сравнения моделей лучше использовать одинаковое сообщение при каждом тесте.

Дополнительные переменные JSON

В расширенном режиме можно передать дополнительные значения в JSON. Это поле рассчитано на нестандартные сценарии и разработчиков.

Если обычных полей переменных достаточно, JSON заполнять не нужно. Ошибка в структуре может привести к тому, что нужное значение не подставится или запрос не будет выполнен.

Предпросмотр применённого промпта

Перед отправкой AI Core показывает, какой промпт фактически будет использован: название, версию, сценарий и текст после подстановки переменных.

Всегда просматривайте этот блок при настройке нового шаблона. Он помогает заметить:

• неподставленную переменную;
• неожиданное значение;
• выбранную не ту версию промпта;
• лишний или недостаточный контекст;
• ошибку в тексте шаблона.

[Скриншот 2: блок данных промпта и предпросмотр итоговой инструкции]

Параметры текстового режима

Temperature

Влияет на вариативность ответа, если выбранный провайдер и модель поддерживают этот параметр. Более низкие значения обычно дают более предсказуемые ответы, более высокие — более разнообразные.

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

MAX_TOKENS

Ограничивает объём генерируемого ответа. Значение 0 означает, что AI Core не задаёт собственное ограничение и полагается на параметры провайдера/модели.

Если ответ постоянно обрывается, проверьте этот параметр. Если запрос должен возвращать очень короткий результат, ограничение помогает контролировать объём.

Использовать кэш

Позволяет использовать кэш AI Core для повторяющихся запросов. При тестировании нового провайдера или изменённого промпта кэш лучше отключить, чтобы гарантированно получить свежий внешний ответ.

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

Параметры графического режима

Размер изображения

Выбирает желаемый размер, если драйвер и модель поддерживают этот параметр. Набор доступных значений зависит от выбранного подключения.

Соотношение сторон

Позволяет выбрать формат кадра. Если фиксированное соотношение не требуется, используйте «Авто».

Для некоторых моделей явная передача соотношения сторон может быть излишней или ограниченной. AI Core учитывает особенности поддерживаемых драйверов. В частности, для совместимых сценариев Gemini модуль не передаёт лишний параметр 1:1 там, где модель и так использует квадратный формат по умолчанию.

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

Количество изображений

Можно запросить от 1 до 4 изображений, если выбранный провайдер поддерживает такой режим.

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

Формат

Определяет желаемый формат результата, если поддерживается драйвером. Если нет специальных требований, оставьте стандартное значение.

Качество

Используется только теми провайдерами, у которых есть соответствующая настройка. Более высокое качество может повлиять на время генерации и стоимость.

Запуск запроса

Перед нажатием кнопки запуска проверьте:

• правильный режим;
• нужный провайдер;
• модель;
• сценарий;
• все обязательные переменные;
• предпросмотр промпта;
• параметры, влияющие на расход.

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

Результат текстового запроса

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

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

Результат генерации изображения

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

Внешний провайдер может вернуть временный URL. AI Core не рассматривает такой адрес как постоянное хранилище сайта. Если изображение должно использоваться в рабочем модуле длительное время, сохранением файла занимается интегрирующий модуль.

При использовании Dummy Image возвращается локальный тестовый результат, предназначенный именно для проверки механизма.

Запись теста в журнал

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

После ошибки откройте «Журнал»: там обычно легче увидеть провайдера, модель, код/текст ошибки и длительность запроса.

Как проверять новый текстовый профиль

1. Сначала выполните простой запрос через Dummy.
2. Выберите реального текстового провайдера.
3. Выберите его модель по умолчанию.
4. Возьмите простой стандартный промпт или ручной сценарий.
5. Отправьте короткое однозначное сообщение.
6. Проверьте текст ответа.
7. Откройте журнал и убедитесь, что запрос завершился успешно.
8. Только после этого тестируйте длинные документы и сложные промпты.

Как проверять новый графический профиль

1. Запустите Dummy Image с одним изображением.
2. Выберите реальный графический профиль.
3. Оставьте соотношение сторон «Авто» и запросите одно изображение.
4. Используйте короткое понятное описание.
5. После успеха поочерёдно проверяйте нужные размеры, соотношения и качество.
6. Если появляется ошибка квоты или авторизации, не меняйте случайно графические параметры — сначала исправьте доступ к провайдеру.

Типовые причины ошибок

Неверный или отозванный ключ

Провайдер отклоняет авторизацию. Проверьте ключ и способ авторизации в профиле.

Модель недоступна

Идентификатор может существовать в профиле, но быть недоступным вашему аккаунту или региону. Попробуйте другую доступную модель.

Закончилась квота или баланс

Внешний сервис может вернуть ошибку ограничения. Для Gemini возможна ситуация, когда бесплатная квота для выбранного проекта/модели фактически равна нулю. В этом случае требуется доступная квота/оплата либо использование Dummy Image для проверки самого AI Core.

Сработал лимит AI Core

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

Ошибка параметров изображения

Верните соотношение сторон в «Авто», уменьшите количество изображений и используйте стандартные параметры профиля. Затем добавляйте дополнительные параметры по одному.

Промпт сформирован неправильно

Посмотрите предпросмотр применённого промпта. Часто проблема видна ещё до отправки: пустая переменная, неверный сценарий или слишком длинный исходный текст.

Что важно учитывать при тестах

• Песочница может выполнять реальный платный запрос.
• Одинаковый промпт не гарантирует идентичный ответ разных моделей.
• Для сравнения меняйте один параметр за раз.
• При диагностике нового провайдера отключайте кэш.
• Для первого графического теста используйте одно изображение.
• Не используйте реальные конфиденциальные данные без необходимости.
• После теста смотрите журнал — он подтверждает, какой профиль и модель использовались фактически.

[Скриншот 3: успешный результат Песочницы со сведениями о провайдере, модели и времени]

Итог

Песочница — основной инструмент проверки AI Core перед вводом сценария в работу. Сначала тестируйте Dummy, затем реального провайдера с минимальными параметрами, после чего проверяйте промпт и дополнительные возможности. Такой порядок позволяет быстро отделить проблему самого модуля от ошибки внешнего сервиса или конкретной модели.