Вы разворачиваете движок локализации. Хорошо переводит не пустой движок, а тот, в котором уже есть тональность бренда, глоссарий и инструкции, — тогда каждый перевод звучит как часть вашего продукта и не искажает термины, которые вы уже утвердили.
Обычно все эти знания появляются раньше самого движка. Они уже есть в брендбуке, гайде по стилю, терминологической таблице, в нескольких абзацах правил, которые когда-то передали переводчику. Собирать движок вручную — значит прочитать всё это и заново внести в виде записей о тональности бренда, элементов глоссария и инструкций, по одной за раз. Работа монотонная: её легко начать и так же легко бросить на полпути.
API асинхронного развёртывания устраняет этот разрыв: просто укажите то, что у вас уже есть. Вы отправляете POST-запрос со ссылками и сырым текстом, сразу получаете ID движка, а AI-агент обходит источники, извлекает тональность бренда, элементы глоссария и инструкции и применяет их к новому движку по мере обнаружения. Движком можно пользоваться с момента получения ID — конфигурация дополняется по ходу выполнения задачи.
На этой странице
Проблема#
Движок локализации хорош ровно настолько, насколько хороша его конфигурация. Выбор модели даёт вам перевод, а тональность бренда, элементы глоссария и инструкции делают этот перевод созвучным тому, как уже говорит ваш продукт: с выбранным уровнем формальности, с названиями продуктов, которые вы никогда не переводите, с форматом даты, который используете всегда. Это те же сущности, которые иначе пришлось бы создавать вручную: тональности бренда, элементы глоссария и инструкции в движке.
Но вся загвоздка в том, что всё это уже где-то существует. У команды, выпустившей продукт хотя бы на одном языке, уже есть брендбук, гайд по стилю, глоссарий терминов, которые агентам поддержки велят никогда не переводить. Чтобы настроить движок вручную, нужно прочитать эти документы и перенести их в записи — решение за решением, локаль за локалью. Это медленно, а самая долгая часть при этом и самая неинтересная: переносить уже зафиксированные знания в другую форму.
Развёртывание убирает этот шаг. Вы передаёте платформе сами документы — в виде URL для обхода или сырого текста, — а AI-агент берёт на себя чтение и перенос. Он создаёт для вас записи о тональности бренда, элементы глоссария и инструкции в реальном движке, применяя каждую по мере распознавания. Затем вы просматриваете и при необходимости корректируете результат в панели управления — так же, как редактировали бы всё, что создали сами. Отправная точка здесь — уже настроенный движок, а не пустой.
Развёртывание настраивает движок, а не переводит.
Этот API создаёт и настраивает движок. Чтобы переводить с помощью движка после его создания, используйте асинхронный API локализации для множества локалей сразу или синхронный эндпоинт Localize для одной пары локалей. Развёртывание — это этап настройки, благодаря которому эти вызовы с самого первого перевода учитывают вашу тональность бренда и глоссарий.
Как это работает#
Всего три шага, и только первый из них происходит в рамках вашего запроса. Два остальных выполняются на платформе в своём темпе — именно поэтому вызов сразу возвращает результат, а движком можно пользоваться ещё до завершения всей работы.
Отправьте свои источники
Отправьте через POST имя нового движка и массив источников — URL для обхода, сырой текст для анализа или и то и другое — в /jobs/provisioning. API сразу создаёт движок и возвращает 202 с ID движка (eng_) и ID задачи (pjb_). Ваше приложение может продолжать работу: ответ не ждёт завершения извлечения. Полную структуру запроса и ответа см. в Create a provisioning job, а о том, какие источники стоит отправлять, — в Source types.
AI-агент обходит источники и извлекает данные
Источники в виде ссылок обходятся параллельно и преобразуются в текст; сырой контент читается напрямую. Затем AI-агент анализирует всё содержимое и извлекает три типа конфигурации — тональности бренда, элементы глоссария и инструкции, — применяя каждую к движку по мере распознавания. Если какой-то источник не удалось обойти или не удалось создать отдельный элемент, это не останавливает остальную работу. В What the AI extracts описаны эти три компонента и то, как они сопоставляются с локалями.
Движок готов
Когда извлечение завершается, движок полностью настроен и готов к переводу через Localization API. Платформа сообщает о завершении — с краткой сводкой всего, что было создано, — на ваш webhook URL или в реальном времени через WebSocket задачи, если вы хотите показывать прогресс по ходу выполнения.
ID движка можно использовать сразу.
ID eng_ в 202 — это настоящий движок с той самой секунды, как вы его получаете. Вы можете сохранить его, ссылаться на него и сразу использовать для перевода — конфигурация применяется по мере выполнения задачи, поэтому перевод, сделанный раньше, увидит меньше извлечённых записей, чем перевод после завершения задачи. Вам не нужно ждать окончания развёртывания, чтобы начать пользоваться движком.
Аутентификация
Каждый запрос — REST и WebSocket — проходит аутентификацию через ваш заголовок X-API-Key. Ключи привязаны к организации и дают доступ ко всем движкам в её пределах. Подробности см. в Authentication, а создать ключ можно в API Keys.
Что вы получите#
Скептически настроенный читатель уже задаёт два вопроса, от которых зависит, можно ли безопасно на это опираться: что, если источник плохой, и не окажется ли всё это чёрным ящиком, который нельзя исправить?
Ничего не скрыто. Развёртывание не возвращает вам некий проприетарный blob — оно создаёт обычные записи о тональности бренда, элементы глоссария и инструкции в реальном движке, то есть ровно те же объекты, которые вы создавали бы вручную, и каждый из них потом можно редактировать в панели управления. Когда задача завершается, вы получаете сводку, в которой перечислены все созданные записи и все возникшие сбои, так что конфигурацию можно проверить, а не просто принять на веру. В What the AI extracts объясняется эта сводка и то, как неудавшийся элемент изолируется в списке errors, пока остальная часть движка продолжает настраиваться.
Источники необязательны. Отправьте имя без sources, и вы получите чистый движок с настройками по умолчанию, который сможете настроить самостоятельно — этот вариант, как и структуру ответа 202, описывает Create a provisioning job. Развёртывание помогает пропустить ручную настройку, но не является обязательным условием для создания движка.
Общие страницы дают и общую конфигурацию.
Качество конфигурации зависит только от того, что именно вы отправляете: брендбук и терминологические списки дают агенту конкретный материал для извлечения, а маркетинговая главная страница почти ничего не даст. В Source types объясняется, на что именно стоит указывать.
В этом и состоит компромисс развёртывания: вы тратите один запрос и немного времени на ожидание, а взамен пропускаете этап переноса знаний, которые уже однажды записали, — просто укажите то, что у вас уже есть, и начинайте с уже настроенного движка. Ниже — страницы, которые раскрывают каждую часть этой идеи.
