Функция «Своя система» (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) к профилю МП:
-
На странице профиля МП Phrase Language AI нажмите Подключить движки МП.
Отобразится страница .
-
Выберите Своя система (BYO).
Откроется страница настройки своей системы.
-
В разделе выберите метод подключения:
-
: для размещенного адаптера.
-
: затем выберите вариант, совместимый с OpenAI.
-
: затем загрузите файл шаблона или вставьте JSON в редактор.
-
-
Введите .
Для методов шаблонов укажите версию API в URL-адресе, например
https://api.openai.com/v1. -
Выберите и предоставьте учетные данные:
-
: введите (обычно
Authorization) и . Phrase отправляет значение в точности так, как оно введено, поэтому включите любой префикс, напримерBearer, за которым следует ключ. -
: введите учетные данные клиента OAuth 2.0.
-
-
Выберите, нужно ли . Включено по умолчанию.
Сокращает трафик и ускоряет получение перевода за счет повторного использования сегментов, переведенных за последние 30 дней. Это оптимизация только производительности запросов. Это не снижает стоимость перевода. Оставьте его включенным по умолчанию и отключайте только во время активной разработки базового адаптера движка.
-
При необходимости укажите дополнительные сведения о системе в разделе
-
Нажмите Проверить подключение, чтобы проверить, работает ли интеграция с движком.
-
Нажмите Добавить.
Теперь движок доступен для включения в профиле.
Рекомендации
При использовании «Своей системы» не включайте другие движки в профиле МП. Это гарантирует, что для предварительного перевода будет выбрана «Своя система».
«Своя система 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 проверяет шаблон при нажатии кнопки Проверить подключение.
Редактирование «Своей системы»
Чтобы отредактировать «Свою систему», нажмите значок редактирования на её плитке.
Удаление «Своей системы»
Чтобы удалить «Свою систему»:
Часто задаваемые вопросы
|
Вопрос: |
Почему требуется запрос состояния? Отправляется ли он Phrase в движок или его должен обрабатывать клиент? |
|
Ответ: |
Phrase отправляет запрос, чтобы проверить, работает движок или нет. |
|
Вопрос: |
Один запрос может содержать 500 |
|
Ответ: |
Синхронные и асинхронные вызовы принимают от 1 до 500 сегментов. На практике синхронные вызовы из редактора содержат один сегмент, а при вызовах API и в пакетных процессах (предварительный перевод, анализ) может передаваться до 500 сегментов. Асинхронный поток использует тот же лимит и только разделяет отправку задания и получение результата. Время ожидания асинхронного запроса составляет около 30 минут. Мы не переключаемся автоматически с синхронного на асинхронный режим, если ваш адаптер отклоняет запрос. Подробнее о том, чего ожидать от Phrase (количество сегментов, тест работоспособности системы, повторные попытки и ограничения по времени), см. в руководстве по «Своей системе». |
|
Вопрос: |
Все ли термины глоссария отправляются в запросе или только их часть? |
|
Ответ: |
Отправляются все термины глоссария. |
|
Вопрос: |
Можно ли подключить LLM? |
|
Ответ: |
Это должно быть возможно с помощью обертки. Пока движок возвращает сегменты в соответствии со схемой, Phrase не требует использования конкретного движка или LLM. |
|
Вопрос: |
Возможна ли пользовательская оценка качества (QE)? |
|
Ответ: |
Сторонняя оценка качества (QE) не поддерживается. |
|
Вопрос: |
Как обрабатываются теги? |
|
Ответ: |
Контент, который получает Phrase, предварительно обрабатывается. HTML-теги преобразуются в метки, и эти метки передаются в неизменном виде. |
|
Вопрос: |
Можем ли мы реализовать только асинхронный подход? Будет ли это корректно работать во всех компонентах Phrase (предварительный перевод, «Редактор» и т. д.)? |
|
Ответ: |
Нет, необходимо реализовать оба подхода (в идеале — все конечные точки). Синхронная конечная точка используется, например, в «Редакторе», а асинхронная — в таких процессах, как предварительный перевод. |
|
Вопрос: |
Что происходит, когда движок получает несколько запросов одновременно? |
|
Ответ: |
Движок должен быть способен справиться с этим. Обеспечьте корректную обработку одновременных запросов и потокобезопасность во всех конечных точках, особенно асинхронных. |
|
Вопрос: |
Как работают ? |
|
Ответ: |
Метаданные запроса, настроенные как «Пользовательские метки» в конфигурации «Своей системы», поддерживают динамические заполнители, значения которых подставляются до поступления запроса в адаптер: |
|
Вопрос: |
Как работают «Метаданные сегмента»? |
|
Ответ: |
В настоящее время они должны быть частью схемы. |
|
Вопрос: |
Использует ли «Своя система» 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" }