Automatizace a agenti
killBottleneck automatizuje na dvou úrovních: šablony samy zakládají opakující se projekty a AI agenti vykonávají jednotlivé kroky mapy — n8n workflow, cron, cokoli, co odpovídá na webhook.
Vnitřní automatizace bez agentů
„Když X → udělej Y" přímo v mapě řeší automatizační pravidla — včetně zastupování a dynamických cílů.
Opakované šablony
Každou mapu jde uložit jako šablonu — osobní, nebo pro celou organizaci, volitelně i s úkoly. Termíny se ukládají jako „dny od startu“ a při použití šablony se dopočítají.
Šablona umí projekty i zakládat automaticky: každý týden ve zvolený den, nebo N-tý (případně poslední) den v měsíci, ráno. Hodina a časová zóna se nastavují (KB_AUTO_HOUR, TZ — viz Konfigurace); když byl server v tu hodinu vypnutý, projekt vznikne později týž den — nevynechá se.
Číslované řady: šablona může projekty, které z ní vznikají, číslovat — „Mzdy 2026-1“, „Mzdy 2026-2“… Nový rok začne novou řadu od 1 a číslo dostane i projekt s vlastním názvem. Archiv drží řadu pohromadě, seřazenou podle čísla.
Kdo krok vykoná
U každého cíle se eviduje, jestli ho vykoná člověk, nebo automatizace. Zodpovědná osoba je vždycky člověk — i u automatizovaného kroku někdo ručí, dostává notifikace a vidí cíl ve svém Mém dni. U kteréhokoli cíle jde navíc zaškrtnout „Chtěl bych tu automatizaci“: přání dostanou správci AI (příznak u uživatele, nezávislý na roli), a jakmile automatizaci postaví a zapíšou ke cíli, přání se samo uklidí a přijde vám notifikace.
Registr AI agentů
Správce AI (nebo administrátor) vede adresář automatizací: název, adresa webhooku, tajný klíč pro podpis, zapnuto/vypnuto a volitelně kdo ji smí spustit (seznam e-mailů; prázdný = kdokoli, kdo může upravovat mapu). V cíli se automatizace vybírá jménem — členové týmu adresu ani klíč nikdy nevidí.
Kdy se automatizace spustí
Automatizovaný cíl se nespustí sám od založení — čeká na jeden z těchto podnětů:
- Přepnete cíl na Probíhá. Ruční „teď se to dělá“ — spustí automatizaci hned. Toutéž cestou se opakuje selhaný běh (přepnout zpět na Probíhá).
- Cíl „přijde na řadu“ — dokončí se všechny jeho podcíle. Tohle závislostní chování musíte u cíle zapnout přepínačem „čeká na podstrom“; bez něj cíl na dokončení podcílů nečeká.
- Nahrajete ke cíli přílohu — soubor rovnou spustí zpracování.
Stav běhu je vidět přímo v dialogu cíle, doslova: Automatizace se spouští… / běží… / doběhla / selhala (u selhání i důvod) — a „Znovu ji spustíte přepnutím cíle na Probíhá." Když agent ohlásí hotovo, cíl se splní a odblokuje se další krok — automatizované kroky se tak řetězí samy. Běh, který se neozve, hlídač po limitu (KB_AGENT_TIMEOUT_MIN, výchozí 90 minut) označí za selhaný a dá vědět zodpovědné osobě i správcům AI.
Napsané jméno musí sedět na agenta v registru
Když u cíle uvedete automatizaci jménem, které žádnému zaregistrovanému a zapnutému agentovi neodpovídá (třeba jméno agenta, kterého teprve chcete vytvořit, nebo externí proces mimo killBottleneck), krok se jednoduše nespustí — bere se jako poznámka „tohle dělá stroj“, ne jako pokyn. Žádná hláška o selhání nepřijde. Chcete-li si automatizaci jen předznačit na později, použijte u cíle přepínač „Chtěl bych tu automatizaci“ — dá vědět správcům AI, ať ji postaví.
Dvě proměnné, o kterých je dobré vědět
KB_PUBLIC_URL říká agentovi, kam se má ohlásit zpět — bez ní vzdálený agent volá sám sebe. A agenti v privátní síti (typicky self-hostované n8n) potřebují KB_ALLOW_PRIVATE_WEBHOOKS=1. Podrobnosti v Proměnných prostředí → Automatizace.
killBottleneck řízený zvenčí: API klíče a MCP
Opačný směr — váš kód nebo AI asistent pracující s mapami — vede přes API klíče (uživatelské menu → API klíče). Klíč má oprávnění (Jen čtení, nebo Čtení i zápis), volitelnou platnost a token se ukáže přesně jednou. Otevírá dvoje dveře:
- REST API pro skripty a integrace,
- vestavěný MCP server pro AI asistenty typu Claude — „udělej mapu z tohohle zápisu z porady“, hromadné úpravy, odškrtávání hotového.
Klíč dosáhne na mapy a úkoly svého majitele, nikdy na administraci, nastavení AI ani uživatele; celou mapu přes API smazat nejde a vrchol taky ne.
Dál
- MCP server — připojení AI asistenta krok za krokem
- Proměnné prostředí — konfigurace kolem automatizací