Wiki · Funkce do hloubky
E-mail a kalendář
Agent může mít vlastní adresu a přístup ke kalendáři. Tady je, jak to nastavit, kdo mu smí psát a na co si dát pozor.
Tři cesty, jak agenta k poště pustit
| Cesta | Co umí | Co k tomu potřebujete |
|---|---|---|
| E-mail jako kanál (gateway) | Píšete agentovi na adresu, on odpovídá; dá se použít pro pravidelné úlohy | Adresu, přístup přes IMAP a SMTP, heslo aplikace |
| Vlastní adresa + Himalaya | Agent sám kontroluje schránku a posílá poštu, bez trvale běžícího bota | Vlastní e-mailový účet a nástroj Himalaya |
| Google Workspace | Gmail, kalendář, Disk, Tabulky, Dokumenty a Kontakty | Projekt v Google Cloud a přihlášení přes OAuth (jednorázově) |
Když chcete jen poštu, zvolte e-mail jako kanál nebo Himalayu — nastavení je otázka minut. Google Workspace je na kalendář, Disk a Dokumenty, ale vyžaduje projekt v Google Cloud a schvalování přístupu.
E-mail jako kanál: nastavení
Spusťte průvodce a vyberte E-mail (provede vás vším potřebným):
❯ hermes gateway setupNebo to nastavte ručně v
~/.hermes/.env— povinné čtyři údaje:# ~/.hermes/.env EMAIL_ADDRESS=agent@vasedomena.cz EMAIL_PASSWORD=heslo aplikace # pozor: ne vaše běžné heslo! EMAIL_IMAP_HOST=imap.vasedomena.cz EMAIL_SMTP_HOST=smtp.vasedomena.czDoplňte, kdo smí psát, a identifikaci serveru (viz níž, je to bezpečnostní pojistka):
# kdo smí agentovi psát (jinak se zprávy ignorují) EMAIL_ALLOWED_USERS=vy@vasedomena.cz,kolega@firma.cz # identifikátor serveru, který přidává ověření do hlaviček zpráv EMAIL_AUTHSERV_ID=mx.google.comNechte to běžet. Buď napřímo, nebo jako službu, která se nastartuje se serverem:
❯ hermes gateway # běží v popředí ❯ hermes gateway install # jako služba
| Údaj | Výchozí | K čemu je |
|---|---|---|
EMAIL_IMAP_PORT | 993 | Příjem pošty (zabezpečené spojení) |
EMAIL_SMTP_PORT | 587 | Odesílání pošty |
EMAIL_POLL_INTERVAL | 15 vteřin | Jak často se schránka kontroluje |
EMAIL_HOME_ADDRESS | — | Kam mají chodit výstupy pravidelných úloh |
Při startu agent všechny zprávy ve schránce označí jako přečtené a zpracovává už jen nové. Když tedy spouštíte e-mailový kanál poprvé, počítejte s tím, že historie se ignoruje.
Kdo smí agentovi psát
| Nastavení | Co se stane |
|---|---|
| Vyplněný seznam povolených | Zpracují se jen zprávy z těch adres |
| Prázdný seznam | Neznámí odesílatelé se tiše ignorují — nikdo nedostane ani odpověď |
Režim pair | Neznámý odesílatel dostane párovací kód (může se přidat) |
Režim decline | Neznámý odesílatel dostane jednu slušnou odpověď a pak nic (24 hodin) |
Ověřování odesílatele: agent jedná, jen když server, který poštu přijal, potvrdí,
že zpráva opravdu pochází z uvedené domény (DMARC nebo SPF/DKIM). Proto je v nastavení
EMAIL_AUTHSERV_ID — musí přesně odpovídat tomu, co váš přijímací server píše do hlaviček.
Bez toho se dá From: v e-mailu podvrhnout a agent by poslouchal cizí příkazy.
Kalendář a další služby Google
Kalendář se neřeší přes e-mail, ale přes připravený postup pro Google Workspace. Ten vedle kalendáře umí i Gmail, Disk, Tabulky, Dokumenty a Kontakty. Nastavení je jednorázové a vede vás jím agent:
- Vytvoří se projekt v Google Cloud a zapnou potřebná rozhraní (Gmail, Kalendář, Disk, Tabulky, Dokumenty, Kontakty).
- Vytvoří se přihlašovací údaje typu desktopová aplikace a stáhne se soubor s tajemstvím.
- Agent vygeneruje odkaz pro přihlášení — vy ho schválíte v prohlížeči a vložíte zpět adresu z prohlížeče.
- Od té chvíle se přihlášení obnovuje samo.
Práce s kalendářem pak vypadá takhle (příkazy zadáváte v rozhovoru, nemusíte je psát ručně):
Pozor na časová pásma. Kalendář vyžaduje, aby u času bylo uvedeno
pásmo (například +02:00 pro český letní čas) nebo aby šlo o světový čas. Když pásmo
chybí, bere se čas jako světový — a schůzka vám o dvě hodiny uteče.
Pasti z našeho provozu
| Co se stalo | Co s tím |
|---|---|
| Agent nezpracoval žádnou zprávu | Nejčastěji nesouhlasí EMAIL_AUTHSERV_ID s tím, co píše váš server, nebo je adresa mimo seznam povolených. Obojí se pozná z logu služby |
| Do schránky nechodily odpovědi | U vlastní domény musí být v pořádku SPF, DKIM a DMARC. Bez nich pošta končí ve spamu nebo se zahazuje |
| Agent poslouchal cizí adresu | Nikdy nepoužívejte režim „povolit všechny“. Seznam povolených je to, co vás drží |
| Přihlášení k e-mailu přestalo fungovat po změně hesla | Heslo aplikace se musí aktualizovat i v nastavení — u některých poskytovatelů si ho vygenerujete znovu |
| Schůzka se zapsala o dvě hodiny jinde | Chybělo časové pásmo. Vždycky uveďte čas i s pásmem, nebo se před zápisem zeptejte, jak to agent pochopil |
| V e-mailové schránce zůstaly stovky starých zpráv a agent na ně nereagoval | To je správně — při startu se historie označí jako přečtená. Když potřebujete starší e-mail zpracovat, přepošlete ho znovu |
Naše tipy
| Tip | Proč |
|---|---|
| Zřiďte agentovi vlastní adresu | Nepletení se s vaší pracovní poštou a jasný seznam, kdo mu smí psát |
| Do předmětu pište, o co jde | Agent podle předmětu lépe pozná úkol a vy si udržíte přehled ve vláknech |
| E-mail berte jako dopis, ne jako chat | Je veřejnější a pomalejší — na citlivé věci se hodí spíš chat nebo terminál |
| Pravidelné úlohy nechte posílat na jednu adresu | Nastavte EMAIL_HOME_ADDRESS a ranní přehledy vám budou chodit spolehlivě |
| Před plošným použitím si vyzkoušejte jeden e-mail | Ověříte ověřování odesílatele i odpovědi, než na tom postavíte provoz |