| Tyyppi | Suoritetaan, kun |
|---|---|
schedule | Cron-lauseke täsmää. |
heartbeat | Aikaväli kuluu, halutessasi päivittäisen aikaikkunan sisällä. |
event | Lähetetään tapahtuma, jonka lähde täsmää. |
watch | Laajennuksen tarkkailija kirjoittaa tulosterivin. |
folder | Kansion tiedostot muuttuvat. |
manual | Omistaja tai työntekijä käynnistää sen. |
call | Puhelinlinja soi. Vain puhelinvalikoissa. |
schedule
{ "type": "schedule", "cron": "0 8 * * 1-5", "schedule": "Weekdays at 8:00" } cron on viisikenttäinen cron-lauseke: minuutti, tunti, kuukauden päivä, kuukausi, viikonpäivä. schedule on valinnainen kuvaus ihmisille. Ajastukset suoritetaan botin paikallisella aikavyöhykkeellä. Nebo tarkistaa ajastukset viiden sekunnin välein. Käynnistys, joka jäi väliin botin ollessa pois päältä, suoritetaan kerran jälkikäteen, jos se on myöhässä alle tunnin. Käynnistys ohitetaan, jos edellinen suoritus on vielä kesken.
heartbeat
{ "type": "heartbeat", "interval": "30m", "window": "08:00-18:00" } interval on aikaväli, kuten 30m, 1h tai 2h30m. window, HH:MM-HH:MM, pitää käynnistykset työaikojen sisällä. Seuraava käynnistys on edellinen käynnistys plus aikaväli siirrettynä ikkunan sisään; ensimmäinen on yhden aikavälin päästä työnkulun latautumisesta. Ajastimet säilyvät uudelleenkäynnistysten yli. Käynnistys ohitetaan, jos edellinen suoritus on vielä kesken, eikä virheellinen aikaväli koskaan käynnisty.
event
{ "type": "event", "sources": ["support-coordinator.summary.ready", "assignment.*"] } sources luettelee tapahtumien nimet, jotka täsmätään tarkasti tai loppuun lisätyllä .*-jokerimerkillä. Tyhjä lista on virhe, joka hylkää koko agent.json-tiedoston. Suoritus saa arvot _event_source, _event_payload ja _event_origin. Katso Tapahtumat, miten nimet muodostuvat.
watch
{ "type": "watch", "plugin": "mail", "event": "email.new" } Tarkkailu pitää laajennuksen prosessin käynnissä ja käynnistää suorituksen jokaisesta rivistä, jonka se kirjoittaa. Jokainen rivi saapuu muodossa _watch_payload. Kymmenen minuutin sisällä toistuvat identtiset rivit hylätään.
| Kenttä | Oletus | Merkitys |
|---|---|---|
plugin | pakollinen | Kyky, kuten mail, tai laajennuksen slug. Nimeä kyky aina, kun sellainen sopii. |
event | ei mitään | Tapahtuma laajennuksen events-listasta. Nebo käyttää kyseisen tapahtuman komentoa ja lähettää lisäksi jokaisen rivin muodossa <plugin>.<event>. |
command | ei mitään | Argumentit, jotka käynnistävät tarkkailijan. Käytetään, jos asetettu; muuten otetaan kentästä event. |
restart_delay_secs | 5 | Odotusaika ennen pysähtyneen tarkkailijan uudelleenkäynnistystä. |
Kyky ratkeaa asennettuun laajennukseen, joka tarjoaa sen, ja etusijalla on laajennus, jossa tällä työntekijällä on tili. Jos sellaista laajennusta ei ole, työnkulku merkitään heikennetyksi ja omistajalle kerrotaan, mitä yhdistää. Jatkuvasti kaatuva tarkkailija käynnistetään uudelleen viiveellä, joka kaksinkertaistuu 300 sekuntiin asti ja nollautuu 30 sekunnin käyntiajan jälkeen.
{ "type": "watch", "plugin": "notes-sync", "command": "watch --notebook {{notebook}} --format ndjson" } command-kentän {{key}} täytetään omistajan vastauksilla työntekijän syötteisiin. Jos paikkamerkillä ei ole vastausta, seuranta ei käynnisty.
folder
{ "type": "folder", "path": "{{inbox_folder}}", "extensions": ["pdf"], "recursive": false } | Kenttä | Oletus | Merkitys |
|---|---|---|
path | pakollinen | Absoluuttinen kansiopolku. {{key}} täytetään syötteistä. |
extensions | kaikki tiedostot | Täsmättävät tiedostopäätteet ilman pistettä. |
recursive | true | Sisällytä alikansiot. |
debounce_secs | 2 | Tämän aikaikkunan sisällä tehdyt muutokset muodostavat yhden suorituksen. |
Suoritus saa muuttuneet polut kentässä _watch_payload.files.
manual
{ "type": "manual" } Manuaalinen työnkulku suoritetaan vain, kun omistaja käynnistää sen tai työntekijä kutsuu run_workflow-työkalua. Jokaisen työnkulun voi laukaisimesta riippumatta suorittaa myös tällä tavalla.
call
{"type": "call", "line": "..."} on sallittu vain työnkulussa, jonka tyyppi on "type": "call_tree" ja joka määrittää, miten työntekijä vastaa puhelinlinjaan. Tyhjä line koskee jokaista työntekijän vastaamaa linjaa, jolla ei ole tarkempaa puuta. Puhelupuussa on oltava täsmälleen yksi tervehdys ja vähintään yksi nimetty aikomus.
Webhookit
Omistaja voi myös luoda työntekijälle webhookin. Työnkulkuun sidottu webhook suorittaa kyseisen työnkulun; webhook ilman työnkulkua toimittaa hyötykuormansa työntekijän keskusteluun.