# URL, joka herättää agenttisi

> Agentit heräävät, kun lähetät niille viestin tai kun niiden kalenteri sanoo, että on aika. Nyt ne voi herättää myös kaikki, mikä osaa lähettää HTTP POST -pyynnön: n8n-työnkulku, Zap tai GitHub Action.

Published 2026-07-31 · https://squidler.io/fi/blog/external-triggers

Agenttimme ajoittavat jo omat työnsä. Kalenteritapahtuma laukeaa, agentti herää, tekee työn ja ottaa yhteyttä vain, jos jokin ansaitsee huomiosi. Se kattaa kaiken, minkä voi ennakoida: maanantain tilanneraportin ja päivittäisen tarkistuksen epäluotettavalle toimittajasyötteelle. Mutta työ, joka oikeasti keskeyttää päiväsi, on harvoin aikataulussa. Pull request ei avaudu cron-lausekkeen mukaan.

Siksi agentit voivat nyt luoda ulkoisia herätteitä: kalenteritapahtumia ilman aikataulua, pelkkä URL. Lähetä tuohon URL-osoitteeseen HTTP POST, niin agentti herää ja suorittaa tapahtumaan tallennetun ohjeen. Siinä on koko rajapinta. Jos järjestelmä osaa kutsua URL-osoitetta, se voi panna agenttisi töihin.

```
curl -X POST https://squidler.io/gateway/triggers/calendar/<your-trigger-token>
```

Voit pyytää herätettä agentiltasi chatissa (”tee heräte uusien pull requestien katselmointia varten”), jolloin se antaa sinulle URL-osoitteen ja juuri sinun putkeesi sopivan koodinpätkän, tai voit luoda sellaisen itse työpöydän Ulkoiset herätteet -kortilta. Kortti ilmestyy, kun ensimmäinen heräte on olemassa. Siellä kopioit URL-osoitteita, keskeytät herätteen tai perut sen poistamalla tapahtuman.

## Kolme paikkaa, joista sitä voi kutsua

**n8n-työnkulku.** Lisää HTTP Request -solmu minkä tahansa [n8n](https://n8n.io)-työnkulun loppuun. Uusi liidi saapuu CRM:ään, n8n hoitaa tavanomaisen reitityksensä, ja viimeinen solmu herättää agenttisi, jonka ohjeena on selvittää yrityksen taustat ja pitää lyhyt katsaus valmiina ennen kuin kukaan tarttuu puhelimeen.

**Zap.** Sama kuvio toimii [Zapierissa](https://zapier.com) tai [Makessa](https://www.make.com): lopeta Webhooks POST -vaiheeseen. Lomakevastaus saapuu, Zap tallentaa sen oikeaan paikkaan, ja agentti lukee uudet merkinnät ja nostaa esiin ne, jotka tarvitsevat ihmistä jo tänään eikä vasta tällä viikolla.

**GitHub Action.** Alla oleva työnkulku herättää agentin aina, kun pull request avataan tai siihen tulee uusia committeja. Agentin pysyvä ohje: tarkista uudet tai päivittyneet PR:t, katselmoi muutokset ja raportoi havainnot.

```yaml
on:
  pull_request:
    types: [opened, synchronize]
jobs:
  wake-agent:
    runs-on: ubuntu-latest
    steps:
      - run: curl -X POST ${{ secrets.AGENT_TRIGGER_URL }}
```

Tallenna URL repositorion salaisuudeksi: kuka tahansa, jolla se on, voi laukaista herätteen.

Mikään näistä ei ole meidän rakentamamme integraatio. Ne ovat kaikki pelkkää POSTia, ja juuri siitä on kyse: työkaluja, jotka osaavat kutsua URL-osoitetta, on paljon enemmän kuin missään integraatioluettelossa. Saatavuusvalvonta voi kutsua sitä heti, kun sivustosi kaatuu, jolloin agentti menee katsomaan itse sivustoa sen sijaan, että kertoisi sinulle mittauksen epäonnistuneen. Calendly voi kutsua sitä, kun tapaaminen varataan, jolloin agentilla on osallistujasta katsaus valmiina ennen puhelua. Itse pyyntö ei kanna mitään. Agentti toimii tallentamasi ohjeen mukaan ja etsii itse kaiken muun tarvitsemansa, joten ohjeessa kannattaa kertoa, mistä katsoa (”tarkista uudet tai päivittyneet pull requestit”), ja agentti hakee loput itse.

## Suojakaiteet

Se, mitä kutsuja lähettää pyynnön mukana, ei koskaan päädy agentille asti. Se on turvatoimi eikä aukko: URL toimii kuin avain, ja avaimia kopioidaan asetustiedostoihin, chat-ketjuihin ja näytönjakoihin. Joku, joka löytää sen, voi käynnistää kirjoittamasi tehtävän, mutta ei mitään muuta. Hän ei voi ujuttaa tietoja tai ohjeita agenttisi päähän, joten vuotanut URL on harmi eikä sisäänpääsy.

Jokainen laukaisu on tavallista agentin työtä ja kuluttaa tavallista kiintiötäsi, joten herätteen laukaisukerroilla on katto: 10 kertaa minuutissa, 30 tunnissa ja 120 päivässä. Sen ylittävät kutsut torjutaan eikä niitä säästetä myöhemmäksi, joten hallitsemattomaksi karannut kutsuja menettää kutsuja sen sijaan, että polttaisi päivän kiintiön tunnissa.

Agentti myös pitää kirjaa. Jos jokin kutsuu samaa herätettä yhdeksän kertaa tunnissa, agentille kerrotaan juuri se sen herätessä, ja sen tehtävä on nostaa asia esiin: korjaa se, mikä on jumissa, tai keskeytä heräte, molemmat yhden klikkauksen päässä, sen sijaan että se kävisi kiltisti läpi jokaisen kaksoiskappaleen.

Keskeytys säilyttää URL-osoitteen mutta pysäyttää laukaisut, joten keskeytetyn herätteen voi ottaa uudelleen käyttöön ilman, että kenenkään tarvitsee koskea asetuksiinsa. Vasta herätteen poistaminen tappaa URL-osoitteen lopullisesti; uusi heräte saa uuden.

## Mitä sanoa agentillesi

Ulkoiset herätteet ovat tänään käytössä kaikilla agenteilla, ja alkuun pääsee yhdellä chat-viestillä. Ohjeista agenttia kuin kollegaa: kerro, milloin heräte laukeaa ja mitä haluat saada tehdyksi.

*[Tässä julkaisussa on interaktiivinen kuvio — avaa julkaisu nähdäksesi sen.](https://squidler.io/fi/blog/external-triggers)*

Sama kuvio toimii kaikkeen, mitä agenttisi voi tarkistaa itse: julkaisujen vahtiin (”kun tämä laukeaa, hae tilasivumme ja kerro, näyttääkö jokin oudolta”) tai koodin katselmoijaan (”katselmoi pull requestit, jotka ovat uusia tai päivittyneet edellisen ajosi jälkeen, ja lähetä minulle tärkeimmät huomiot”). Ohjeista, hae URL, liitä se putkeesi.

Ohjetta voi muuttaa milloin tahansa työpöydän Ulkoiset herätteet -kortilla, ja URL pysyy samana, joten sitä kutsuvaan Zapiin tai työnkulkuun ei tarvitse koskaan koskea. Siitä eteenpäin agenttisi on yhden POSTin päässä mistä tahansa.