NeboAI
NeboAI
Başlayın

Tetikleyiciler

Tetikleyici, bir iş akışının ne zaman çalışacağına karar verir. Nebo’da yedi tetikleyici türü vardır. Her biri bir type alanı ve o türe ait alanları olan bir nesnedir.

TürNe zaman çalışır
scheduleBir cron ifadesi eşleştiğinde.
heartbeatİsteğe bağlı olarak günlük bir zaman aralığı içinde, bir süre geçtiğinde.
eventKaynağı eşleşen bir olay yayıldığında.
watchBir eklenti izleyicisi bir çıktı satırı yazdığında.
folderBir klasördeki dosyalar değiştiğinde.
manualSahip veya bir çalışan onu çalıştırdığında.
callBir telefon hattı çaldığında. Yalnızca telefon çağrı ağaçlarında.

schedule

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

cron beş alanlı bir cron ifadesidir: dakika, saat, ayın günü, ay, haftanın günü. schedule, insanlar için isteğe bağlı bir açıklamadır. Zamanlamalar botun yerel saat diliminde çalışır. Nebo zamanlamaları beş saniyede bir denetler. Bot kapalıyken kaçırılan bir tetiklenme, bir saatten az gecikmişse bir kez telafi edilir. Önceki çalıştırma hâlâ sürüyorsa tetiklenme atlanır.

heartbeat

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

interval, 30m, 1h veya 2h30m gibi bir süredir. window (HH:MM-HH:MM), tetiklenmeleri çalışma saatleri içinde tutar. Sonraki tetiklenme, son tetiklenmeye aralığın eklenip zaman penceresine kaydırılmasıyla bulunur; ilki, iş akışı yüklendikten bir aralık sonradır. Zamanlayıcılar yeniden başlatmalardan sonra da korunur. Önceki çalıştırma hâlâ sürüyorsa tetiklenme atlanır ve geçersiz bir aralık hiç tetiklenmez.

event

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

sources, tam olarak ya da sondaki bir .* joker karakteriyle eşleşecek olay adlarını listeler. Boş bir liste, tüm agent.json dosyasını reddeden bir hatadır. Çalıştırma _event_source, _event_payload ve _event_origin değerlerini alır. Adların nasıl oluştuğu için bkz. Olaylar.

watch

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

Bir izleme, bir eklenti sürecini çalışır durumda tutar ve yazdığı her satır için bir çalıştırma başlatır. Her satır _watch_payload olarak gelir. On dakika içindeki aynı satırlar atılır.

AlanVarsayılanAnlamı
pluginzorunlumail gibi bir yetenek ya da bir eklenti slug’ı. Uygun bir yetenek varsa her zaman onu adlandırın.
eventyokEklentinin events listesinden bir olay. Nebo o olayın komutunu kullanır ve ayrıca her satırı <plugin>.<event> olarak yayar.
commandyokİzleyiciyi başlatan argümanlar. Ayarlıysa kullanılır; değilse event içinden alınır.
restart_delay_secs5Çıkış yapan bir izleyiciyi yeniden başlatmadan önce bekleme süresi.

Bir yetenek, onu sağlayan kurulu eklentiye çözümlenir; bu çalışanın hesabı olan eklenti tercih edilir. Böyle bir eklenti yoksa iş akışı kısıtlı olarak işaretlenir ve sahibe neyi bağlaması gerektiği söylenir. Sürekli çöken bir izleyici, 300 saniyeye kadar ikiye katlanan bir gecikmeyle yeniden başlar ve 30 saniye kesintisiz çalıştıktan sonra bu gecikme sıfırlanır.

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

command içindeki {{key}}, sahibin çalışanın girdilerine verdiği yanıtlarla doldurulur. Bir yer tutucunun yanıtı yoksa izleme başlamaz.

folder

{ "type": "folder", "path": "{{inbox_folder}}", "extensions": ["pdf"], "recursive": false }
AlanVarsayılanAnlamı
pathzorunluMutlak klasör yolu. {{key}} girdilerden doldurulur.
extensionstüm dosyalarEşleştirilecek dosya uzantıları, nokta olmadan.
recursivetrueAlt klasörleri dahil et.
debounce_secs2Bu zaman aralığındaki değişiklikler tek bir çalıştırma olur.

Çalıştırma, değişen yolları _watch_payload.files içinde alır.

manual

{ "type": "manual" }

Manuel bir iş akışı yalnızca sahip onu çalıştırdığında veya bir çalışan run_workflow çağırdığında çalışır. Tetikleyicisi ne olursa olsun her iş akışı bu şekilde de çalıştırılabilir.

call

{"type": "call", "line": "..."} yalnızca "type": "call_tree" türündeki bir iş akışında geçerlidir; bu iş akışı, bir çalışanın bir telefon hattını nasıl yanıtlayacağını yapılandırır. Boş bir line, çalışanın yanıtladığı ve daha özel bir ağacı olmayan her hatta uygulanır. Bir arama ağacında tam olarak bir karşılama ve en az bir adlandırılmış amaç bulunmalıdır.

Webhook’lar

Sahip bir çalışan için webhook da oluşturabilir. Bir iş akışına bağlı webhook o iş akışını çalıştırır; iş akışı olmayan bir webhook yükünü çalışanın sohbetine iletir.