NeboAI
NeboAI
Mulai

Workflow

Alur kerja adalah pekerjaan yang dilakukan karyawan tanpa diminta: ringkasan pagi, balasan untuk setiap pesan baru, laporan mingguan. Setiap alur kerja memasangkan pemicu dengan aktivitas yang dijalankan karyawan. Alur kerja disimpan di agent.json milik karyawan, sehingga ikut terbawa bersama perannya.

Alur kerja pertama

Tambahkan peta workflows ke agent.json. Setiap kunci menamai satu alur kerja; setiap nilai memiliki pemicu dan aktivitas.

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

Alur kerja ini berjalan pukul 08.00 pada hari kerja, menurut waktu lokal bot. Karyawan menjalankan aktivitasnya dengan persona, skill, dan koneksinya sendiri.

Kolom alur kerja

KolomArti
triggerWajib. Kapan alur kerja berjalan. Lihat Pemicu.
descriptionTujuan alur kerja.
activitiesLangkah-langkahnya. Lihat Aktivitas.
connectionsSisi {from, to, label} yang menjadikan aktivitas sebagai graf. __trigger__ adalah awal dan __emit__ adalah akhir.
emitEvent yang diumumkan alur kerja ini saat selesai: daftar, atau satu string yang dipisahkan koma. Lihat Event.
inputsNilai yang diteruskan ke setiap eksekusi.
budget{total_per_run, cost_estimate}. Dalam eksekusi graf, total_per_run membatasi token output; selain itu keduanya hanya perkiraan.
caseMenjadikan alur kerja satu kasus jangka panjang per orang atau hal. Lihat Kasus.

Alur kerja dengan pemicu tanpa aktivitas tetap valid. Watch tanpa aktivitas hanya meneruskan event-nya ke alur kerja lain.

Cara eksekusi berjalan

Tanpa connections, aktivitas berjalan berurutan dan karyawan mengerjakan masing-masing. Hasil setiap aktivitas diteruskan ke aktivitas berikutnya. Aktivitas tanpa output mengakhiri eksekusi.

Dengan connections, aktivitas membentuk graf. Cabang berjalan paralel, dan enam tipe aktivitas berjalan tanpa model: condition, loop, wait, http, command, dan decide. Gunakan graf jika perutean harus 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 sebuah eksekusi

Karyawan selalu memiliki personanya dan jawaban pemilik atas pertanyaan inputs-nya. Eksekusi juga menerima nilai-nilai ini, bergantung pada pemicunya.

InputAda saat
_event_source, _event_payload, _event_originPemicu event aktif. Payload berukuran 8 KB atau lebih dipersingkat menjadi kolom skalarnya, dengan header email dan referensi lampiran tetap dipertahankan.
_watch_payloadPemicu watch atau folder aktif. Satu baris output pemantau, atau {files} untuk folder.
inputsSelalu. Nilai inputs milik alur kerja itu sendiri.

Kasus

Sebagian pekerjaan berlangsung berhari-hari: prospek yang perlu ditindaklanjuti, permintaan yang menunggu dokumen. Tambahkan case dan alur kerja menyimpan satu kasus terbuka per orang atau hal, alih-alih memulai dari awal setiap kali.

KolomArti
keyWajib. Path bertitik yang dipisahkan koma ke dalam data pemicu yang mengidentifikasi subjek, seperti contactEmail,email,phone.
typeJenis kasus, seperti lead. Alur kerja dengan tipe yang sama berbagi kasus. Bawaannya nama alur kerja.
default_waitBerapa lama menunggu jika suatu giliran tidak menyebut waktu tunggu: 3d, 12h, 45m. Bawaan tiga hari.

Setiap giliran dalam kasus harus diakhiri dengan satu objek JSON tanpa apa pun setelahnya. result adalah status bisnis; next memberi tahu mesin untuk wait atau close. Tenggat ditulis dalam RFC 3339 atau rentang relatif. Selain itu, giliran dianggap tidak valid.

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

Batasan dan pemulihan

  • Setiap aktivitas dapat menggunakan hingga 50 giliran model, kecuali params.maxIterations menentukan lain.
  • Dalam graf, satu aktivitas dapat berjalan paling banyak 10.000 kali dalam satu eksekusi.
  • Batas pengeluaran yang ditetapkan pemilik untuk karyawan menghentikan eksekusi saat tercapai. token_budget sebuah aktivitas hanyalah perkiraan.
  • Eksekusi yang terputus karena restart ditandai terputus dan dilanjutkan satu kali.
  • Karyawan dapat mengakhiri eksekusi lebih awal dengan alat exit.

Jalankan dan kelola alur kerja

Pemilik dapat menjalankan alur kerja apa pun secara manual. Karyawan mengelola alur kerja dengan run_workflow, workflow_status, list_workflow_runs, set_workflow_enabled, dan alat alur kerja lainnya yang tercantum di Pembantu dan Tim.