Как настроить движок

Добавьте в движок глоссарий, правила и тональность бренда на основе страниц сайта или предоставленного текста.

Провижининг превращает исходные материалы в рекомендации для перевода. Выберите, какие рекомендации нужно создать, добавьте ссылки на страницы сайта или текст. Затем проверьте полученные глоссарий, набор правил и тональность бренда, прежде чем использовать движок.

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

Как подготовить исходные данные #

Используйте страницы или текст с описанием терминологии продукта, правил написания и тональности. Выберите glossary, ruleset, brandVoice или их сочетание. Для каждого выбранного типа рекомендаций вы можете задать название нового набора.

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

Как отслеживать задание #

После успешной отправки запроса API возвращает задание с id, engineId, status и kinds. Сохраните оба ИД. Периодически опрашивайте GET /v2/provisioning/jobs/:id, чтобы следить за выполнением и получить итоговый результат. В разделе Как читать результаты провижининга объясняется, когда каждый ресурс готов к использованию.

Проверяйте результат для каждого запрошенного типа рекомендаций отдельно. Один тип может быть создан успешно, а другой — с ошибкой. Успешно созданные наборы остаются привязанными к движку. Поэтому после устранения причины ошибки повторяйте попытку только для типов, которые остались пустыми из-за сбоя.

Как проверить рекомендации #

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

В разделе Результаты провижининга объясняются возвращаемые состояния. В разделе Заполнить на основе сайта описано, как выполнить ту же задачу в панели управления.