AI kódovací agenti se stali běžnou součástí tvorby projektů v platformě Xperience by Kentico. Zadáte-li jednomu z nich úkol „přidejte widget, který zobrazí související články“, ochotně propojí komponentu zobrazení, použije IContentRetriever a vytvoří Razor view. Většinou to funguje. Občas však agent narazí na neznámé API a začne platformu dekompilovat jen proto, aby našel typ nebo signaturu metody.
Vývojář takové hledání obvykle provede pomocí IntelliSense. Agent potřebuje stejně přímý způsob, jak zjistit dostupné typy, parametry a přetížení. Oficiální reference API společnosti Kentico mu ho poskytuje.
Proč je XbyK pro kódovacího agenta náročným cílem
Xperience by Kentico je uzavřený software. Na rozdíl od open source knihovny, jejíž implementaci může agent jednoduše přečíst, se XbyK dodává jako kompilované balíčky NuGet. Skutečný kontrakt typu – jeho konstruktory, přetížení, nulovatelnost a to, které členy jsou skutečně určeny spotřebitelům oproti internímu propojení – existuje pouze v metadatech a v dokumentaci, kterou k němu Kentico zveřejňuje. U komerčních platforem to není neobvyklé, mění to však vyhlídky agenta zvyklého opírat se jako o hlavní zdroj pravdy o zdrojový kód.
Xperience by Kentico také pokrývá širokou škálu funkcí: typy obsahu, položky webových stránek, opakovaně použitelná schémata, widgety Page Builderu a rozhraní pro správu a dotazování obsahu jsou rozloženy v různých jmenných prostorech. S vývojem platformy mohou trénovací data modelu zastarat právě v oblastech, na kterých záleží u funkčního kódu nejvíce: dostupná rozhraní, názvy metod a přetížení.
Dokumentační MCP pomáhá, ale odpovídá na jinou otázku
Kentico již dodává dokumentační server MCP jako součást širšího úsilí KentiCopilot . Zpřístupňuje nástroje, které vyhledávají a načítají aktuální dokumentaci ve formátu Markdown. Obvykle jde o správný první krok pro agenta, který potřebuje porozumět určitému konceptu: jak fungují oprávnění k položkám obsahu, k čemu slouží opakovaně použitelné schéma polí nebo jaký je doporučený postup při vytváření sekce Page Builderu.
Mezera se projeví, jakmile agent přejde od otázky „jaký je správný přístup“ k otázce „co přesně mám zavolat.“ Koncepční dokumentace popisuje vzory a osvědčené postupy slovně a uvádí několik názorných ukázek kódu, nikdy však neměla za cíl vyjmenovat každé přetížení konstruktoru, každý volitelný parametr nebo přesný návratový typ konkrétní metody. Agent, který se pokouší správně zavolat IContentQueryResultMapper.Map, potřebuje skutečnou signaturu, nikoli odstavec o výsledcích dotazů na obsah obecně. To je přesně ten typ otázky, na který koncepční dokumentace, byť sebelépe napsaná, není určena.
Když se hledání změní ve zbytečnou dekompilaci
Tváří v tvář této mezeře může agent najít příslušnou knihovnu DLL v mezipaměti balíčků NuGet a prozkoumat její dekompilovaný kód. Dekompilace může být užitečná při zkoumání chování implementace nebo diagnostice problému v přesné verzi balíčku, kterou projekt používá.
Pro jednoduché hledání typu nebo metody jsou však podrobnosti implementace obvykle zbytečné. Agent potřebuje stejné informace, jaké vývojář získá z IntelliSense: deklaraci, dostupná přetížení, typy parametrů a návratovou hodnotu. Reference API tyto informace uvádí přímo spolu s popisy a poznámkami k použití.
Lepší zdroj pravdy: api-reference.kentico.com
Kentico zveřejňuje api-reference.kentico.com, generovanou referenci API uspořádanou podle jmenného prostoru a typu. Stránky jmenných prostorů uvádějí typy, které obsahují. Stránky typů zobrazují deklarace, dědičnost, implementovaná rozhraní a příslušné konstruktory, metody a vlastnosti; názvy a typy parametrů jsou uvedeny explicitně.
Předvídatelné adresy URL umožňují agentovi načíst seznam jmenného prostoru nebo přejít přímo na konkrétní typ:
https://api-reference.kentico.com/api/{Namespace}.html https://api-reference.kentico.com/api/{Namespace}.{TypeName}.html
Reference také poskytuje poznámky, které pomáhají určit zamýšlené použití a omezení. Veřejná deklarace sama o sobě neznamená, že je API podporováno pro vlastní kód: například zdokumentovaná třída DefaultDataSettings je výslovně označena jako určená pouze pro interní použití. Čtení těchto poznámek je součástí hledání.
Existuje jedno důležité omezení: reference API nezobrazuje informace o verzích. Agent nemůže pouze ze stránky zjistit, zda její signatury odpovídají balíčkům NuGet nainstalovaným v konkrétním projektu. Reference je přímým zdrojem pro zjišťování API, výsledný kód však stále musí být zkontrolován oproti balíčkům nainstalovaným v projektu a ověřen sestavením.
Dalším krokem bylo zpřístupnit tento proces hledání agentům jako opakovaně použitelnou dovednost.
Převod pozorování na dovednost agenta
Dovednosti agentů balí instrukce specifické pro danou úlohu do souboru SKILL.md, s volitelnými skripty a podpůrnými prostředky. Podporuje je několik agentních nástrojů, včetně GitHub Copilot, Claude Code a Codexu. Tato dovednost poskytuje instrukce k používání funkcí, které agent již má, například k načtení webové stránky.
Dovednost xbyk-api-lookup je určena pro úlohy vyžadující typ, signaturu metody, rozhraní nebo jmenný prostor XbyK. Agenta nasměruje přímo do oficiální dokumentace API. Koncepční průvodce a postupy konfigurace zůstávají mimo její rozsah.
Instrukce používají výše uvedené dva vzory URL k vyhledání typů ve jmenném prostoru nebo k prozkoumání konkrétního typu. Určují, co extrahovat: deklaraci a jmenný prostor, základní třídu a implementovaná rozhraní, veřejné konstruktory, signatury metod a návratové typy, vlastnosti a relevantní poznámky či výjimky.
Dovednost také zahrnuje vyhledávání servisních rozhraní a metod rozšíření prostřednictvím seznamů jmenných prostorů. Její kontrolní seznam agenta vyzývá k ověření existence typu, názvů a typů parametrů, anotací nullable a povinných parametrů před napsáním kódu.
Pokud prostředí podporuje agenty na pozadí, dovednost jednoho z nich požádá o načtení stránky a vrácení určených podrobností o API hlavnímu agentovi. Tím se hlavní konverzace soustředí na výsledek vyhledávání.
Balení a sdílení dovednosti
Aby bylo dovednost snadné sdílet napříč projekty, je zabalena jako zásuvný modul xperience-by-kentico ve veřejném tržišti dovedností agentů Bluesoft na GitHubu.
Tržiště poskytuje pokyny k instalaci pro GitHub Copilot CLI, VS Code, Claude Code a Codex. Nastavení se u jednotlivých nástrojů liší, proto postupujte podle pokynů pro svého agenta. Po instalaci a aktivaci je dovednost k dispozici pro relevantní úlohy vyhledávání v API.
Dovednost doplňuje stávající nástroje KentiCopilot. Server Documentation MCP podporuje koncepční dotazy, zatímco servery Content Modeling MCP a Management MCP podporují návrh obsahových modelů a práci s objekty projektu. Dovednost vyhledávání v API poskytuje cílenou cestu k zdokumentované podobě typu nebo metody.
Co se v praxi mění
S nainstalovanou dovedností se stejný požadavek „přidej widget, který vypíše související články“ odehrává jinak. Agent načte stránku relevantního typu, ověří signatury metod a poznámky k použití a napíše kód podle zdokumentovaného API.
Předpokládejme, že widget potřebuje stránky s články z konkrétní sekce webu. Vědět, že IContentRetriever načítá obsah, je jen začátek: agent také potřebuje správnou metodu rozšíření a třídu parametrů přijímanou jejím přetížením. Dokumentace RetrievePagesExtensions ukazuje, že RetrievePages<Article> přijímá objekt RetrievePagesParameters. Prostudování referenční stránky tohoto typu odhalí dostupné možnosti, včetně ChannelName, PathMatch a LinkedItemsMaxLevel.
Vyhledávání propojí metodu rozšíření s její konkrétní třídou parametrů a následně s typy a členy potřebnými ke konfiguraci. Zabrání agentovi předat podobně pojmenovaný RetrieveContentParameters nebo přiřadit řetězec k PathMatch. Tyto podrobnosti jsou přímo dostupné v dokumentaci, bez nutnosti rekonstruovat je z dekompilovaného implementačního kódu.
Rozdíl se projeví menším počtem chyb kompilace při prvním pokusu a nižším rizikem, že agent zavolá nepodporovaný člen. Kontrola poznámek v dokumentaci a sestavení kódu proti balíčkům nainstalovaným v projektu zůstávají součástí ověření výsledku.
Shrnutí
Zlepšení spočívá v jasném pracovním postupu vyhledávání pro agenta: najít typ, pročíst jeho signatury a poznámky a ověřit kód v projektu. Pro každodenní otázky, na které vývojáři odpovídají pomocí IntelliSense, poskytuje reference API Kentico agentům přehledné místo k hledání. Dovednost z tohoto zdroje činí stálou součást jejich pracovního postupu.
Bluesoft je vývojová společnost specializující se na webová řešení na míru, e-commerce platformy a digitální aplikace. Již více než 17 let jsme partnerem Kentico Gold a patříme mezi nejzkušenější implementační týmy v regionu.
Projekty realizujeme také na platformách Kontent.ai a Umbraco a podporujeme středně velké i velké společnosti, jako jsou Škoda Auto, Sazka a E.ON. Naše řešení pravidelně získávají ocenění Kentico Site of the Year, což potvrzuje kvalitu a dlouhodobou spolehlivost naší práce.
Jako součást skupiny BiQ Group sdružujeme více než 590 specialistů a úspěšně jsme dodali více než 2 100 projektů.
👉 Kontaktujte nás prostřednictvím našeho kontaktního formuláře a náš tým se vám ozve.
