Nasazujete lokalizační engine. Engine, který překládá dobře, není ten prázdný – je to ten, který v sobě nese váš hlas značky, váš glosář a vaše pravidla, takže každý překlad zní jako váš produkt a nikdy nezkreslí termín, o kterém už bylo rozhodnuto.
Tyto znalosti obvykle existují dřív než samotný engine. Najdete je na stránce s pravidly značky, ve stylistické příručce, v terminologickém přehledu nebo v několika odstavcích pravidel, které překladatel kdysi dostal. Vytvářet engine ručně znamená to všechno projít a znovu zadat jako záznamy pro hlas značky, glosář a pravidla, jeden po druhém – zdlouhavá práce, do které se snadno pustíte a stejně snadno ji necháte napůl hotovou.
Asynchronní provisioning API tuto mezeru překlene: namiřte ho na to, co už máte. V jediném požadavku odešlete odkazy a surový text, okamžitě dostanete zpět ID enginu a AI agent projde zdroje, vytěží z nich hlasy značky, položky glosáře a pravidla a postupně je aplikuje na nový engine podle toho, jak je nachází. Engine můžete používat od chvíle, kdy dostanete ID – konfigurace se doplňuje v průběhu běhu úlohy.
Na této stránce
Problém#
Lokalizační engine je jen tak dobrý, jak dobrá je jeho konfigurace. Volba modelu vám zajistí překlad; hlasy značky, položky glosáře a pravidla pak zajistí, aby překlad odpovídal tomu, jak váš produkt už mluví – zvolené úrovni formálnosti, názvům produktů, které nikdy nepřekládáte, nebo formátu data, který používáte vždy. Jsou to stejné základní stavební prvky, které byste jinak vytvářeli ručně: hlasy značky, položky glosáře a pravidla na 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 adresy ke crawlování nebo jako surový text – a AI agent se postará o čtení i přepis. Na skutečném enginu za vás vytvoří záznamy pro hlas značky, glosář a pravidla a každý z nich aplikuje hned, jakmile ho rozpozná. Potom vše zkontrolujete a upravíte v dashboardu stejně, 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
Zdroje z odkazů se crawlují paralelně a převádějí na text; surový obsah se čte přímo. AI agent pak vše analyzuje a vytěží tři typy konfigurace – hlasy značky, položky glosáře a pravidla – a postupně je aplikuje na engine podle toho, jak je rozpozná. Zdroj, který se nepodaří procrawlovat, ani jednotlivá položka, kterou nelze vytvořit, nezastaví zbytek. Co AI extrahuje popisuje tyto 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í není skrytá. Provisioning nevrací proprietární blob – vytváří běžné záznamy pro hlas značky, glosář a pravidla na skutečném enginu, tedy přesně stejné objekty, jaké byste vytvořili ručně, a každý z nich lze následně upravit v dashboardu. Po dokončení úlohy vrátí souhrn, který uvádí každý vytvořený záznam i každé selhání, na které narazil, takže si konfiguraci můžete ověřit, místo abyste ji jen předpokládali. Co AI extrahuje vysvětluje tento souhrn i to, jak se neúspěšná 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.
