Odeslali jste své zdroje a úloha právě běží. ID engine dorazilo v 202 a jeho konfigurace se průběžně doplňuje. Tato stránka odpovídá na otázku, která rozhoduje o tom, jestli výsledku budete věřit: co přesně se vlastně doplňuje?
„AI nakonfigurovala můj engine“ je přesně ta věta, která v inženýrovi probudí ostražitost — a je to správně. Může znamenat černou skříňku, do které nevidíte. Může znamenat záznamy rozeseté napříč jazyky, ve kterých se nedá vyznat. Může znamenat i to, že agent prošel slabý zdroj, nic moc v něm nenašel a potichu vytvořil skoro nic. Proto je tahle stránka konkrétní ve všech třech bodech: agent vytváří tři typy konfigurace, každý se mapuje na vaše jazyky podle předvídatelného pravidla a úloha vrací souhrn, který vypíše každý vytvořený záznam. Výstup tvoří běžné záznamy, které si můžete přečíst a upravit — ne verdikt, který musíte přijmout bez ověření.
S asynchronním provisioningem začínáte? Začněte na stránce Přehled Async Provisioning API, kde získáte základní mentální model, a pak pokračujte na Typy zdrojů, kde se dozvíte, co dělá zdroj vhodným k odeslání. Tato stránka se soustředí na to, co z procesu vyjde na druhé straně.
Na této stránce
Tři komponenty#
Agent čte vše — procházené stránky i surový obsah — a vytváří tři typy konfigurace engine. Nejde o nový formát určený jen pro provisioning. Jsou to přesně ty samé základní prvky, které byste jinak ručně vytvářeli v engine. Právě proto lze vše, co agent vytvoří, následně upravovat v dashboardu stejným způsobem, jako cokoli, co jste si vytvořili sami.
| Komponenta | Co hledá | Příklad |
|---|---|---|
| Hlasy značky | Tón, styl, míra formálnosti, konvence psaní | „Používejte formální němčinu (vykání Sie). Věty držte stručné a přímočaré.“ |
| Položky glosáře | Názvy produktů, technické termíny, překlady specifické pro značku, nepřekládané termíny | „Acme“ → nepřekládat, „workspace“ → „Arbeitsbereich“ (de) |
| Instrukce | Pravidla formátování, kulturní zvyklosti, oborově specifické zásady | „V německých překladech vždy používejte formát data DD.MM.YYYY.“ |
To jsou tři věci, díky kterým překlad zní jako váš produkt a ne jako generický převod textu — zvolená míra formálnosti, názvy, které nikdy nepřekládáte, nebo formát data, který používáte vždy. Úkolem agenta je tato rozhodnutí najít všude tam, kde jsou ve vašich zdrojích výslovně uvedena, a zapsat je jako záznamy.
Jeden důsledek stojí za to říct naprosto jasně, protože určuje horní hranici toho, co byste měli očekávat: agent extrahuje to, co je výslovně řečeno, ne to, co je jen naznačeno. Zdroj, který pravidlo jasně pojmenuje, povede k vytvoření záznamu; zdroj, který jen ukazuje dobrý tón bez pojmenování pravidla, přinese málo. Je to vlastnost zdrojů, ne engine — stránka Typy zdrojů vysvětluje, jak vybírat zdroje, které svá pravidla říkají nahlas.
Jak se každá mapuje na jazyk#
Konfigurace lokalizační engine je navázaná na cílový jazyk, takže záznam neurčuje jen jaké pravidlo platí, ale i kde platí. Agent přiřazuje každému záznamu jazyk podle pravidla, které lze předvídat, a zástupný znak * je část, které stojí za to porozumět ještě předtím, než začnete číst výstup.
- Hlasy značky a instrukce používají
*, když platí napříč všemi jazyky. Pravidlo tónu jako „věty držte stručné a přímočaré“ není specifické pro němčinu; popisuje, jak váš produkt píše v každém jazyce. Agent mu přiřadí cílový jazyk*a pravidlo se pak použije na každý jazyk, do kterého engine překládá. Pravidlo, které je skutečně jazykově specifické („v němčině používejte vykání Sie“), se místo toho přiřadí tomuto jazyku. - Položky glosáře se vytvářejí pro každý jazykový pár, protože překlad vždy probíhá z jednoho jazyka do jiného konkrétního jazyka — „workspace“ → „Arbeitsbereich“ je fakt o němčině, a jen o ní.
- Nepřekládané termíny jsou výjimka a používají
*. Název značky, který nikdy nepřekládáte — „Acme“ — je nepřekládaný v každém jazyce, takže se uloží jednou pod*, místo aby se znovu zadával pro každý jazykový pár.
Když tedy v záznamu vytvořeném úlohou vidíte *, není to placeholder ani mezera. Znamená to „tohle platí všude“ — globální pravidlo tónu, globální instrukci nebo termín, který se nikdy nepřekládá v žádném jazyce. Konkrétní kód jazyka znamená opak: toto pravidlo je omezené přesně na daný jazyk.
Proč je zástupný znak funkce, ne výchozí hodnota k přepsání
Skeptický výklad * zní: „agent se ani neobtěžoval zjistit, ke kterému jazyku to patří.“ Ve skutečnosti je to přesně naopak. Hlas značky nebo nepřekládaný termín, který platí správně ve všech jazycích, má být globální — připnout ho k jednomu jazyku by znamenalo, že se na ostatní tiše nepoužije. Zástupný znak je způsob, jak konfigurace říká „tohle platí bez ohledu na jazyk“, což je přesně to, čím pravidlo tónu nebo název značky obvykle je.
Souhrn výstupu#
Když se úloha dokončí, vrátí souhrn, který vypíše vše, co agent vytvořil. To je vaše stvrzenka: každý záznam, spočítaný a identifikovaný, plus seznam všeho, co selhalo.
{
"brandVoices": {
"count": 3,
"ids": ["bv_A1b2C3d4", "bv_B2c3D4e5", "bv_C3d4E5f6"]
},
"glossaryItems": {
"count": 12,
"ids": ["gi_A1b2C3d4", "gi_B2c3D4e5", "..."]
},
"instructions": {
"count": 5,
"ids": ["ins_A1b2C3d4", "ins_B2c3D4e5", "..."]
},
"errors": []
}Každá komponenta uvádí count a ids vytvořených záznamů — bv_ pro hlasy značky, gi_ pro položky glosáře a ins_ pro instrukce. To nejsou neprůhledná potvrzení; jsou to ID skutečných záznamů v engine. Můžete vzít libovolné gi_ z tohoto seznamu, otevřít ho v dashboardu a přesně si přečíst nebo změnit to, co agent extrahoval. Souhrn vás posune od „AI něco udělala“ k „tady je dvacet konkrétních věcí, které udělala“ — a právě v tom je rozdíl mezi černou skříňkou a běžnými záznamy, které si můžete přečíst a upravit.
Souhrn k vám dorazí kanálem, který jste nastavili při vytváření úlohy: v payloadu webhooku, který vaše callback URL obdrží po dokončení, kde přijde jako pole summary. Pokud úlohu sledujete přes WebSocket, jde o kanál průběžného stavu — streamuje průběh crawlování a konfigurace, nikoli tento objekt souhrnu. Souhrn se posílá s dokončovacím webhookem; WebSocket vám říká, kdy si ho máte jít přečíst.
Jedna neúspěšná položka neznamená selhání celé úlohy.
Pokud nelze vytvořit jeden záznam, nepotopí to zbytek. Selhání se zaznamená do pole errors, záznamy, které uspěly, se na engine přesto použijí a úloha se i tak dokončí. Dostanete částečně nakonfigurovaný engine plus přesný seznam toho, k čemu se vrátit — ne prázdný engine a stack trace. Úloha jako celek selže ve chvíli, kdy běh nevyprodukuje nic, s čím by se dalo pracovat — například když se nepodaří crawlovat žádný zdroj; tento případ selhání a jeho payload provisioning.failed je popsaný na stránce Doručování webhooků.
Jak číst stručný souhrn#
Souhrn vám neříká jen to, co bylo vytvořeno, ale podle počtů i to, jestli běh stál za to. Hodnota count rovná 0 u některé komponenty není chyba — souhrn je správně vytvořený a engine existuje — ale je to důležitá informace. Tři hlasy značky a dvanáct položek glosáře znamenají nakonfigurovaný engine. Nuly všude a prázdné pole errors znamenají engine, který se vrátil téměř prázdný, a agent vám tím říká, že našel jen málo pravidel k extrakci.
Když se to stane, příčina je téměř vždy na vstupu: zdroje obsahovaly málo konkrétních pravidel, která mohl agent převzít. Souhrn je místo, kde si toho všimnete; stránka Typy zdrojů je místo, kde to opravíte. Do prvního běhu je fér jít s tím, že stvrzenka odráží jen to, co vaše zdroje skutečně říkaly — bohatý souhrn znamená bohaté zdroje a stručný znamená, že toho bylo málo k nalezení.
Právě proto je souhrn stejně důležitý jako engine: umožňuje vám konfiguraci ověřit místo toho, abyste ji jen předpokládali. Projděte počty, otevřete několik záznamů podle jejich ID, potvrďte si, že agent zachytil to, co jste očekávali — běžné záznamy, které si můžete přečíst a upravit, se stvrzenkou, která vám přesně říká, co zkontrolovat.
