Dokumentace

AI agenti (MCP)

Playbook skills

22 playbooků, které MCP server AmICited dodává jako zdroje skills: které nástroje volat, v jakém pořadí a pasti, kvůli kterým je sebevědomá odpověď špatná.

Nástroje jsou to, k čemu se agent dostane. Skills jsou to, jak je použít pro skutečnou otázku. S více než 300 nástroji je těžké málokdy najít jeden: těžké je vědět, že “proč klesl provoz” potřebuje šest reportů v určitém pořadí, nebo že prázdný report e-shopu může znamenat “nepřipojeno” spíše než “nulové tržby”.

MCP server AmICited dodává tyto playbooky jako zdroje MCP. Každý z nich vznikl tak, že se agentům kladly těžké otázky proti živému serveru bez playbooku, zaznamenávaly se všechny slepé uličky a chybné předpoklady a tato selhání se proměnila v pokyny. Každé jméno nástroje, které skill zmiňuje, se při každém sestavení ověřuje proti živému registru nástrojů, takže skill nikdy neodkazuje na nástroj, který už neexistuje.

Jak je agenti najdou#

Skills se poskytují na skill://<name>/SKILL.md. Jejich výpis stojí jméno a jeden řádek na skill; tělo se načte, jen když ho agent chce.

  • Pokyny serveru, zasílané každému klientovi při připojení, říkají agentovi, aby jako první přečetl skill://using-amicited/SKILL.md. Tento skill vysvětluje smyčku najít, prozkoumat, spustit a uvádí ostatní.
  • Mnoho klientů zdroje samo nikdy nevypisuje. Pokud se zdá, že váš agent o skillu neví, pojmenujte jej: “Read skill://ai-visibility-audit/SKILL.md, then audit example.com.”
  • Skills jsou text jen pro čtení. Přečtení jednoho se nepočítá do hodinového limitu volání nástrojů.

Konvence#

SkillÚčel
using-amicitedJak ovládat endpoint: hledání správného nástroje mezi 300+, jeho vyvolání a konvence, které předpokládá každý další skill. Čtěte jako první.
report-windowsČasová okna a srovnávací období napříč reporty: různé styly argumentů, pravidlo stejné délky a jak se vyhnout sebevědomě špatným číslům.

AI viditelnost a konkurenti#

SkillÚčel
ai-visibility-auditDiagnostikujte, proč je značka nebo není citována v AI odpovědích: které enginy skutečně běžely, co hlavní číslo skrývá a čtyři kontroly, které mezeru vysvětlí.
competitor-gap-analysisNajděte, kde konkurenti vyhrávají AI odpovědi a vyhledávání, které vy ne, a které mezery řešit jako první.
competitor-content-gapsNajděte sekce sitemap konkurentů, slovník a mezery v publikování, aniž byste nadhodnotili neúplná data o aktuálnosti.
ai-fanout-queriesNajděte vyhledávání, která AI asistent provedl proti vašemu webu (ta s operátorem site:), a čtěte je, aniž byste nulovou prokliknutost mylně považovali za problém.
prompt-set-designPřidávejte sledované prompty pro doménu: jak vypadá dobrá sada promptů, past při tagování a proč zde nic nemůže říct, kolik stojí kredity.

Diagnostika organického vyhledávání#

SkillÚčel
traffic-drop-triageZjistěte, proč se organický provoz pohnul: lokalizujte to na dotaz nebo stránku, datujte skok a vylučte indexaci, výpadky a změny webu dříve, než obviníte umístění.
did-our-change-workKorelujte změnu webu s tím, co se stalo poté, a proč prázdná historie anotací není důkazem ničeho.
indexing-triageVyšetřujte problémy s indexací: který nástroj odpovídá na kterou polovinu, proč nulový verdikt není ne a vzorec 404 bez přesměrování.
cannibalization-cleanupNajděte stránky soutěžící o stejný dotaz a proč je vrchol žebříčku závažnosti obvykle šum značky.
page-familiesČtěte stránku a její překlady jako jednu rodinu a spojte změnu provozu s úpravou hreflang nebo canonical.
site-audit-reviewOceňte, spusťte a interpretujte site audity sitemap, abyste opravili technické problémy a zlepšili hodnotu interních odkazů.
backlinks-reviewPosuďte, zda sledované zpětné odkazy stále nesou hodnotu: co “active” skrývá, ztracené vs. nedostupné a srovnání autority s konkurenty.

Peníze#

SkillÚčel
profitability-deep-diveVykazujte zisk e-shopu poctivě: než uvedete jakoukoli marži, zkontrolujte pokrytí nákladů, protože nenastavený náklad se čte jako nula.
customer-valueLifetime value, kohorty a opakované nákupy a proč musí být okno dlouhé.
paid-waste-reviewNajděte promarněné výdaje na reklamu, aniž byste vymýšleli zisk, včetně případů, kdy hodnota konverze ve skutečnosti nejsou peníze.
seo-to-revenueZdůvodněte organickou práci v penězích místo v klicích, poté co zkontrolujete, že existují data kanálů, ke kterým se tržby přiřazují.

Provoz a výstupy#

SkillÚčel
platform-onboardingPřipojte datovou platformu k doméně a importujte její historii: řetězec nabídka a potvrzení a kde se zavazují peníze.
uptime-setupNastavte monitory, upozornění, heartbeaty, servisní okna a stavovou stránku bez napůl nakonfigurovaných výchozích hodnot.
availability-reviewOdpovězte na “byl web dostupný, co se pokazilo a je něco teď dole”, včetně pravidel kalendářního měsíce v SLA reportu.
recurring-reportsVytvořte týdenní report SEO nebo měsíční report e-shopu, který je srovnatelný s tím minulým: pevná okna, pevné nástroje, upozornění přenášená dál.

Co skill v praxi mění#

Dva příklady toho, co playbooky zachytí a schémata nástrojů ne:

  • Rozpad podle providera skrývá mlčící enginy. Rozpad podle platforem na dashboardu uvádí jen enginy, které vás citovaly. ai-visibility-audit posílá agenta do get_prompt_detail, který u každého enginu ukazuje, zda běžel a zda vás citoval, takže “24% viditelnost” se změní na “citován Perplexity, ignorován ChatGPT”. Viz chybějící data z enginu.
  • Nepřipojeno není nula. using-amicited nutí agenta zkontrolovat, zda je platforma připojena, než nahlásí, že nemá data, a odkázat vás na Data Sources, když není.

Když znáte otázku, pojmenujte skill ve svém požadavku: “Use the traffic-drop-triage skill to explain last week’s drop on example.com.” Agent si nejdřív přečte playbook a řídí se jeho pořadím. Stránka recepty má hotové prompty.

Související#