Своя система

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

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

Своя система подходит для:

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

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

Где можно использовать Свою систему

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

Настройка своей системы

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

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

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

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

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

Чтобы подключить Свою систему к профилю машинного перевода:

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

Отобразится страница Подключить движок МП.
Выберите Свою систему (BYO Engine).

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

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

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

Редактирование своей системы

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

Удалить свою систему

Чтобы удалить свою систему:

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

ЧАСТО ЗАДАВАЕМЫЕ ВОПРОСЫ

В:	Почему требуется запрос статуса? Отправляется ли запрос от 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	В настоящее время они должны быть частью схемы.
Вопрос:	Использует ли Своя система RAG для получения контекста во время машинного перевода?
A	Нет, Своя система не использует RAG. Пользователи могут использовать ТМ для определения того, какие сегменты переведены, но они не используются в самом процессе машинного перевода. Это связано с тем, что движки МП должны быть специально разработаны для включения данных ТМ через RAG, а в сценариях использования собственной системы нет контроля над тем, как они создаются или настраиваются.

Справочник схемы адаптера

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

POST /status должен возвращать поле 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\": \"Описание ошибки перевода\" }