BYO Engine

Контент автоматически переведен с английского языка с помощью Phrase Language AI.

Функция «Bring Your Own Engine» (BYO Engine) позволяет интегрировать внешние движки машинного перевода (МТ) в Phrase для использования в рабочих процессах перевода, как и любые другие поставщики МТ.

BYO Engine подходит для:

Предприятиям с отраслевыми моделями МТ.
Поставщикам языковых услуг (LSP) с пользовательскими клиентскими движками или предпочтительными стеками ИИ.
Организациям с внутренними политиками, требующими использования конкретных движков (например, Gemini, внутренних LLM и т. д.).

Пользовательские обученные движки можно использовать, или переводы можно направлять во внутренние LLM или к поставщикам МТ, чтобы сохранить полный контроль над качеством, конфиденциальностью и стоимостью, продолжая при этом пользоваться преимуществами памяти переводов (TM), глоссариев, QPS и CAT editor в Phrase.

Где можно использовать BYO Engine

После интеграции BYO Engine становится доступен для предварительного перевода. Настройте его в профиле Phrase Language AI и используйте этот профиль для предварительного перевода из проектов Phrase TMS, Phrase Portal, Phrase Strings, Phrase Studio и Phrase Language AI через API.

Настройка BYO Engine

Создание адаптера

Организация должна создать и протестировать облегчённый API-адаптер. Этот адаптер обеспечивает связь между Phrase и движком.

Адаптер должен поддерживать:
- Запросы на перевод
- Поддержку языковых пар
- Проверку статуса движка (Phrase отправляет запрос на статус)
Базовая инфраструктура (движок МТ или LLM) должна размещаться и обслуживаться организацией.
Phrase требует разрешений для подключения к этой инфраструктуре.
Адаптер должен возвращать переводы с тем же количеством сегментов и порядком.

Интеграция движка в профиль машинного перевода (МТ)

После того как API-адаптер будет реализован и развернут, BYO Engine станет доступен в Phrase Language AI для выбора в профилях машинного перевода (МТ) и может быть назначен проектам.

Чтобы подключить BYO Engine к профилю машинного перевода (МТ):

На странице профиля машинного перевода (МТ) Phrase Language AI нажмите Подключить системы машинного перевода (МТ).

Отобразится страница Подключить систему машинного перевода (МТ).
Выберите Bring Your Own (BYO) Engine.

Откроется страница конфигурации BYO Engine.
Введите Базовый URL BYO Engine.
Укажите учетные данные в зависимости от метода аутентификации (заголовок HTTP или учетные данные клиента (OAuth 2.0)).
Выберите, использовать ли кэш переводов. Включено по умолчанию.

Снижает трафик и ускоряет ответ при переводе за счет повторного использования сегментов, переведенных за последние 30 дней. Это только оптимизация производительности вызовов, она не снижает стоимость перевода. Оставьте включенным по умолчанию, отключайте только во время активной разработки адаптера базовой системы.
При необходимости предоставьте любую дополнительную информацию для BYO Engine в разделе Пользовательские метки.
Нажмите Проверить соединение, чтобы проверить, работает ли интеграция системы.
Нажмите Добавить.

Теперь BYO Engine доступен для включения в профиле.

Совет

При использовании BYO Engine не включайте никакую другую систему в профиле машинного перевода (МТ). Это гарантирует, что для предварительного перевода выбран BYO Engine.

Редактировать BYO Engine

Чтобы отредактировать BYO Engine, нажмите значок редактирования на плитке BYO Engine.

Удалить BYO Engine

Чтобы удалить BYO Engine:

Нажмите значок редактирования на плитке BYO Engine.
Нажмите Удалить BYO Engine.

Часто задаваемые вопросы

