NeboAI
NeboAI
Aloita

Käynnistimet

Laukaisin päättää, milloin työnkulku suoritetaan. Nebossa on seitsemän laukaisintyyppiä. Kukin on objekti, jossa on type-kenttä ja kyseisen tyypin kentät.

TyyppiSuoritetaan, kun
scheduleCron-lauseke täsmää.
heartbeatAikaväli kuluu, halutessasi päivittäisen aikaikkunan sisällä.
eventLähetetään tapahtuma, jonka lähde täsmää.
watchLaajennuksen tarkkailija kirjoittaa tulosterivin.
folderKansion tiedostot muuttuvat.
manualOmistaja tai työntekijä käynnistää sen.
callPuhelinlinja 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äOletusMerkitys
pluginpakollinenKyky, kuten mail, tai laajennuksen slug. Nimeä kyky aina, kun sellainen sopii.
eventei mitäänTapahtuma laajennuksen events-listasta. Nebo käyttää kyseisen tapahtuman komentoa ja lähettää lisäksi jokaisen rivin muodossa <plugin>.<event>.
commandei mitäänArgumentit, jotka käynnistävät tarkkailijan. Käytetään, jos asetettu; muuten otetaan kentästä event.
restart_delay_secs5Odotusaika 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äOletusMerkitys
pathpakollinenAbsoluuttinen kansiopolku. {{key}} täytetään syötteistä.
extensionskaikki tiedostotTäsmättävät tiedostopäätteet ilman pistettä.
recursivetrueSisällytä alikansiot.
debounce_secs2Tä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.