Dokumentace agenta

Dokumentace agenta je šablona z kurzu Claude Masterclass, která na jedné stránce popisuje, co agent dělá, k čemu má přístup, kdo za něj odpovídá a jak se vypíná.

Proč to manažera zajímá

AI agent, o kterém ví jen ten, kdo ho postavil, je riziko. Když autor odjede na dovolenou nebo z firmy odejde, nikdo neví, co agent smí, kam posílá data a jak ho zastavit. Za kroky agenta přitom odpovídá ten, kdo ho pustil, ne nástroj (odpovědnost za výstup AI). Dokumentace z agenta dělá řízený firemní nástroj, kterému kdokoli z týmu porozumí za pět minut.

Jak to vypadá v praxi

V kurzu Masterclass: Claude pro byznys ji vyplníte v modulu 7 jako poslední krok: po workflow kartě, stavbě agenta a třech testovacích bězích. U agenta, který v e-shopu třídí příchozí poptávky, obsahuje: účel a hranice (třídí a navrhuje odpovědi, nic neodesílá), přístupy (sdílená schránka jen pro čtení, tabulka poptávek), odpovědnou osobu (vedoucí obchodu) a postup vypnutí (odebrat přístup ke schránce, pozastavit úlohu). Doplňte, kde najdete log a jak se měří spolehlivost. Na dokumentaci odkazuje AI politika.

Na co si dát pozor

  • Dokumentaci aktualizujte při každé změně přístupů, ne jednou ročně.
  • Otázka „jak agenta okamžitě zastavím“ musí mít odpověď dřív, než agent poběží sám.

Podrobně v článku

Související pojmy

  • Workflow karta

    Workflow karta je šablona z kurzu Claude Masterclass pro návrh agentního postupu. Rozkládá proces na kroky se vstupy a výstupy, určuje kontrolní body, kde rozhoduje člověk, a způsob měření.

  • Log a auditní stopa agenta

    Log a auditní stopa agenta je záznam toho, co AI agent udělal, kdy, s jakými daty a proč. Bez něj nejde zpětně dohledat chybu, vyřídit reklamaci ani doložit dodržování AI politiky.

  • Spolehlivost agenta

    Spolehlivost agenta je podíl úloh, které AI agent dokončí správně bez zásahu člověka, měřený na vzorku skutečných výstupů spolu s typem chyb a náklady na jejich opravu.

  • AI politika

    AI politika je krátký firemní dokument s pravidly pro práci s AI: které nástroje jsou schválené, jaká data do nich smí, kdo smí nasadit agenta nebo konektor a kdo za výsledky odpovídá.

  • Odpovědnost za výstup AI

    Odpovědnost za výstup AI je princip, podle kterého za výsledek práce s AI odpovídá člověk nebo firma, kteří ho použili, ne nástroj. Proto výstup před odesláním někdo zkontroluje a schválí.

  • AI agent

    AI agent je program nad jazykovým modelem, který na zadaný cíl sám plánuje kroky, používá nástroje a pracuje dál bez další zprávy od člověka. Na rozdíl od chatbota tedy jen neodpovídá, ale jedná.

Kde to učíme

Pojem z kurzu Masterclass: Claude pro byznys. Prakticky ho procházíme v modul 7: Agenti a workflow. Na reálných úlohách z vaší firmy, česky a bez technického zázemí.

Prohlédnout moduly kurzu