Case study: mail-agent

Hlavní pointa: ušetřit čas na emailu, ale bez rizika, že “něco odejde špatně”. Proto je jádro designu schválení + bezpečné defaulty.

Kontext

  • email je “high stakes”: špatná odpověď může stát reputaci
  • většina inboxu je šum, ale část jsou důležité věci

Design rozhodnutí (a proč)

  • Human‑in‑the‑loop: odeslání až po /yes v Telegramu
  • Moduly: responder/sorter/newsletter se dají zapínat nezávisle
  • Heuristiky bez AI: rychlé třídění bulk emailů šetří náklady i latenci

Největší pasti

  • falešná jistota z klasifikace → řešení: eskalace a “safe skip”
  • edge cases (nečekaný formát, chybějící kontext) → řešení: UNK/ESC notifikace
  • opakované zpracování → řešení: idempotence (na úrovni message id / state)

Důkazy / provozní signály

  • Telegram approval zprávy jako audit trail (co agent navrhl vs co bylo schváleno)
  • test fixtures v tests/ pro typické scénáře

Co bych udělal jinak

  • standardizovaný “decision log” (pro každé rozhodnutí: vstup → důvod → akce)
  • replay běh z logu (debug “co se stalo” bez přístupu k inboxu)