Provisioning čte vaše stávající materiály a převádí je do konfigurace engine. Jediné rozhodnutí, které zásadně ovlivní výsledek, je to, co vložíte do pole sources v requestu – protože engine, který dostanete zpět, je jen tak dobrý jako to, na co ho namíříte.
Každá položka patří do jedné ze dvou kategorií. Zdroj link je URL, kterou za vás platforma načte a projde crawlerem, zatímco zdroj content je surový text nebo markdown, který pošlete přímo. V jednom requestu můžete kombinovat oba typy, celkem až deset zdrojů. Tato stránka vysvětluje oba typy, co s každým z nich platforma dělá a jak vybírat zdroje, které povedou k užitečné konfiguraci místo prázdné. Samotné pole sources patří do create requestu – celý payload i odpověď 202 najdete v Vytvoření provisioning jobu.
Dva typy zdrojů#
Každý zdroj je objekt s type a payload. Hodnota type určuje, jak platforma čte payload.
| Typ | Payload | Sáhněte po něm, když |
|---|---|---|
link | URL pro crawlování | Kontext už je na webu – vaše brandová stránka, veřejná dokumentace, publikovaný stylistický manuál nebo stránka se slovníkem. |
content | Surový text nebo markdown | Kontext máte v hlavě nebo v neveřejném dokumentu – seznamy terminologie, pravidla tónu, konvence pro názvy produktů nebo překladová doporučení a zákazy. |
{
"sources": [
{ "type": "link", "payload": "https://acme.com/brand-guidelines" },
{ "type": "link", "payload": "https://acme.com/docs/style-guide" },
{
"type": "content",
"payload": "Brand name 'Acme' is never translated. Use formal tone in German (Sie-form). Product names: AcmeFlow, AcmeSync, AcmeVault - always keep in English."
}
]
}Dva odkazy a jeden blok obsahu ve stejném poli. Odkazy míří na stránky, které už potřebný kontext obsahují, zatímco blok obsahu nese pravidla, která nikde veřejně nejsou. Obojí vstupuje do stejného kroku extrakce.
Co platforma dělá s každým z nich#
Tyto dva typy se liší v jediném kroku – v tom, jak dostat text před AI agenta – a potom se jejich cesta znovu spojí.
Zdroj link se před analýzou načte a převede do markdownu. Platforma crawluje odkazové zdroje paralelně, takže deset URL neznamená deset postupných cest tam a zpět – čtou se souběžně a pak se agentovi předají jako text. Vy dodáte URL, platforma se postará o načtení i převod z HTML do markdownu, aby agent četl souvislý text, ne značky stránky.
Zdroj content tento krok přeskočí. Text, který pošlete, se předá AI agentovi přímo, přesně tak, jak je napsaný. Žádné crawlování, žádný převod, nic mezi vašimi slovy a agentem – proto je obsahový zdroj nejpřesnější způsob, jak formulovat pravidlo, které už znáte.
Od té chvíle jsou oba typy stejným vstupem: agent vše přečte a extrahuje hlas značky, položky slovníku a instrukce. Co z tohoto textu vytvoří a jaké vrátí shrnutí, je samostatné téma – viz Co AI extrahuje.
Jak hluboko sahá crawlování odkazu?
Zdroj link se před analýzou agentem načte a převede do markdownu. Zda crawler sleduje odkazy i za URL, kterou dodáte – a do jaké hloubky – tady specifikováno není. Pokud potřebujete analyzovat konkrétní sadu stránek, spolehlivější je uvést každou z nich jako samostatný zdroj link, místo abyste spoléhali na to, že se jedna URL rozvětví dál.
Vybírejte zdroje, které nesou signál#
Právě tohle rozhoduje o tom, jestli má provisioning vůbec smysl spouštět. Kvalita extrakce je jen tak dobrá jako její vstup – a selhání je tu tiché: job se i se slabými zdroji dokončí, pořád vytvoří engine, ale téměř prázdný, a vy to zjistíte až později, když překlady ignorují konvence, o nichž jste předpokládali, že se zachytí. Dokončení dorazí stejně jako každé jiné – viz Doručení webhooku – takže vás na chybějící kontext nic neupozorní.
Dodávejte smysluplné zdroje
Kvalita extrahované konfigurace závisí na kvalitě vstupu. Odkazové zdroje by měly mířit na stránky s užitečným kontextem – brandové pokyny, stylistické manuály, produktovou dokumentaci nebo slovníky. Zdroje se surovým obsahem by měly obsahovat konkrétní terminologii, doporučení k tónu nebo překladová pravidla. Obecné marketingové stránky nebo přihlašovací obrazovky přinesou jen minimum užitečné konfigurace.
Princip za tímto calloutem je jednoduchý: agent extrahuje to, co je výslovně řečeno, ne to, co je jen naznačeno. Stránka, která říká „píšeme přátelskou, přímou němčinou, používáme Sie, nikdy Du“, vytvoří hlas značky. Stránka se slovníkem, která uvádí „workspace → Arbeitsbereich“, vytvoří položku slovníku. Vyladěná landing page, která ukazuje dobrý tón, ale nepojmenuje jediné pravidlo, nepřinese téměř nic, protože na ní není žádné pravidlo, které by šlo převzít. Pokud si nejste jistí, dejte přednost zdroji, který pravidlo říká nahlas – a tím je často blok content, který sami napíšete jako větu, spíš než stránka, u níž doufáte, že z ní agent něco vyvodí.
Jeden slabý zdroj celý job nepotopí#
Když posíláte několik zdrojů najednou, přirozeně se nabízí otázka: pokud jedna URL nefunguje nebo je jeden blok příliš slabý, spadne celý request? Nespadne. Zdroje se čtou nezávisle a selhání jednotlivé položky se zaznamená, ale není fatální – nefunkční odkaz nebo nečitelný blok se přeskočí a agent pracuje s tím, co se podařilo načíst. Job jako celek selže jen tehdy, když se nepodaří přečíst vůbec žádný zdroj, takže nezbude nic k analýze. Přesná podoba těchto výsledků – jednotlivá selhání zaznamenaná při úspěchu a failure payload v případě, že nešlo přečíst nic – patří do Co AI extrahuje a Doručení webhooku.
Můžete tedy uvést sadu kandidátů, aniž byste předem kontrolovali každou URL: silné zdroje přispějí, slabé odpadnou a ve shrnutí výstupu uvidíte, co se skutečně použilo. Namiřte to na to, co už máte – a pak zkontrolujte, co se vrátilo.
