Nejdřív tři příkazy z adresáře s instalací:
docker compose ps # běží služby, je databáze zdravá?
docker compose logs --tail 50 worker # poslední záznamy workera
docker compose run --rm worker node diag.mjs schranka@firma.czPoslední příkaz udělá totéž co Otestovat spojení v rozhraní: vezme přístup uložený pro schránku, získá token, vypíše jeho oprávnění (nikdy token sám) a přečte doručenou poštu.
Časté chyby
| Příznak | Příčina | Co udělat |
|---|---|---|
set DB_PASSWORD in .env při startu | chybí hesla databáze | doplnit .env |
mailbox … has no access yet | schránka nemá registraci ani připojený účet | stránka schránky → Přístup k poště |
Graph … 401 … invalid_client | špatný nebo vypršelý client secret | nový secret u registrace, pak test spojení |
Graph … 403 … AppOnly AccessPolicy | zásada přístupu aplikace se ještě neprojevila, nebo schránka není ve skupině | počkat (i hodiny), zopakovat test; přidat schránku do skupiny |
Graph … 403 … ErrorAccessDenied | chybí souhlas správce | v Entra u registrace Grant admin consent |
Category not added … MailboxSettings | chybí oprávnění MailboxSettings.ReadWrite; štítek funguje, jen bez barvy | přidat oprávnění a souhlas |
No active assistant in the database | asistent je vypnutý, nebo neproběhlo úvodní naplnění | zapnout asistenta; zkontrolovat log startu |
| asistent se přeskakuje („no prompts yet“) | asistent nemá napsané pokyny | dokončit průvodce, nebo pokyny napsat ručně |
Draft without signature / links outside the allowed domains | koncept neprošel kontrolou | podívat se na zprávu — může jít o pokus o podvrh |
Limit reached | denní limit nebo limit na odesílatele | zvýšit jen, když je příval pošty oprávněný |
Model refused to answer | bezpečnostní filtr modelu | zprávu vyřídit ručně |
Model exhausted max_iterations | model se zacyklil v nástrojích | opakuje se dvakrát; když se to vrací, doladit pokyn Úkol |
ECONNREFUSED … 3306 | databáze neběží nebo ještě nenaběhla | docker compose ps, docker compose logs db |
Když to nevidíte v logu
- Rozhraní: Nastavení asistenta → Aktivita (kontroly pošty, požadavky, události) a stránka Provoz (workery, fronta, chyby za 24 hodin).
- Zpráva po třech neúspěšných pokusech dostane stav selhalo; poslední chyba je v jejím detailu.
Jednorázový průchod ručně
docker compose run --rm worker node worker.mjs --dry-runProjde všechny aktivní asistenty jednou a vynutí přitom zkušební režim — nic se nezapíše do pošty. Hodí se k ověření, že vše funguje.