NeboAI
NeboAI
Loslegen

Auslöser

Ein Trigger bestimmt, wann ein Workflow läuft. Nebo hat sieben Trigger-Typen. Jeder ist ein Objekt mit einem Feld type und den Feldern für diesen Typ.

TypLäuft, wenn
scheduleEin Cron-Ausdruck zutrifft.
heartbeatEin Intervall verstreicht, optional innerhalb eines täglichen Zeitfensters.
eventEin Event mit passender Quelle ausgegeben wird.
watchEin Plugin-Watcher eine Ausgabezeile schreibt.
folderSich Dateien in einem Ordner ändern.
manualDer Inhaber oder ein Mitarbeiter ihn startet.
callEine Telefonleitung klingelt. Nur in Anrufbäumen.

schedule

{ "type": "schedule", "cron": "0 8 * * 1-5", "schedule": "Weekdays at 8:00" }

cron ist ein Cron-Ausdruck mit fünf Feldern: Minute, Stunde, Tag des Monats, Monat, Wochentag. schedule ist eine optionale Beschreibung für Menschen. Zeitpläne laufen in der lokalen Zeitzone des Bots. Nebo prüft Zeitpläne alle fünf Sekunden. Ein Auslösen, das verpasst wurde, während der Bot aus war, wird einmal nachgeholt, wenn es weniger als eine Stunde zu spät ist. Ein Auslösen wird übersprungen, solange der vorherige Lauf noch andauert.

heartbeat

{ "type": "heartbeat", "interval": "30m", "window": "08:00-18:00" }

interval ist eine Zeitspanne wie 30m, 1h oder 2h30m. window, HH:MM-HH:MM, hält das Auslösen innerhalb der Arbeitszeiten. Das nächste Auslösen ist das letzte plus das Intervall, verschoben ins Zeitfenster; das erste erfolgt ein Intervall nach dem Laden des Workflows. Timer überstehen Neustarts. Ein Auslösen wird übersprungen, solange der vorherige Lauf noch andauert, und ein ungültiges Intervall löst nie aus.

event

{ "type": "event", "sources": ["support-coordinator.summary.ready", "assignment.*"] }

sources listet Event-Namen auf, die exakt oder mit einem abschließenden Platzhalter .* passen. Eine leere Liste ist ein Fehler, der die ganze agent.json ablehnt. Der Lauf erhält _event_source, _event_payload und _event_origin. Unter Events steht, wie Namen gebildet werden.

watch

{ "type": "watch", "plugin": "mail", "event": "email.new" }

Ein Watch hält einen Plugin-Prozess am Laufen und startet für jede Zeile, die er schreibt, einen Lauf. Jede Zeile kommt als _watch_payload an. Identische Zeilen innerhalb von zehn Minuten werden verworfen.

FeldStandardBedeutung
pluginerforderlichEine Fähigkeit, etwa mail, oder ein Plugin-Slug. Nenne eine Fähigkeit, wann immer eine passt.
eventkeinerEin Event aus der events-Liste des Plugins. Nebo nutzt den Befehl dieses Events und gibt außerdem jede Zeile als <plugin>.<event> aus.
commandkeinerArgumente, die den Watcher starten. Werden verwendet, wenn gesetzt; andernfalls aus event übernommen.
restart_delay_secs5Wartezeit vor dem Neustart eines Watchers, der sich beendet.

Eine Fähigkeit wird zum installierten Plugin aufgelöst, das sie bereitstellt, bevorzugt eines, bei dem dieser Mitarbeiter ein Konto hat. Gibt es kein solches Plugin, wird der Workflow als eingeschränkt markiert und der Inhaber erfährt, was er verbinden muss. Ein Watcher, der immer wieder abstürzt, startet mit einer Verzögerung neu, die sich bis auf 300 Sekunden verdoppelt und nach 30 Sekunden Laufzeit zurückgesetzt wird.

{ "type": "watch", "plugin": "notes-sync", "command": "watch --notebook {{notebook}} --format ndjson" }

{{key}} in command wird aus den Antworten des Inhabers auf die Inputs des Mitarbeiters gefüllt. Hat ein Platzhalter keine Antwort, startet der Watch nicht.

folder

{ "type": "folder", "path": "{{inbox_folder}}", "extensions": ["pdf"], "recursive": false }
FeldStandardBedeutung
patherforderlichAbsoluter Ordnerpfad. {{key}} wird aus den Eingaben gefüllt.
extensionsalle DateienPassende Dateiendungen, ohne Punkt.
recursivetrueUnterordner einbeziehen.
debounce_secs2Änderungen innerhalb dieses Zeitfensters werden zu einem Lauf.

Der Lauf erhält die geänderten Pfade in _watch_payload.files.

manual

{ "type": "manual" }

Ein manueller Workflow läuft nur, wenn der Inhaber ihn startet oder ein Mitarbeiter run_workflow aufruft. Jeder Workflow lässt sich, unabhängig von seinem Trigger, auch auf diese Weise starten.

call

{"type": "call", "line": "..."} ist nur in einem Workflow vom Typ "type": "call_tree" gültig, der festlegt, wie ein Mitarbeiter eine Telefonleitung beantwortet. Eine leere line gilt für jede Leitung, die der Mitarbeiter beantwortet und für die es keinen spezifischeren Baum gibt. Ein Anrufbaum muss genau eine Begrüßung und mindestens einen benannten Intent haben.

Webhooks

Der Inhaber kann auch einen Webhook für einen Mitarbeiter anlegen. Ein Webhook, der an einen Workflow gebunden ist, startet diesen Workflow; einer ohne Workflow liefert seine Payload in den Chat des Mitarbeiters.