Kun agentti saa yhteyden puhelimeesi

Puhelinyhteys tekee agentista näkyvän arjessa. Se on hyödyllistä vain, jos hälytys on harvinainen, rajattu ja ymmärrettävä. Tässä moduulissa lisäät kanavan, joka kertoo milloin ihmisen pitää katsoa, mutta ei vuodata sisältöä lukitusruudulle eikä tee päätöstä puolestasi.

Tarkat komennot ja tekninen toteutus ovat moduulin lopussa.

Hyvä hälytys on lyhyt

Hyvä hälytys sanoo: "Tarkista aamuraportti" tai "Ajastus epäonnistui, katso virheloki." Se ei sano: "Asiakas X lähetti arkaluonteisen viestin aiheesta Y." Puhelin on nopea mutta näkyvä pinta. Siksi siihen viedään metatieto, ei koko asia.

Taloyhtiön huoltopyyntöjen lajittelija voi ilmoittaa, että kolme pyyntöä odottaa tarkistusta. Se ei lähetä asukkaan nimeä ja ongelman yksityiskohtaa puhelimeen. Pienen toiminimen kirjanpidon esikäsittelijä voi ilmoittaa, että kuittikooste on valmis. Se ei lähetä tositteiden tietoja.

Hälytysrytmi

Päätä neljä tasoa:

1. Hiljainen loki: normaali onnistuminen.
2. Päiväkooste: ei kiirettä.
3. Nopea hälytys: ihmisen päätös tarvitaan.
4. Välitön hälytys: turvallisuus, raha tai pysäytys.

Useimmat asiat kuuluvat kahteen ensimmäiseen. Jos kaikki on kiireellistä, mikään ei ole kiireellistä. WENDY muistaisi tämän lempeästi. CASE sanoisi sen lyhyemmin.

Turvarajat

Puhelinyhteyteen tarvitaan ainakin nämä rajat:

• vain valitut tehtävät saavat lähettää ilmoituksen
• ilmoitus ei sisällä salaisuuksia
• ilmoitus ei sisällä arkaluonteista henkilötietoa
• ilmoitus ei käynnistä uutta työtä itsestään
• kanava voidaan sulkea yhdellä komennolla
• ihminen päättää, mitä ilmoituksesta seuraa

Tämä pitää Oma Digitiimin apurina eikä hälytyskoneena.

Tietosuoja suomalaiselle käyttäjälle

Muista erityisesti henkilötiedot, arkaluonteiset tiedot, lasten tiedot, terveys, talous ja työntekijöitä koskevat tiedot. Suomessa tietosuojavaltuutetun ohjeet ja EU:n yleinen tietosuoja-asetus antavat käytännön raamit: kerää vain tarpeellinen, säilytä vain tarpeellinen ja pidä käsittelyn tarkoitus selvänä.

EU:n tekoälyasetus lisää oman kerroksensa. Tämän kurssin kotikäyttöinen Oma Digitiimi pysyy turvallisella puolella, kun agentti valmistelee, ihminen päättää ja riskialttiit käyttötapaukset jätetään pois tai tarkistetaan erikseen.

Kulujen ja huomion hallinta

Puhelinhälytys voi myös paljastaa huonon kustannusrytmin. Jos saat ilmoituksen joka tunti, ongelma ei ole puhelimessa vaan tehtävän suunnittelussa. Ajasta harvemmin, rajaa lähde paremmin tai poista automaatio, kunnes käsin tehty ajo on jälleen hyödyllinen.

Kirjoita viikkotarkistus: montako ajoa tehtiin, montako hälytystä lähti, kuinka moni hälytys oli oikeasti hyödyllinen, tuliko virheitä ja mitä hiljennetään ensi viikolla.

Kun siirryt asentimeen

Jos haluat valmiimman polun, Arkiopas-asennin löytyy osoitteesta https://arkiopas.hoitovirhe.fi/. Käsin rakentaminen opetti, mitä koneelle tapahtuu. Asennin nopeuttaa, kun ymmärrät rakenteen: työtila, mallipolku, agenttikortit, muisti, rytmi, tarkastus ja puhelinyhteys.

Älä ajattele asenninta luovuttamisena. Ajattele sitä viitoitettuna polkuna sen jälkeen, kun olet kerran kulkenut maaston läpi.

Viimeinen tarkistus ennen oikeaa käyttöä

Ennen kuin annat agentille oikeita arjen tehtäviä, vastaa:

• Onko työtila rajattu?
• Onko ensimmäinen agentti testattu vaarattomalla aineistolla?
• Onko ajastus pysäytettävissä?
• Näkyykö onnistuminen ja virhe?
• Onko muisti erotettu lähteisiin ja tulkintoihin?
• Lähettääkö puhelin vain metatietoa?
• Tiedätkö kuka hyväksyy lopullisen työn?

Jos vastaus on kyllä, sinulla on pieni mutta järkevä agenttiorganisaatio. Ei valmis imperiumi. Se on hyvä asia. Hyvät organisaatiot aloittavat vastuusta.

nano ~/Agentit/secrets/telegram.env
chmod 600 ~/Agentit/secrets/telegram.env

TELEGRAM_BOT_TOKEN="123456:REPLACE_ME"
TELEGRAM_CHAT_ID="123456789"

cat > ~/Agentit/bin/laheta-telegram.py <<'EOF'
#!/usr/bin/env python3
import sys
import urllib.error
import urllib.parse
import urllib.request
from pathlib import Path

env_path = Path.home() / "Agentit" / "secrets" / "telegram.env"
values = {}
for line in env_path.read_text(encoding="utf-8").splitlines():
    line = line.strip()
    if not line or line.startswith("#") or "=" not in line:
        continue
    key, value = line.split("=", 1)
    values[key] = value.strip().strip('"')

token = values["TELEGRAM_BOT_TOKEN"]
chat_id = values["TELEGRAM_CHAT_ID"]
message = " ".join(sys.argv[1:]).strip()
if not message:
    raise SystemExit("Anna viesti.")

data = urllib.parse.urlencode({"chat_id": chat_id, "text": message}).encode()
url = f"https://api.telegram.org/bot{token}/sendMessage"

try:
    with urllib.request.urlopen(url, data=data, timeout=10) as response:
        if response.status != 200:
            raise SystemExit(f"Telegram vastasi tilalla {response.status}")
except urllib.error.HTTPError as error:
    raise SystemExit(f"Telegram HTTP-virhe: {error.code}") from error
EOF

chmod 700 ~/Agentit/bin/laheta-telegram.py

~/Agentit/bin/laheta-telegram.py "Arkiopas-testi: yhteys toimii."
printf '%s telegram testattu\n' "$(date '+%Y-%m-%d %H:%M')" >> ~/Agentit/logs/activity.log

~/Agentit/bin/laheta-telegram.py "Aamuraportti valmis. Tarkista ~/Agentit/wiki."

launchctl unload ~/Library/LaunchAgents/com.arkiopas.aamuraportti.plist
launchctl unload ~/Library/LaunchAgents/com.arkiopas.iltakooste.plist 2>/dev/null || true

Tiivistelmä

• Puhelimeen lähetetään metatietoa, ei koko sisältöä.
• Hälytysrytmi pidetään harvana ja päätöstä tukevana.
• Henkilötiedot, arkaluonteiset tiedot, lasten tiedot, terveys ja talous vaativat erityistä varovaisuutta.
• Arkiopas-asennin on hyvä jatkopolku, kun ymmärrät käsin rakennetun mallin.
• Kurssin ydinsääntö pysyy samana: agentti valmistelee, ihminen päättää.