Wiki · Integrace
Google Workspace
Nejdřív si odpovězte: potřebujete e-mail, nebo celý Workspace? Od toho se odvíjí celé nastavení.
📨
Nejdřív si odpovězte na jednu otázku: potřebujete e-mail, nebo celý Workspace?
Když jen posílat a číst poštu, stačí himalaya skill s heslem aplikace — hotové za dvě minuty
a bez Google Cloud projektu. Google Workspace skill je na Gmail plus Kalendář, Disk,
Tabulky a Dokumenty, a proto potřebuje OAuth přes cloudový projekt.
Dvě cesty k poště
| himalaya (jen e-mail) | Google Workspace skill | |
|---|---|---|
| Nastavení | Heslo aplikace, 2 minuty | Google Cloud projekt, OAuth, 15–30 minut |
| Umí | Číst, hledat, posílat poštu | Gmail, Kalendář, Disk, Tabulky, Dokumenty, Kontakty |
| Přístup | IMAP/SMTP s heslem | OAuth2 s obnovováním tokenu |
| Pro běžného uživatele | Skoro vždy stačí | Když agent opravdu musí plánovat schůzky a pracovat se soubory |
Nastavení Workspace skillu
Celé nastavení vede sám agent — řeknete mu, ať Google Workspace nastaví, a on vás provede:
1) založit projekt v Google Cloud a zapnout API:
Gmail, Calendar, Drive, Sheets, Docs, People
2) vytvořit OAuth 2.0 přihlašovací údaje typu „Desktop app“
a stáhnout JSON s client secret
3) autorizovat: agent vygeneruje odkaz, vy ho v prohlížeči schválíte
a vložíte zpět adresu, na kterou vás to přesměrovalo
4) hotovo — token se od té chvíle obnovuje sám
🔐
Soubor s client secret a vzniklý token jsou
přihlašovací údaje k vaší poště. Nikdy je nedávejte do gitu ani do chatu. Když je
projekt zbytečný, zrušte autorizaci v Google účtu (Zabezpečení → Aplikace třetích stran).
Co agent umí
| Oblast | Příklady |
|---|---|
| Gmail — hledání | is:unread, from:sef@firma.cz newer_than:1d, has:attachment filename:pdf |
| Gmail — čtení a odesílání | Přečte tělo zprávy; pošle text, HTML i kopii (CC), umí i zobrazované jméno odesílatele |
| Kalendář | Vypíše události, založí schůzku s místem a účastníky, smaže událost |
| Disk | Hledání souborů (i podle typu přes raw dotaz) |
| Tabulky | Čtení rozsahu, zápis, přidávání řádků |
| Dokumenty a kontakty | Text dokumentu, seznam kontaktů |
Kalendář vyžaduje časové pásmo. Čas jako 2026-03-01T10:00:00
bez +01:00 nebo Z se bere jako UTC — a schůzka pak vyjde o hodinu nebo dvě jinde.
Vždy pište posun: 2026-03-01T10:00:00+01:00.
Na co si dát pozor
| Situace | Co s tím |
|---|---|
| Autorizace skončí chybou „redirect_uri_mismatch“ | Přihlašovací údaje nejsou typu Desktop app, nebo se vkládá jiná adresa, než kterou Google vrátil |
| Po měsíci přestane fungovat | Projekt v Google Cloud je v režimu testování — tokeny v něm vyprší; publikujte aplikaci nebo obnovte autorizaci |
| Agent nevidí nové zprávy | Ověřte, že skilly jsou zapnuté a že projekt má opravdu povolené Gmail API |
| Chcete jen poštu a nic víc | Použijte himalaya — méně práce a méně oprávnění |
Jak to používáme
Pro poštu máme himalaya (rychlé, bez cloudu), Workspace skill nasazujeme tam, kde agent opravdu pracuje s kalendářem — třeba když z e-mailu pozná termín a má ho zapsat. Osvědčilo se:
| Zvyk | Proč |
|---|---|
| Agent jen navrhne schůzku, sám ji nezapisuje bez potvrzení | Chybně zapsaná schůzka v cizím kalendáři je horší než žádná |
| Posílat z vlastní adresy, ale se jménem robota | Příjemce pozná, že mu píše asistent, ne člověk |
| Heslo aplikace jen pro čtení, kde to jde | Menší dopad, když uteče |