Hermes Agent + Google Kalender för nybörjare: lägg in och kontrollera en uppföljning

Ett 30-minutersblock ligger i Google Kalender. Tiden stämmer, tidszonen är rätt och inga gäster har lagts till. Det viktiga är att Hermes inte bara svarade "klart". Agenten läste tillbaka händelsen från kalendern och visade vad som faktiskt sparades.

Det här är en fortsättning på guiden där du installerar Hermes Agent och gör din första uppgift. Om du vill se samma kontrolltänk i en skrivskyddad uppgift finns också guiden om att kontrollera fem webbsidor och spara ett kvitto.

Vem guiden passar

Tänk dig att en AI-workshop precis är avslutad. Du vill reservera en halvtimme för nästa beslut, men du vill inte bjuda in någon ännu. Hermes kan lägga in blocket åt dig, kontrollera resultatet och lämna nästa beslut till dig.

Guiden förutsätter att Hermes redan är installerat. Däremot går vi igenom den tekniska delen som måste fungera innan du kan be agenten boka något: installation av Google Workspace CLI, OAuth-behörighet till Kalender och ett lästest från terminalen. För det första skrivtestet använder du en tillfällig sekundär kalender, inte din primära kalender.

Det här gör du på 20–30 minuter

Du installerar och kopplar först Google Workspace CLI till rätt Google-konto. När ett lästest fungerar skapar du en enda kalenderhändelse med tydliga fält. Sedan låter du Hermes läsa tillbaka kalendernamn, titel, start, slut, tidszon, beskrivning, påminnelser och antal gäster. Först därefter väljer du om händelsen ska behållas, ändras eller raderas.

Innan du börjar

Hermes behöver vara installerat på samma dator eller server där gws ska köras. Om du inte har gjort det än, börja med guiden där du installerar Hermes Agent och gör din första uppgift.

Du behöver också ett Google-konto med tillgång till Google Kalender. OAuth-inloggningen är en engångsdel där du själv väljer konto och godkänner behörigheten. Skicka aldrig OAuth-filen eller exporterade inloggningsuppgifter i en chatt med agenten.

Del 1: installera Google Workspace CLI

Google Workspace CLI heter gws. Projektets rekommenderade installationsväg är en färdig binär från GitHub Releases. Om du redan har Node.js 18 eller senare är npm-vägen enklast:

node --version
npm --version
npm install -g @googleworkspace/cli
gws --version

Om node --version visar en version under 18 behöver du uppdatera Node.js eller använda den färdiga binären för ditt operativsystem. Om terminalen inte hittar gws efter npm-installationen, öppna en ny terminal och kontrollera att npm:s globala binärkatalog finns i din PATH.

Google Workspace CLI är fortfarande före version 1.0 och är inte en officiellt supportad Google-produkt. Kontrollera därför aktuell installations- och autentiseringsinformation i projektets README om ett kommando har ändrats.

Del 2: skapa OAuth-behörighet för Kalender

gws behöver ett Google Cloud-projekt och en OAuth-klient. Har du redan Google Cloud CLI (gcloud) installerat och inloggat kan verktyget göra huvuddelen av arbetet:

gws auth setup
gws auth login -s calendar

Det första kommandot konfigurerar projekt och API:er via gcloud. Det andra öppnar Googles inloggning och begränsar tjänsteväljaren till Kalender. Välj kontot som har testkalendern och godkänn bara de Kalender-behörigheter som arbetsflödet behöver.

Om du inte använder gcloud, gör OAuth-konfigurationen manuellt i Google Cloud Console:

1. Skapa eller välj ett Google Cloud-projekt.
2. Konfigurera OAuth consent screen. För ett eget test räcker External i testläge.
3. Lägg till ditt Google-konto under Test users.
4. Skapa en OAuth-klient av typen Desktop app.
5. Ladda ned klientfilen och spara den som ~/.config/gws/client_secret.json på datorn där gws körs.
6. Kör gws auth login -s calendar och slutför inloggningen i webbläsaren.

Om Hermes körs på en server utan webbläsare kan du göra den interaktiva inloggningen på en betrodd dator, exportera inloggningsuppgifterna och föra över filen säkert:

gws auth export --unmasked > credentials.json

Behandla credentials.json som ett lösenord: begränsa filbehörigheten, lägg den aldrig i Git och klistra inte in innehållet i en prompt. Miljövariabeln måste vara tillgänglig för samma användare eller tjänst som kör Hermes.

Del 3: kontrollera anslutningen innan Hermes får skriva

Kör först två läskommandon själv:

gws auth status
gws calendar calendarList list --params '\{"maxResults":5\}' --format json

Det första ska visa en giltig token. Det andra ska returnera en kalenderlista från rätt konto. Dela inte råutdata offentligt eftersom den kan innehålla e-postadresser och kalender-ID:n. Om något av kommandona misslyckas är det installationen eller OAuth-kopplingen som ska rättas, inte prompten till agenten.

Kontrollera också var binären ligger:

command -v gws

Hermes-processen måste se samma sökväg. Det är särskilt viktigt om Hermes körs som Gateway eller bakgrundstjänst i stället för i samma terminal.

När lästestet fungerar öppnar du arbetsmappen där du brukar använda Hermes och startar terminalvyn:

hermes

