NeboAI
NeboAI
Mulakan

Aliran Kerja

Aliran kerja ialah kerja yang dilakukan pekerja tanpa diminta: ringkasan pagi, balasan kepada setiap mesej baharu, laporan mingguan. Setiap aliran kerja menggandingkan pencetus dengan aktiviti yang dilaksanakan oleh pekerja. Aliran kerja disimpan dalam agent.json pekerja, jadi ia bergerak bersama peranan itu.

Aliran kerja pertama

Tambah peta workflows pada agent.json. Setiap kunci menamakan aliran kerja; setiap nilai mempunyai pencetus dan aktiviti.

{
  "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." }
      ]
    }
  }
}

Aliran kerja ini berjalan pada pukul 08:00 pada hari bekerja, mengikut waktu tempatan bot. Pekerja melaksanakan aktiviti dengan persona, kemahiran dan sambungannya sendiri.

Medan aliran kerja

MedanMaksud
triggerWajib. Bila aliran kerja berjalan. Lihat Pencetus.
descriptionTujuan aliran kerja.
activitiesLangkah-langkah. Lihat Aktiviti.
connectionsTepi {from, to, label} yang menjadikan aktiviti sebuah graf. __trigger__ ialah permulaan dan __emit__ penghujung.
emitPeristiwa yang diumumkan oleh aliran kerja ini apabila selesai: senarai, atau satu rentetan yang dipisahkan koma. Lihat Peristiwa.
inputsNilai yang dihantar kepada setiap larian.
budget{total_per_run, cost_estimate}. Dalam larian graf, total_per_run mengehadkan token output; selain itu kedua-duanya ialah anggaran.
caseMenjadikan aliran kerja satu kes jangka panjang bagi setiap orang atau perkara. Lihat Kes.

Aliran kerja dengan pencetus dan tanpa aktiviti adalah sah. Pemerhatian tanpa aktiviti hanya menyampaikan peristiwanya kepada aliran kerja lain.

Cara larian dilaksanakan

Tanpa connections, aktiviti berjalan mengikut urutan dan pekerja melaksanakan setiap satu. Hasil setiap aktiviti dihantar kepada yang seterusnya. Aktiviti tanpa output menamatkan larian.

Dengan connections, aktiviti membentuk graf. Cabang berjalan secara selari, dan enam jenis aktiviti berjalan tanpa model: condition, loop, wait, http, command dan decide. Gunakan graf apabila penghalaan mesti tepat.

{
  "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"]
}

Apa yang diterima oleh larian

Pekerja sentiasa mempunyai personanya dan jawapan pemilik kepada soalan inputs-nya. Larian juga menerima nilai ini, bergantung pada pencetusnya.

InputAda apabila
_event_source, _event_payload, _event_originPencetus peristiwa dicetuskan. Muatan bersaiz 8 KB atau lebih dipendekkan kepada medan skalarnya, dengan pengepala e-mel dan rujukan lampiran dikekalkan.
_watch_payloadPencetus pemerhatian atau folder dicetuskan. Satu baris output pemerhati, atau {files} untuk folder.
inputsSentiasa. Nilai inputs aliran kerja itu sendiri.

Kes

Sesetengah kerja berlarutan beberapa hari: prospek yang memerlukan susulan, permintaan yang menunggu dokumen. Tambah case dan aliran kerja mengekalkan satu kes terbuka bagi setiap orang atau perkara dan bukannya bermula semula setiap kali.

MedanMaksud
keyWajib. Laluan bertitik yang dipisahkan koma ke dalam data pencetus yang mengenal pasti subjek, seperti contactEmail,email,phone.
typeJenis kes, seperti lead. Aliran kerja dengan jenis yang sama berkongsi kes. Lalai kepada nama aliran kerja.
default_waitBerapa lama untuk menunggu apabila sesuatu giliran tidak menyatakan tempoh menunggu: 3d, 12h, 45m. Lalai tiga hari.

Setiap giliran kes mesti berakhir dengan satu objek JSON dan tiada apa-apa selepasnya. result ialah keadaan perniagaan; next memberitahu enjin untuk wait atau close. Tarikh akhir ialah RFC 3339 atau tempoh relatif. Selain itu ialah giliran yang tidak sah.

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

Had dan pemulihan

  • Setiap aktiviti boleh mengambil sehingga 50 giliran model, kecuali params.maxIterations menyatakan sebaliknya.
  • Dalam graf, satu aktiviti boleh berjalan paling banyak 10,000 kali dalam satu larian.
  • Had perbelanjaan pemilik untuk pekerja menghentikan larian apabila dicapai. token_budget aktiviti ialah anggaran.
  • Larian yang terganggu oleh mula semula ditandakan sebagai terganggu dan disambung semula sekali.
  • Pekerja boleh menamatkan larian lebih awal dengan alat exit.

Jalankan dan urus aliran kerja

Pemilik boleh menjalankan mana-mana aliran kerja secara manual. Pekerja mengurus aliran kerja dengan run_workflow, workflow_status, list_workflow_runs, set_workflow_enabled dan alat aliran kerja lain yang disenaraikan di Pembantu dan Pasukan.