Вопрос:	Почему требуется запрос статуса? Он отправляется Phrase к движку или должен обрабатываться клиентом?
A:	Phrase отправляет запрос, чтобы проверить, работает движок или нет.
Вопрос:	Один запрос может содержать 500 `maxItems` в `сегментах`. Означает ли это, что 500 предложений оригинала должны быть переведены в режиме реального времени?
A:	Синхронные вызовы включают только до 5 сегментов, в то время как асинхронные вызовы могут включать больше, до 500. Кроме того, время ожидания асинхронного вызова составляет около 30 минут.
Вопрос:	Все ли термины глоссария отправляются в запросе или только их часть?
A:	Отправляются все термины глоссария.
Вопрос:	Можно ли подключить LLM?
A:	Это должно быть возможно с помощью обертки. Пока движок возвращает сегменты в соответствии со схемой, Phrase не требует использования конкретного движка или LLM.
Вопрос:	Возможна ли пользовательская оценка качества (QE)?
A:	Сторонняя QE не поддерживается.
Вопрос:	Как обрабатываются теги?
A:	Контент, который получает Phrase, предварительно обрабатывается. HTML-теги преобразуются в метки, и эти метки передаются как есть.
Вопрос:	Можем ли мы реализовать только асинхронный подход? Будет ли это работать корректно во всех областях Phrase (предварительный перевод, редактор и т. д.)?
A:	Нет, должны быть реализованы оба подхода (в идеале все конечные точки). Синхронная конечная точка используется, например, редактором, в то время как асинхронная используется в таких областях, как предварительный перевод.
Вопрос:	Что происходит, когда движок получает несколько запросов одновременно?
A:	Движок должен уметь справляться с этим. Обеспечьте надлежащую обработку параллелизма и потокобезопасности во всех конечных точках, особенно в асинхронных.
Вопрос:	Как работают метаданные запроса?
A:	Они должны оставаться статичными, как определено при настройке движка.
Вопрос:	Как работают метаданные сегмента?
A:	В настоящее время они должны быть частью схемы.
Вопрос:	Использует ли BYOE RAG для получения контекста во время обработки МТ?
A:	Нет, BYOE не использует RAG. Пользователи могут использовать ТМ, чтобы определить, какие сегменты переведены, но они не используются в самом процессе МТ. Это связано с тем, что движки МТ должны быть специально разработаны для включения данных TM через RAG, а в сценариях BYOE нет контроля над тем, как движки создаются или настраиваются.

Справочный файл схемы адаптера

Адаптер должен возвращать ответы, которые точно соответствуют следующим именам полей и значениям перечисления. Несоответствие приводит к общей ошибке INTERNAL_ERROR от Phrase, даже если сам адаптер возвращает ответ 200 OK.

POST /status должен возвращать поле статус со строгим значением перечисления в нижнем регистре: либо ok, либо not_ok. Пример: { \"status\": \"ok\" }
POST /languages должен возвращать массив languagePairs (в формате camelCase), где каждая запись содержит поле sourceLanguage и поле targetLanguage. Пример: { \"languagePairs\": [ { \"sourceLanguage\": \"en\", \"targetLanguage\": \"es\" } ] }
POST /translate и GET /translateAsyncResult/{id} должны возвращать поля верхнего уровня sourceLanguage и targetLanguage, а также массив segments, где каждый сегмент включает как поле text (повторенный оригинал), так и поле translatedText. Возврат только translatedText или использование другого имени ключа приводит к ошибке десериализации.
POST /translateAsync требует только поле id в своем ответе. Поле status не является частью этой схемы ответа и игнорируется, если присутствует.
GET /translateAsyncStatus/{id} должен возвращать поле status с использованием одного из трех значений перечисления: running для задания, которое все еще обрабатывается, done для успешно завершенного задания или failed для задания, завершившегося с ошибкой. Для задания, завершившегося с ошибкой, необязательное поле detail может описывать сбой. Примеры значений: { \"status\": \"running\" }, { \"status\": \"done\" }, { \"status\": \"failed\", \"detail\": \"Description of translation failure\" }