🌍 Перевод текста

Fixorix умеет переводить тексты с помощью AI. В интерфейсе перевод реализован одним способом — блоком «ИИ — перевод» в сценариях. Это часть AI-возможностей платформы.

Где доступен перевод

Способ	Что это	Доступность
AI-блок «ИИ — перевод»	Шаг сценария: берёт текст, переводит и сохраняет результат в переменную	Работает — это единственный способ из интерфейса
AI-блок «ИИ — язык текста»	Шаг сценария: определяет язык текста и сохраняет его код в переменную, чтобы решить, переводить ли текст	Работает
Кнопка «Перевести» у сообщения в чате	Ручной перевод одного сообщения оператором	Кнопки в интерфейсе нет
Автоматический перевод входящих и исходящих сообщений	Механизм, переводящий переписку сам по себе	Такого механизма нет — перевод собирается только сценарием
Переключатель «Перевод сообщений» в настройках	Настройка проекта, вкладка «Каналы», блок «Сообщения»	Сохраняется, но ни на что не влияет

Отдельной функции «перевод сообщений» нет

В чате нет кнопки перевода у сообщений и нет автоматического перевода переписки. В интерфейсе перевести текст можно только так: подставить его в блок «ИИ — перевод» внутри сценария и дальше использовать результат (например, отправить оператору или клиенту).

В дашборде кнопки перевода сообщения нет. Перевод отдельного текста, пакетный перевод и получение сообщений с переводом доступны через Public API: POST /v1/ai/translation/translate, POST /v1/ai/translation/translate/batch (скоуп AI_WRITE), GET /v1/messages/translated (скоуп MESSAGES_READ), POST /v1/tech-support/ai/messages/{messageId}/translation (скоуп TECH_SUPPORT_WRITE). См. REST API.

Пока не работает

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

AI-блок «ИИ — перевод»

Что это. Один из AI-блоков конструктора сценариев. Блок берёт текст, переводит его на указанный язык и сохраняет перевод в переменную для следующих шагов.

Когда использовать.

• Показать оператору сообщение клиента на понятном языке.
• Перевести подготовленный ответ на язык клиента перед отправкой.
• Готовить многоязычные уведомления и авто-ответы.

Параметры блока

Поле	Назначение	Пример
Текст	Что переводим. Поддерживает шаблоны {{…}}	{{trigger.text}}
Целевой язык	Код языка: 2–3 строчные буквы, опционально регион через дефис	en, ru, deu, pt-BR
Исходный язык	Код языка в том же формате или auto — определить самостоятельно. По умолчанию auto	auto, ru
Сохранить перевод в	Имя переменной, куда запишется результат	flow.translated

Поля «Модель» у этого блока нет: перевод всегда выполняется на тире «Умная».

Дополнительная переменная. Помимо перевода блок кладёт определённый исходный язык (строчными буквами) в переменную <имя>_detected. Если результат сохраняется в flow.translated, язык оригинала окажется в flow.translated_detected — по нему удобно ветвить сценарий.

Выходы блока: «Далее» и «Ошибка». Пустой текст на входе не ошибка: блок идёт в «Далее» с пустым результатом (переменная <имя>_detected при этом не заполняется). Если AI-сервис не смог перевести (сбой, слишком длинный текст, блокировка проверками безопасности), блок идёт в «Ошибка»: переменная перевода остаётся пустой, причина лежит в {{flow.error_message}}. Если выход «Ошибка» ни к чему не подключён, запуск сценария завершится с ошибкой.

Как настроить (по шагам)

1. Откройте сценарий в редакторе (Автоматизация).
2. Добавьте блок «ИИ — перевод».
3. В поле «Текст» укажите источник — например {{trigger.text}} (текст сообщения клиента).
4. В поле «Целевой язык» введите код назначения, например en.
5. Поле «Исходный язык» оставьте auto, если язык оригинала заранее неизвестен.
6. В поле «Сохранить перевод в» задайте имя переменной, например flow.translated.
7. Сохраните сценарий. Дальше используйте {{flow.translated}} — например, чтобы отправить перевод оператору или клиенту.

Пример

Задача: входящее сообщение клиента на любом языке показывать оператору по-английски.

1. Стартовый блок — событие «Сообщение от клиента»; текст сообщения доступен как {{trigger.text}}.
2. Блок «ИИ — перевод»: Текст — {{trigger.text}}, Целевой язык — en, Исходный язык — auto, Сохранить перевод в — flow.translated.
3. Блок уведомления с текстом {{flow.translated}}.

Результат: оператор видит сообщение на английском, исходный текст остаётся в {{trigger.text}}, а определённый язык оригинала лежит в {{flow.translated_detected}}.

Связанные AI-блоки

Блок «ИИ — язык текста» определяет язык текста и сохраняет его код в переменную. Он полезен, когда решение «переводить или нет» нужно принять до блока перевода. См. AI-блоки в сценариях.

Ограничения

• Перевод расходует AI-бюджет запуска: один запуск сценария не может сделать больше 200 AI-вызовов, и каждый перевод непустого текста — это один вызов. См. AI-возможности.
• Формат кода языка подсказывает редактор. Если значение не подходит под формат (2–3 строчные буквы, опционально -XX для региона), под полем появится «Не соответствует формату: …». Сохранение и публикацию это не блокирует, поэтому исправьте код сами: иначе ошибка проявится только при выполнении.
• Тир модели изменить нельзя — поле «Модель» у блока перевода отсутствует.
• Один текст — до 20 000 символов. Более длинный текст перевести за один вызов не получится.
• Персональные данные в перевод не попадают. Email, телефоны, номера карт и длинные числа (от 10 цифр) заменяются на *** ещё до перевода.
• Оскорбительный текст может не перевестись. Если проверка безопасности сочтёт текст недопустимым (оскорбления, угрозы и т. п.), блок уйдёт в выход «Ошибка».
• Ручного перевода в чате нет — в интерфейсе только блок в сценарии (по API — см. выше).
• Словаря терминов и глоссария нет. Подсказать переводчику, как переводить названия продуктов, нельзя.
• Язык клиента нигде не хранится. Определённый язык живёт только внутри запуска сценария: в карточку контакта он не записывается, и следующий диалог начнётся с определения заново.
• Перевод — это AI-результат: для критичных коммуникаций формулировку стоит проверять человеку.

---

→ AI-возможности · Автоматизация (сценарии) · AI-блоки в сценариях