Nasazujete lokalizační engine. Engine, který překládá dobře, není prázdný – je to ten, který nese hlas vaší značky, váš glosář a vaše instrukce, takže každý překlad zní jako váš produkt a nikdy nezkreslí termín, na kterém už jste se shodli.
Tyto znalosti obvykle existují dřív než samotný engine. Leží na stránce s brand guidelines, ve stylistické příručce, v terminologickém přehledu, v několika odstavcích pravidel, které kdysi dostal překladatel. Vytvořit engine ručně znamená všechno tohle přečíst a znovu zapsat jako záznamy pro hlas značky, glosář a instrukce, jeden po druhém – zdlouhavá práce, kterou je snadné začít a stejně snadné nechat rozdělanou.
Asynchronní provisioning API tuto mezeru uzavírá: nasměrujte ho na to, co už máte. V jednom požadavku pošlete odkazy i surový text, okamžitě dostanete ID enginu a AI agent mezitím prochází zdroje, vytahuje hlasy značky, položky glosáře a instrukce a průběžně je aplikuje na nový engine, jakmile je najde. Engine je použitelný od chvíle, kdy dostanete ID – konfigurace se doplňuje za běhu úlohy.
Na této stránce
Problém#
Lokalizační engine je jen tak dobrý jako jeho konfigurace. Volba modelu vám dá překlad; hlasy značky, položky glosáře a instrukce jsou to, co zajistí, aby překlad odpovídal tomu, jak váš produkt už mluví – zvolené míře formálnosti, názvům produktů, které nikdy nepřekládáte, nebo formátu data, který používáte vždy. To jsou stejné stavební prvky, které byste jinak vytvářeli ručně: hlasy značky, položky glosáře a instrukce v enginu.
Háček je v tom, že to všechno už někde existuje. Tým, který uvedl produkt v jednom jazyce, má stránku s brand guidelines, stylistickou příručku a glosář termínů, které mají pracovníci podpory zakázáno překládat. Pokud chcete engine nakonfigurovat ručně, čtete tyto dokumenty a přepisujete je do záznamů – rozhodnutí po rozhodnutí, jazyk po jazyku. Je to pomalé a ta nejpomalejší část je zároveň nejméně zajímavá: kopírování znalostí, které už jsou sepsané, do jiné podoby.
Provisioning tento krok odstraňuje. Platformě předáte samotné dokumenty – jako URL ke crawlování nebo jako surový text – a AI agent udělá čtení i přepis za vás. Vytvoří na skutečném enginu záznamy pro hlas značky, glosář i instrukce a každý z nich aplikuje hned, jakmile ho identifikuje. Potom vše zkontrolujete a upravíte v dashboardu stejným způsobem, jako byste upravovali cokoli, co jste vytvořili sami. Výchozím bodem je nakonfigurovaný engine, ne prázdný.
Provisioning engine konfiguruje; nepřekládá.
Toto API engine vytváří a konfiguruje. Pokud s ním chcete překládat, jakmile existuje, sáhněte po asynchronním Localization API pro mnoho jazyků najednou nebo po synchronním endpointu Localize pro jednu dvojici jazyků. Provisioning je krok nastavení, díky kterému tyto volání nesou hlas vaší značky a váš glosář už od prvního překladu.
Jak to funguje#
Jsou to tři kroky a jen ten první probíhá v rámci vašeho požadavku. Zbylé dva běží na platformě vlastním tempem – proto se volání vrátí okamžitě a engine je použitelný ještě před dokončením práce.
Odešlete své zdroje
Metodou POST odešlete název nového enginu a pole zdrojů – URL ke crawlování, surový text k analýze nebo obojí – na /jobs/provisioning. API engine okamžitě vytvoří a vrátí 202 s ID enginu (eng_) a ID úlohy (pjb_). Vaše aplikace může bez omezení pokračovat; nic v odpovědi nečeká na extrakci. Úplný tvar požadavku a odpovědi najdete v části Vytvořit provisioning úlohu a informace o tom, co dělá zdroj vhodným k odeslání, v části Typy zdrojů.
AI agent prochází zdroje a extrahuje
Odkazové zdroje se crawlují paralelně a převádějí na text; surový obsah se čte přímo. AI agent pak vše analyzuje a extrahuje tři typy konfigurace – hlasy značky, položky glosáře a instrukce – a každou z nich aplikuje na engine, jakmile ji identifikuje. Zdroj, který se nepodaří projít, ani jednotlivá položka, kterou nelze vytvořit, nezastaví zbytek. Část Co AI extrahuje popisuje všechny tři komponenty a to, jak se mapují na jazyky.
Engine je připraven
Po dokončení extrakce je engine plně nakonfigurovaný a připravený překládat prostřednictvím Localization API. Platforma nahlásí dokončení – spolu se souhrnem všeho, co bylo vytvořeno – na vaše webhook URL nebo živě přes WebSocket úlohy, pokud chcete během běhu zobrazovat průběh.
ID enginu je použitelné okamžitě.
ID eng_ v 202 představuje skutečný engine od okamžiku, kdy ho obdržíte. Můžete ho uložit, odkazovat se na něj a hned přes něj překládat – konfigurace se aplikuje během běhu úlohy, takže překlad vytvořený brzy uvidí méně extrahovaných záznamů než ten, který vznikne po dokončení úlohy. Na provisioning nikdy nemusíte čekat, abyste mohli engine začít používat.
Co dostanete zpět#
Skeptický čtenář si už klade dvě otázky, které rozhodují o tom, jestli je bezpečné se na to spolehnout: co když je zdroj špatný a není to černá skříňka, kterou nemohu opravit?
Ani jedna z odpovědí se neskrývá. Provisioning nevrací proprietární blob – vytváří běžné záznamy pro hlas značky, glosář a instrukce na skutečném enginu, přesně ty samé objekty, které byste vytvářeli ručně, a každý z nich lze následně upravit v dashboardu. Po dokončení úlohy vrátí souhrn, který pojmenuje každý vytvořený záznam i každé selhání, na které narazil, takže můžete konfiguraci ověřit místo toho, abyste ji jen předpokládali. Co AI extrahuje vysvětluje tento souhrn i to, jak se nepodařená položka izoluje do seznamu errors, zatímco zbytek enginu se dál konfiguruje.
Zdroje jsou také nepovinné. Odešlete název bez sources a dostanete čistý engine s výchozím nastavením, který si můžete nakonfigurovat sami – část Vytvořit provisioning úlohu popisuje tuto cestu spolu s tvarem odpovědi 202. Provisioning je způsob, jak přeskočit ruční nastavení, nikoli předpoklad k tomu, abyste engine vůbec měli.
Obecné stránky vytvářejí obecnou konfiguraci.
Konfigurace je jen tak dobrá jako to, co odešlete – brand guidelines a terminologické seznamy dávají agentovi něco konkrétního k extrakci; marketingová homepage nepřinese téměř nic. Část Typy zdrojů popisuje, na co ho nasměrovat.
To je výměna, kterou provisioning nabízí: věnujete jeden požadavek a krátké čekání, a výměnou přeskočíte přepisování znalostí, které už máte sepsané – nasměrujte ho na to, co už máte, a začněte s nakonfigurovaným enginem. Stránky níže rozebírají jednotlivé části této věty.
