NeboAI
NeboAI
Mulai

Aktivitas

Aktivitas adalah satu langkah dalam alur kerja. Sebagian besar aktivitas dikerjakan oleh karyawan: Anda menyatakan maksudnya dan karyawan mengerjakannya dengan skill dan koneksinya. Enam tipe berjalan tanpa model, sehingga perutean dan waktunya tetap tepat.

Kolom

{
  "id": "draft-reply",
  "label": "Draft the reply",
  "intent": "Draft a reply to the customer message in _watch_payload using the reply-drafting skill.",
  "skills": ["reply-drafting"],
  "requires_tools": ["mail_message_send"],
  "on_error": { "retry": 1, "fallback": "notify_owner" }
}
KolomBawaanArti
idwajibUnik dalam alur kerja. Digunakan di connections dan path data.
typecustomLangkah karyawan, atau salah satu dari condition, loop, wait, http, command, decide.
intenttidak adaApa yang harus dicapai karyawan. Langkah karyawan membutuhkan intent atau steps.
steps[]Instruksi berurutan, jika satu kalimat tidak cukup.
labeltidak adaNama yang ditampilkan kepada pemilik.
skills[]Skill yang digunakan. Skill marketplace yang tercantum di sini diinstal bersama karyawan.
tools[]Jika diatur, satu-satunya alat yang boleh digunakan langkah ini.
requires_tools[]Alat yang harus berhasil agar langkah dianggap selesai.
cmds[]Perintah plugin yang disebut untuk langkah ini.
mcps[]Server MCP yang disebut untuk langkah ini.
modeltidak adaId model untuk langkah ini.
paramstidak adaParameter untuk aktivitas bertipe, dan maxIterations untuk langkah karyawan.
min_iterationstidak adaJumlah minimum giliran model sebelum langkah boleh selesai.
token_budgettidak ada{max}. Perkiraan.
on_error{retry: 1, fallback: notify_owner}Percobaan ulang, lalu cadangan. Kegagalan apa pun setelah percobaan ulang mengakhiri eksekusi.

Langkah karyawan

Langkah karyawan berjalan sebagai satu giliran karyawan: persona, memori, dan koneksinya berlaku, dan langkah ini dapat menggunakan hingga 50 giliran model, atau params.maxIterations. Hasil langkah sebelumnya diteruskan sebagai blok [Activity 'id' result]. Langkah yang mengakhiri alur kerja dengan daftar emit diberi tahu untuk memanggil emit_event dengan event tersebut. Alat exit selalu tersedia untuk mengakhiri eksekusi.

Konteks data

Aktivitas bertipe membaca nilai melalui path bertitik dari satu objek: inputs memuat input eksekusi, nodes.<id> memuat output setiap aktivitas yang sudah selesai (diurai sebagai JSON jika berupa JSON), dan item memuat item saat ini di dalam loop. Path tanpa awalan dicari di inputs, lalu di nodes.

condition

{ "id": "large", "type": "condition", "params": { "expression": "inputs.amount >= 500" } }

params.expression wajib. Koneksi keluarnya diberi label True dan False. params.mode menentukan cara membacanya:

ModeEkspresi
expressionBawaan. path op value dengan ==, !=, >=, <=, >, atau <, dibandingkan sebagai angka jika kedua sisi berupa angka; atau path saja, bernilai benar jika nilainya truthy.
existsSebuah path; bernilai benar jika menghasilkan nilai truthy.
containspath contains text, atau teks biasa yang dicocokkan dengan output sebelumnya.
regexPola yang dicocokkan dengan output sebelumnya.

loop

{ "id": "each-invoice", "type": "loop", "params": { "source": "nodes.fetch.invoices", "concurrency": 4 } }

params.source adalah path sebuah daftar. Koneksi berlabel Each item mengarah ke isi loop, yang berjalan sekali per item dengan item diatur; koneksi berlabel Done berjalan setelah semua item. Iterasi dimulai bersamaan kecuali Anda mengatur concurrency. maxIterations dan batchSize juga diterima.

"connections": [
  { "from": "__trigger__", "to": "fetch" },
  { "from": "fetch", "to": "each-invoice" },
  { "from": "each-invoice", "to": "check", "label": "Each item" },
  { "from": "each-invoice", "to": "report", "label": "Done" }
]

wait, http, dan command

{ "id": "pause", "type": "wait", "params": { "duration": "5m" } }
{ "id": "status", "type": "http", "params": { "url": "https://status.example.com/api", "method": "GET" } }
{ "id": "export", "type": "command", "params": { "command": "date -u" } }
TipeWajibPerilaku
waitparams.durationBerhenti sejenak selama rentang dalam s, m, atau h. Tidak ada tunggu-hingga; untuk melanjutkan saat ada event, picu alur kerja kedua dengan event tersebut.
httpparams.urlMengirim permintaan. method, headers, dan body bersifat opsional.
commandparams.commandMenjalankan perintah shell. Stdout-nya menjadi output aktivitas.

decide

Aktivitas decide mengajukan pertanyaan bertipe tentang pekerjaan sejauh ini dan mencatat jawaban terstruktur yang dapat digunakan condition untuk merutekan.

{
  "id": "triage",
  "type": "decide",
  "params": {
    "questions": {
      "urgency": { "type": "score", "instructions": "How urgent is this request?", "criteria": ["low", "normal", "high"] },
      "refund": { "type": "noul", "instructions": "The customer is asking for money back." }
    },
    "default": { "urgency": "normal", "refund": false }
  }
}
Tipe pertanyaancriteriaJawaban
choiceObjek pilihan ke deskripsi, 2 sampai 255 pilihan.choice, confidence, dan probabilities.
scoreDaftar 2 sampai 10 tingkat berurutan.score dari 0 (tingkat pertama) ke atas, dan confidence.
noulTidak ada.noul, probabilitas bahwa pernyataan itu benar.

Rutekan berdasarkan jawaban dengan condition, seperti nodes.triage.urgency.score >= 1.5. params.default memberikan jawaban aman untuk setiap pertanyaan jika tidak ada keputusan yang dapat diambil; jawaban bawaan memiliki confidence 0. Pertanyaan tanpa nilai bawaan tidak mendapat jawaban, sehingga condition terhadapnya mengambil sisi False.

Kesalahan

on_error.retry menetapkan berapa kali aktivitas yang gagal dicoba ulang; bawaannya 1. Setelah percobaan ulang terakhir, eksekusi berakhir, dan dengan fallback bawaan notify_owner, pemilik diberi tahu. Nebo memeriksa parameter wajib setiap aktivitas bertipe saat eksekusi dimulai, dan menolak cabang yang menunjuk ke aktivitas yang tidak dikenal.