Машинный перевод

Своя система

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

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

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

  • Предприятий со специализированными моделями МП.

  • Лингвистических компаний (LSP) с собственными клиентскими движками или предпочтительными стеками ИИ.

  • Организаций с внутренней политикой, требующей использования определенных движков (например, 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 BYO API

Размещённый адаптер, который реализует API «Своей системы» и вызывает систему

Созданный, протестированный и размещенный адаптер

Готовый шаблон (Lite)

API движка напрямую, с использованием шаблона, поддерживаемого Phrase

Базовый URL движка и учетные данные

Пользовательский шаблон (Lite)

API движка напрямую, с использованием шаблона, написанного организацией

Базовый URL движка, учетные данные и JSON-шаблон

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

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

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

Создание адаптера требуется только для метода адаптера Phrase BYO API. Для методов «Готовый шаблон» и «Пользовательский шаблон» адаптер не требуется.

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

    Адаптер должен поддерживать:

    • Запросы на перевод

    • Поддержка языковых пар

    • Проверка состояния движка (Phrase отправляет запрос состояния)

  • Базовая инфраструктура (движок МП или LLM) должна размещаться и обслуживаться организацией.

  • Phrase требуются разрешения для подключения к этой инфраструктуре.

  • Адаптер должен возвращать переводы с тем же количеством сегментов и в том же порядке.

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

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

Чтобы подключить свою систему (BYO) к профилю МП:

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

    Отобразится страница Подключить движок МП.

  2. Выберите Своя система (BYO).

    Откроется страница настройки своей системы.

  3. В разделе API движка выберите метод подключения:

    • Адаптер Phrase BYO API: для размещенного адаптера.

    • Готовый шаблон: затем выберите вариант, совместимый с OpenAI.

    • Пользовательский шаблон: затем загрузите файл шаблона или вставьте JSON в редактор.

  4. Введите Базовый URL-адрес движка.

    Для методов шаблонов укажите версию API в URL-адресе, например https://api.openai.com/v1.

  5. Выберите Метод аутентификации и предоставьте учетные данные:

    • Заголовок HTTP: введите Имя заголовка (обычно Authorization) и Значение заголовка. Phrase отправляет значение в точности так, как оно введено, поэтому включите любой префикс, например Bearer, за которым следует ключ.

    • Учетные данные клиента (OAuth 2.0): введите учетные данные клиента OAuth 2.0.

  6. Выберите, нужно ли Использовать кэш переводов. Включено по умолчанию.

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

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

  8. Нажмите Проверить подключение, чтобы проверить, работает ли интеграция с движком.

  9. Нажмите Добавить.

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

Рекомендации

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

«Своя система Lite» (бета-версия)

«Своя система Lite» позволяет подключить движок, у которого уже есть HTTP API, например API, совместимый с OpenAI, без размещённого адаптера. Phrase вызывает API движка напрямую, используя JSON-шаблон, который описывает запрос и ответ.

Обратитесь к руководству по «Своей системе Lite» (бета-версия) в документации для разработчиков Phrase, чтобы узнать о структуре шаблона, переменных, ограничениях и устранении неполадок.

Примечание

«Своя система Lite» находится на этапе бета-тестирования и включается отдельно для каждой организации. Чтобы включить эту функцию, свяжитесь со своим менеджером по работе с клиентами или службой поддержки Phrase.

Готовый шаблон

Шаблон, совместимый с OpenAI, поддерживает OpenAI и сервисы, реализующие API OpenAI для генерации ответов в чате. Требуются только базовый URL движка и учетные данные.

При необходимости задайте следующие пользовательские метки:

  • model: имя модели. Требуется для сервисов, отличных от OpenAI.

  • custom_instructions: дополнительные правила, добавляемые к каждому запросу на перевод.

  • languages: коды локалей, разделенные запятыми, например en,de,fr, для ограничения языковых пар, предлагаемых движком.

Пользовательский шаблон

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

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

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

Удаление «Своей системы»

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

  1. Нажмите значок редактирования на плитке движка.

  2. Нажмите Удалить «Свою систему».

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

Вопрос:

Почему требуется запрос состояния? Отправляется ли он Phrase в движок или его должен обрабатывать клиент?

Ответ:

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

Вопрос:

Один запрос может содержать 500 maxItems в segments. Означает ли это, что 500 исходных предложений должны переводиться в режиме реального времени?

Ответ:

Синхронные и асинхронные вызовы принимают от 1 до 500 сегментов. На практике синхронные вызовы из редактора содержат один сегмент, а при вызовах API и в пакетных процессах (предварительный перевод, анализ) может передаваться до 500 сегментов. Асинхронный поток использует тот же лимит и только разделяет отправку задания и получение результата. Время ожидания асинхронного запроса составляет около 30 минут. Мы не переключаемся автоматически с синхронного на асинхронный режим, если ваш адаптер отклоняет запрос. Подробнее о том, чего ожидать от Phrase (количество сегментов, тест работоспособности системы, повторные попытки и ограничения по времени), см. в руководстве по «Своей системе».

Вопрос:

Все ли термины глоссария отправляются в запросе или только их часть?

Ответ:

Отправляются все термины глоссария.

Вопрос:

Можно ли подключить LLM?

Ответ:

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

Вопрос:

Возможна ли пользовательская оценка качества (QE)?

Ответ:

Сторонняя оценка качества (QE) не поддерживается.

Вопрос:

Как обрабатываются теги?

Ответ:

Контент, который получает Phrase, предварительно обрабатывается. HTML-теги преобразуются в метки, и эти метки передаются в неизменном виде.

Вопрос:

Можем ли мы реализовать только асинхронный подход? Будет ли это корректно работать во всех компонентах Phrase (предварительный перевод, «Редактор» и т. д.)?

Ответ:

Нет, необходимо реализовать оба подхода (в идеале — все конечные точки). Синхронная конечная точка используется, например, в «Редакторе», а асинхронная — в таких процессах, как предварительный перевод.

Вопрос:

Что происходит, когда движок получает несколько запросов одновременно?

Ответ:

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

Вопрос:

Как работают метаданные запроса?

Ответ:

Метаданные запроса, настроенные как «Пользовательские метки» в конфигурации «Своей системы», поддерживают динамические заполнители, значения которых подставляются до поступления запроса в адаптер: {project_uid}, {job_uid} и {idm_organization_uid}. Например, если у «Пользовательской метки» ключ project_uid, а значение — {project_uid}, адаптер получает фактический UID проекта Phrase TMS. Значения заполнителей подставляются только в текстовых значениях. Неизвестный заполнитель передаётся адаптеру в исходном виде, без подстановки значения.

Вопрос:

Как работают «Метаданные сегмента»?

Ответ:

В настоящее время они должны быть частью схемы.

Вопрос:

Использует ли «Своя система» RAG для получения контекста во время машинного перевода?

Ответ:

Нет, BYOE не использует RAG. Пользователи могут использовать ТМ для определения того, какие сегменты переведены, но в самом процессе машинного перевода ТМ не используются. Это связано с тем, что движки машинного перевода должны быть специально разработаны для использования данных ТМ с помощью RAG, а в сценариях BYOE нет контроля над тем, как движки создаются или настраиваются.

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

Адаптер должен возвращать ответы, которые точно соответствуют следующим именам полей и значениям перечислений. Несоответствие приводит к общей ошибке 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": "Description of translation failure" }

Была ли эта статья полезной?
★ ★ ★ ★ ★

Sorry about that! In what way was it not helpful?

The article didn’t address my problem.
I couldn’t understand the article.
The feature doesn’t do what I need.
Other reason.

Note that feedback is provided anonymously so we aren't able to reply to questions.
If you'd like to ask a question, submit a request to our Support team.
Thank you for your feedback.