Du kan också använda en redan konfigurerad privat Hermes-kanal, till exempel Telegram. Välj en namngiven kalender som agenten får använda. En tillfällig sekundär kalender är ett bra första test eftersom den kan tas bort utan att röra din primära kalender.

Skriv ned följande innan du ber Hermes göra något:

• Kalenderns exakta namn.
• Datum samt start- och sluttid.
• Tidszonen, till exempel Europe/Stockholm.
• En kort titel och beskrivning.
• Om påminnelser ska användas.
• Att första körningen ska ha noll gäster.

Hermes Quickstart beskriver grundflödet: ge agenten en vanlig uppgift, låt den använda rätt verktyg och granska resultatet.

Steg 1: ge Hermes ett komplett kalenderkort

Undvik formuleringar som "lägg in något nästa tisdag". Kalendernamn, datum och tidszon ska inte lämnas åt agenten att gissa.

Kopiera mallen och byt ut hakparenteserna:

Kontrollera först att gws --version och gws auth status fungerar. Om något av dem misslyckas ska du stanna och förklara felet utan att ändra kalendern. Lägg annars in exakt ett uppföljningsblock i kalendern [kalendernamn]. Titel: [titel]. Datum: [datum]. Tid: [start–slut]. Tidszon: Europe/Stockholm. Beskrivning: [mål och agenda]. Lägg inte till gäster, möteslänk, bilagor eller påminnelser. När händelsen är skapad: läs tillbaka den från Google Kalender och ge mig ett kvitto med kalender, titel, start, slut, längd, tidszon, beskrivning, påminnelser och antal gäster. Ändra inget mer utan att fråga.

I vårt test använde vi titeln Följ upp AI-workshop, tiden 10.00–10.30 och beskrivningen Mål: bekräfta nästa steg. Agenda: beslut, ansvarig, datum. Ingen kundinformation eller verklig mötesdeltagare behövs.

Om ett fält fortfarande är oklart ska Hermes fråga innan händelsen skapas. Det är bättre med en kort följdfråga än ett block i fel kalender.

Steg 2: skapa händelsen en gång

Be Hermes göra en avgränsad kalenderåtgärd och spara resursens identifierare privat under körningen. Om verktyget ger ett oklart svar ska agenten först kontrollera om händelsen redan finns. En blind omkörning kan ge två likadana block.

Google Kalender kräver start och slut när en händelse skapas. Titel, beskrivning, tidszon, gäster och påminnelser är separata fält som behöver hanteras medvetet. I den här guiden utelämnas gäster helt, så testet startar ingen inbjudningskedja.

Källa: Google Calendar API – Events: insert.

Steg 3: läs tillbaka vad Google Kalender sparade

Ett lyckat skapandeanrop visar att Google tog emot en begäran. Det räcker inte för kontrollen. Be Hermes göra en separat läsning av den sparade händelsen och jämföra resultatet med ditt kalenderkort.

Ett kompakt kvitto kan se ut så här:

• Kalender: rätt namngiven testkalender.
• Titel: Följ upp AI-workshop.
• Start och slut: 10.00–10.30.
• Längd: 30 minuter.
• Tidszon: Europe/Stockholm.
• Beskrivning: exakt matchning.
• Påminnelser: avstängda, inga egna undantag.
• Gäster: 0.
• Möteslänk och bilagor: saknas.

Google skiljer mellan skapandet av en händelse och en separat hämtning av den. Det är den senare läsningen som ger underlaget för kvittot.

Källa: Google Calendar API – Events resource.

Det praktiska testet bakom guiden kördes med Hermes Agent 0.20.5 och Google Workspace CLI 0.22.5. CLI-verktyget returnerar strukturerad JSON som Hermes kan kontrollera, men projektet är före version 1.0 och beskriver sig självt som ett verktyg som inte stöds officiellt av Google. Låt därför agenten läsa aktuell hjälp i stället för att bygga flödet kring gamla kommandon.

Källa: Google Workspace CLI på GitHub.

Steg 4: fatta beslut efter kontrollen

När alla fält stämmer väljer du nästa handling. Du kan behålla blocket, rätta ett fält och läsa tillbaka igen eller radera händelsen. Gäster, möteslänk eller andra mötesdetaljer bör läggas till i en separat uttrycklig åtgärd efter kontrollen.

Det här håller ansvarsfördelningen enkel: Hermes utför och verifierar den avgränsade uppgiften. Du bestämmer om kalenderposten ska bli en faktisk mötesinbjudan.

Vanliga misstag

• Ett relativt datum som "nästa tisdag" används utan exakt datum eller tidszon.
• Kalendern väljs implicit fast kontot har flera kalendrar.
• Ett chattmeddelande om att uppgiften är klar godtas utan separat läsning.
• Organisatören räknas felaktigt som en gäst.
• Standardpåminnelser antas vara avstängda utan att fältet kontrolleras.
• Samma begäran körs igen efter ett oklart svar innan kalendern har kontrollerats.

Nästa steg

När ett gästfritt uppföljningsblock fungerar pålitligt kan du använda samma mönster för andra tydligt avgränsade kalenderuppgifter. Lägg till inbjudningar först när du har en egen kontroll- och godkännandepunkt för mottagare, tid och innehåll.

Vill du koppla en agent till Google Workspace med tydliga behörigheter, godkännanden och körkvitton? Hammer kan hjälpa dig att bygga den första avgränsade integrationen genom Verktygssmidet.