Automatizace a agenti
AI agent v killBottlenecku je cokoli, co odpovídá na webhook — n8n workflow, cron, vlastní skript — a umí vykonat krok mapy. Tahle stránka je o tom, jak takový krok označit, kdo agenty eviduje a kdy se spouštějí.
Co řeší jiné stránky
„Když X → udělej Y“ přímo v mapě jsou automatizační pravidla (včetně zastupování). Projekty, které se samy zakládají ze šablony, popisují Šablony. Připojení AI asistenta (Claude, Cursor) zvenčí je v Účtu a nastavení a v MCP.
Kde to najdu
- V okně cíle kategorie Automatizace: Kdo to vykoná, Jaká automatizace to dělá, Chtěl bych tu automatizaci, Čekat na podřízené, pravidla uzlu.
- Menu pod panáčkem → Registr AI agentů (správce AI a administrátor).
- V pravidlech akce spusť agenta.
Kdo krok vykoná
U každého cíle se eviduje Kdo to vykoná: Člověk, nebo Automatizace. Řešitel zůstává člověk — i u automatizace je to on, komu chodí notifikace a kdo cíl vidí ve svém Mém dni. U automatizace vyplníte Jaká automatizace to dělá (Evidence toho, co tu běží. Když název sedí na agenta v registru, killBottleneck ho umí sám spustit.).
U kteréhokoli cíle jde zapnout Chtěl bych tu automatizaci (Dá vědět správci AI agentů. Ten se rozhodne, jestli ji postaví.) s nepovinnou poznámkou proč to dnes zdržuje. Správci AI přijde notifikace Požadavek pro AI agenta; jakmile automatizaci postaví a zapíše ke cíli, přání se samo uklidí a přijde vám Automatizace je hotová. Na kartě má takový cíl odznak chce automatizaci.
Registr AI agentů
Správce AI (nebo administrátor) vede adresář: Název (Tímhle názvem se agent vybírá v uzlu mapy. Musí být jedinečný.), Popis, Adresa webhooku, Tajný klíč pro podpis (killBottleneck jím podepíše tělo požadavku v hlavičce X-Signature (HMAC-SHA256). Zpět se nikdy nezobrazí.), Zapnutý a Kdo ji smí spustit (E-maily oddělte čárkou. Prázdné pole znamená, že automatizaci smí spustit kdokoli, kdo může upravovat mapu.). Bez tajného klíče dialog varuje, že se požadavek podepíše prázdným klíčem.
Dole je blok Kam agent hlásí výsledek s adresou callbacku: Po doběhnutí pošlete POST s run_id, run_token a status (done/failed), volitelně result. Uzel se tím splní a naváže další krok. Když adresa vede na localhost, dialog řekne, že se na ni vzdálená automatizace nedovolá — nastavte KB_PUBLIC_URL.
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 (Znovu ji spustíte přepnutím cíle 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 Čekat na podřízené; bez něj cíl na dokončení podcílů nečeká.
- Nahrajete ke cíli přílohu — okno to říká dopředu: Nahráním souboru se rovnou spustí automatizace „…“.
- Pravidlo s akcí „spusť agenta“ — Běh se zařadí do fronty a odešle do minuty.
Co uvidíte: stav běhu přímo v okně cíle — Automatizace se spouští… / běží… / doběhla / selhala (u selhání i důvod). Když agent ohlásí done, 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; kontrola jednou za hodinu) označí za selhaný (Automatizace selhala) a dá vědět řešiteli 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á, okno to řekne rovnou: Tento agent zatím není v registru — krok se sám nespustí, dokud ho tam nevytvoříte. Chcete-li ho jen předznačit, přepněte „Chtěl bych tu automatizaci“.
Omezení a proměnné
KB_PUBLIC_URLříká agentovi, kam se má ohlásit zpět — bez ní vzdálený agent volá localhost.- Agenti v privátní síti (typicky self-hostované n8n) potřebují na vlastním serveru
KB_ALLOW_PRIVATE_WEBHOOKS=1, případně užšíKB_PRIVATE_WEBHOOK_HOSTS(seznamhost:port). Na hostované instanci privátní adresa nejde vůbec. Viz Proměnné prostředí → Automatizace. - Registr vidí jen správce AI a administrátor; členové vybírají agenta jménem.
- Selhání hlídače se objeví až při hodinové kontrole — tedy 90 až 150 minut po startu běhu.
killBottleneck řízený zvenčí
Opačný směr — váš kód nebo AI asistent pracující s mapami — vede přes API klíče (menu pod panáčkem → API klíče; klíč Jen čtení nebo Čtení i zápis, volitelná platnost, token se ukáže jednou, Rotovat klíč) nebo přes Připojit AI agenta (OAuth, bez klíče). Otevírá to dvoje dveře: REST API pro skripty a integrace a vestavěný MCP server pro asistenty typu Claude. Klíč jedná za svého majitele: dosáhne na mapy, které majitel vidí, zapisuje podle úrovně sdílení; roli nikdy nečte a na správu nedosáhne. Podrobně v Účtu a nastavení.
Souvisí
- Automatizační pravidla — akce „spusť agenta“ a vše ostatní, co mapa dělá sama
- Napojení přes n8n — n8n jako agent i jako klient API
- MCP server — připojení AI asistenta krok za krokem
- Proměnné prostředí — konfigurace kolem automatizací

