Вы запускаете движок локализации. Сильный движок — не пустой: в нём живут тональность бренда, глоссарий и правила, поэтому каждый перевод звучит как ваш продукт и не коверкает термины, которые вы уже утвердили.
Как правило, все эти знания уже есть — ещё до того, как появился движок. Они лежат в руководстве по бренду, стайлгайде, терминологическом листе, паре абзацев правил, которые когда-то выдавали переводчику. Собирать движок вручную — значит читать всё это и заново вбивать как записи тональности бренда, глоссария и правил, по одной за раз. Нудно: легко начать и легко бросить на полпути.
API асинхронного провижининга закрывает этот пробел: просто укажите на то, что у вас уже есть. Отправьте ссылки и текст одним запросом — и сразу получите 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-агент анализирует всё и извлекает три вида конфигурации — тональность бренда, элементы глоссария и правила — применяя каждый к движку по мере нахождения. Если источник не удалось обойти или отдельный элемент не удалось создать, остальные продолжают обрабатываться. Что извлекает AI — охватывает все три компонента и то, как они привязываются к локалям.
Движок готов
Когда извлечение завершается, движок полностью настроен и готов к переводу через Localization API. Платформа сообщает о завершении — с краткой сводкой всего, что было создано, — на ваш webhook URL или в реальном времени через WebSocket задачи, если вы хотите показывать прогресс по ходу выполнения.
ID движка можно использовать сразу.
ID eng_ в 202 — это настоящий движок с той самой секунды, как вы его получаете. Вы можете сохранить его, ссылаться на него и сразу использовать для перевода — конфигурация применяется по мере выполнения задачи, поэтому перевод, сделанный раньше, увидит меньше извлечённых записей, чем перевод после завершения задачи. Вам не нужно ждать окончания развёртывания, чтобы начать пользоваться движком.
Аутентификация
Каждый запрос — REST и WebSocket — проходит аутентификацию через ваш заголовок X-API-Key. Ключи привязаны к организации и дают доступ ко всем движкам в её пределах. Подробности см. в Authentication, а создать ключ можно в API Keys.
Что вы получите#
Скептически настроенный читатель уже задаёт два вопроса, от которых зависит, можно ли безопасно на это опираться: что, если источник плохой, и не окажется ли всё это чёрным ящиком, который нельзя исправить?
Всё прозрачно. Провижининг не возвращает непрозрачный блоб — он создаёт обычные записи тональности бренда, глоссария и правил на реальном движке, те же объекты, которые вы бы создали вручную, и каждый из них можно отредактировать в панели управления. Когда задание завершается, вы получаете сводку с перечнем всех созданных записей и всех ошибок — чтобы убедиться в правильности конфигурации, а не просто надеяться на лучшее. Что извлекает AI — разбирает эту сводку и то, как проблемный элемент попадает в список errors, пока остальная часть движка продолжает настраиваться.
Источники необязательны. Отправьте имя без sources, и вы получите чистый движок с настройками по умолчанию, который сможете настроить самостоятельно — этот вариант, как и структуру ответа , описывает 202Create a provisioning job. Развёртывание помогает пропустить ручную настройку, но не является обязательным условием для создания движка.
Общие страницы дают и общую конфигурацию.
Качество конфигурации зависит только от того, что именно вы отправляете: брендбук и терминологические списки дают агенту конкретный материал для извлечения, а маркетинговая главная страница почти ничего не даст. В Source types объясняется, на что именно стоит указывать.
В этом и состоит компромисс развёртывания: вы тратите один запрос и немного времени на ожидание, а взамен пропускаете этап переноса знаний, которые уже однажды записали, — просто укажите то, что у вас уже есть, и начинайте с уже настроенного движка. Ниже — страницы, которые раскрывают каждую часть этой идеи.
