Сценарии AI

Сценарии настраиваются на /ai/scenarios. Просмотр требует права просмотра, а создание и изменение — права управления; без них карточка остаётся недоступной или доступной только для чтения.

Контракт сценария

Укажите стабильные key и название, описание, категорию, enabled, useCase (text_improve, text_fix, json_analysis, custom), outputMode (text или json), systemPrompt, userPromptTemplate, tags и необязательное responseSchema. Свяжите сценарий с connectionId или оставьте подключение по умолчанию.

Лимиты сценария — maxPromptChars, maxOutputChars, maxContextChars, requestTimeoutMs и overflowMode (reject/truncate). Не отключайте системную инструкцию без понимания последствий: при disableSystemPrompt=true остаётся только пользовательский шаблон.

Тестирование

Откройте Playground и проверьте сценарий на синтетическом примере. Для JSON убедитесь, что схема — валидный объект, обязательные поля действительно нужны, а рабочая форма умеет обработать ответ. Проверьте длинный ввод, timeout, отсутствие подключения и частично загруженный список. Деактивируйте (enabled=false) устаревший сценарий вместо повторного использования его ключа.

Форма и конфликт изменений

Для создания или изменения обязательны key и название. responseSchema, если он задан, должен быть JSON-объектом; список tags вводится через запятую. Обновление в окне сценария перечитывает последние сохранённые данные и предупреждает, если запись была удалена или не найдена. Если сценарий связан с подключением, из формы можно открыть его карточку; отключение сценария сохраняет запись, но переводит enabled в false.

Безопасность

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

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

Связанные страницы: AI Playground, Подключения AI, Настройки AI и Assistant.