NeboAI
NeboAI
Başlayın

İş akışları

İş akışı, bir çalışanın kendisinden istenmeden yaptığı iştir: bir sabah özeti, her yeni iletiye bir yanıt, haftalık bir rapor. Her iş akışı bir tetikleyiciyi çalışanın yürüttüğü etkinliklerle eşleştirir. İş akışları çalışanın agent.json dosyasında bulunur; böylece rolle birlikte taşınır.

İlk iş akışı

agent.json dosyasına bir workflows eşlemesi ekleyin. Her anahtar bir iş akışına ad verir; her değerin bir tetikleyicisi ve etkinlikleri vardır.

{
  "workflows": {
    "morning-summary": {
      "trigger": { "type": "schedule", "cron": "0 8 * * 1-5" },
      "description": "Summarize yesterday's open conversations every weekday morning.",
      "activities": [
        { "id": "summarize", "intent": "Summarize yesterday's open customer conversations and what each one is waiting on." }
      ]
    }
  }
}

Bu iş akışı, botun yerel saatiyle hafta içi her gün 08:00’de çalışır. Çalışan etkinliği kendi kişiliği, becerileri ve bağlantılarıyla yürütür.

İş akışı alanları

AlanAnlamı
triggerZorunlu. İş akışının ne zaman çalıştığı. Bkz. Tetikleyiciler.
descriptionİş akışının amacı.
activitiesAdımlar. Bkz. Etkinlikler.
connectionsEtkinlikleri bir grafiğe dönüştüren {from, to, label} kenarları. __trigger__ başlangıç, __emit__ ise bitiştir.
emitBu iş akışının bittiğinde duyurduğu olaylar: bir liste veya virgülle ayrılmış tek bir dize. Bkz. Olaylar.
inputsHer çalıştırmaya geçirilen değerler.
budget{total_per_run, cost_estimate}. Grafik çalıştırmasında total_per_run çıktı belirteçlerini sınırlar; diğer durumlarda ikisi de tahmindir.
caseİş akışını kişi veya şey başına uzun süreli tek bir vaka hâline getirir. Bkz. Vakalar.

Tetikleyicisi olup etkinliği olmayan bir iş akışı geçerlidir. Etkinliği olmayan bir izleme, olaylarını yalnızca diğer iş akışlarına aktarır.

Bir çalıştırma nasıl yürür

connections olmadan etkinlikler sırayla çalışır ve her birini çalışan gerçekleştirir. Her etkinliğin sonucu bir sonrakine geçirilir. Çıktısı olmayan bir etkinlik çalıştırmayı sonlandırır.

connections ile etkinlikler bir grafik oluşturur. Dallar paralel çalışır ve altı etkinlik türü model olmadan çalışır: condition, loop, wait, http, command ve decide. Yönlendirmenin kesin olması gerektiğinde bir grafik kullanın.

{
  "trigger": { "type": "watch", "plugin": "mail", "event": "email.new" },
  "activities": [
    { "id": "classify", "type": "decide",
      "params": {
        "questions": {
          "kind": {
            "type": "choice",
            "instructions": "What kind of message is this?",
            "criteria": { "invoice": "A bill from a vendor", "other": "Anything else" }
          }
        },
        "default": { "kind": "other" }
      } },
    { "id": "is-invoice", "type": "condition", "params": { "expression": "nodes.classify.kind.choice == invoice" } },
    { "id": "record", "intent": "Record the invoice in _watch_payload as a bill and note the due date." }
  ],
  "connections": [
    { "from": "__trigger__", "to": "classify" },
    { "from": "classify", "to": "is-invoice" },
    { "from": "is-invoice", "to": "record", "label": "True" },
    { "from": "record", "to": "__emit__" }
  ],
  "emit": ["invoice.recorded"]
}

Bir çalıştırma neler alır

Çalışanın her zaman kişiliği ve sahibin inputs sorularına verdiği yanıtlar vardır. Bir çalıştırma, tetikleyicisine bağlı olarak şu değerleri de alır.

GirdiNe zaman bulunur
_event_source, _event_payload, _event_originBir olay tetikleyicisi tetiklendiğinde. 8 KB veya daha büyük yükler, e-posta üst bilgileri ve ek başvuruları korunarak skaler alanlarına kısaltılır.
_watch_payloadBir izleme veya klasör tetikleyicisi tetiklendiğinde. İzleyicinin çıktısından bir satır ya da klasör için {files}.
inputsHer zaman. İş akışının kendi inputs değerleri.

Vakalar

Bazı işler günlere yayılır: takip gerektiren bir potansiyel müşteri, belge bekleyen bir talep. case ekleyin; iş akışı her seferinde baştan başlamak yerine kişi veya şey başına bir açık vaka tutar.

AlanAnlamı
keyZorunlu. Tetikleyici verisinde konuyu tanımlayan, virgülle ayrılmış noktalı yollar; örneğin contactEmail,email,phone.
typelead gibi vaka türü. Aynı türdeki iş akışları vakaları paylaşır. Varsayılan olarak iş akışının adıdır.
default_waitBir tur bekleme süresi belirtmediğinde ne kadar bekleneceği: 3d, 12h, 45m. Varsayılan üç gündür.

Bir vakanın her turu tek bir JSON nesnesiyle bitmeli ve ardından hiçbir şey gelmemelidir. result iş durumudur; next motora wait veya close yapmasını söyler. Son tarih RFC 3339 biçiminde ya da göreli bir süredir. Bunun dışındaki her şey geçersiz bir turdur.

{"result": {"status": "awaiting_documents", "summary": "Requested two bank statements"},
 "next":   {"action": "wait", "on": "signal", "deadline": "3d", "reason": "documents"}}

Sınırlar ve kurtarma

  • params.maxIterations aksini belirtmedikçe her etkinlik en fazla 50 model turu sürebilir.
  • Bir grafikte bir etkinlik, bir çalıştırmada en fazla 10.000 kez çalışabilir.
  • Sahibin çalışan için belirlediği harcama sınırına ulaşıldığında çalıştırma durur. Bir etkinliğin token_budget değeri bir tahmindir.
  • Yeniden başlatma nedeniyle kesilen bir çalıştırma kesildi olarak işaretlenir ve bir kez sürdürülür.
  • Çalışan, exit aracıyla bir çalıştırmayı erken bitirebilir.

İş akışlarını çalıştırın ve yönetin

Sahip herhangi bir iş akışını elle çalıştırabilir. Çalışanlar iş akışlarını run_workflow, workflow_status, list_workflow_runs, set_workflow_enabled ve Yardımcılar ve Ekipler sayfasında listelenen diğer iş akışı araçlarıyla yönetir.