NeboAI
NeboAI
Mulakan

Aktiviti

Aktiviti ialah satu langkah dalam aliran kerja. Kebanyakan aktiviti dilaksanakan oleh pekerja: anda menyatakan niat dan ia melakukan kerja dengan kemahiran dan sambungannya. Enam jenis berjalan tanpa model, jadi penghalaan dan pemasaan kekal tepat.

Medan

{
  "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" }
}
MedanLalaiMaksud
idwajibUnik dalam aliran kerja. Digunakan dalam connections dan laluan data.
typecustomLangkah pekerja, atau salah satu daripada condition, loop, wait, http, command, decide.
intenttiadaApa yang perlu dicapai oleh pekerja. Langkah pekerja memerlukan intent atau steps.
steps[]Arahan tersusun, apabila satu ayat tidak mencukupi.
labeltiadaNama yang dipaparkan kepada pemilik.
skills[]Kemahiran untuk digunakan. Kemahiran pasaran yang disenaraikan di sini dipasang bersama pekerja.
tools[]Apabila ditetapkan, satu-satunya alat yang boleh digunakan oleh langkah.
requires_tools[]Alat yang mesti berjaya supaya langkah dikira selesai.
cmds[]Arahan plugin yang dinamakan untuk langkah ini.
mcps[]Pelayan MCP yang dinamakan untuk langkah ini.
modeltiadaId model untuk langkah ini.
paramstiadaParameter untuk aktiviti bertaip, dan maxIterations untuk langkah pekerja.
min_iterationstiadaGiliran model minimum sebelum langkah boleh selesai.
token_budgettiada{max}. Satu anggaran.
on_error{retry: 1, fallback: notify_owner}Cuba semula, kemudian sandaran. Sebarang kegagalan selepas cubaan semula menamatkan larian.

Langkah pekerja

Langkah pekerja berjalan sebagai satu giliran pekerja: persona, memori dan sambungannya terpakai, dan ia boleh menggunakan sehingga 50 giliran model, atau params.maxIterations. Hasil langkah terdahulu dihantar masuk sebagai blok [Activity 'id' result]. Langkah yang menamatkan aliran kerja dengan senarai emit diberitahu untuk memanggil emit_event dengan peristiwa tersebut. Alat exit sentiasa tersedia untuk menamatkan larian.

Konteks data

Aktiviti bertaip membaca nilai mengikut laluan bertitik daripada satu objek: inputs mengandungi input larian, nodes.<id> mengandungi output setiap aktiviti yang telah selesai (dihuraikan sebagai JSON apabila ia JSON), dan item mengandungi item semasa di dalam gelung. Laluan tanpa awalan mencari dalam inputs, kemudian nodes.

condition

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

params.expression adalah wajib. Sambungan keluarnya dilabelkan True dan False. params.mode memilih cara ia dibaca:

ModUngkapan
expressionLalai. path op value dengan ==, !=, >=, <=, > atau <, dibandingkan sebagai nombor apabila kedua-dua belah ialah nombor; atau laluan tanpa operator, benar apabila nilainya dianggap benar.
existsSatu laluan; benar apabila ia menghasilkan nilai yang dianggap benar.
containspath contains text, atau teks biasa yang dipadankan dengan output sebelumnya.
regexCorak yang dipadankan dengan output sebelumnya.

loop

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

params.source ialah laluan sesuatu senarai. Sambungan berlabel Each item menuju ke badan, yang berjalan sekali bagi setiap item dengan item ditetapkan; yang berlabel Done berjalan selepas semua item. Lelaran bermula serentak kecuali anda menetapkan 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" } }
JenisWajibKelakuan
waitparams.durationBerhenti seketika untuk tempoh dalam s, m atau h. Tiada tunggu-sehingga; untuk menyambung semula pada sesuatu peristiwa, cetuskan aliran kerja kedua padanya.
httpparams.urlMembuat permintaan. method, headers dan body adalah pilihan.
commandparams.commandMenjalankan arahan shell. Stdout-nya ialah output aktiviti.

decide

Aktiviti decide bertanya soalan bertaip tentang kerja setakat ini dan merekodkan jawapan berstruktur yang boleh digunakan oleh condition untuk menghalakan.

{
  "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 }
  }
}
Jenis soalancriteriaJawapan
choiceObjek pilihan kepada perihalan, 2 hingga 255 pilihan.choice, confidence dan probabilities.
scoreSenarai 2 hingga 10 tahap tersusun.score dari 0 (tahap pertama) ke atas, dan confidence.
noulTiada.noul, kebarangkalian kenyataan itu benar.

Halakan berdasarkan jawapan dengan condition, seperti nodes.triage.urgency.score >= 1.5. params.default memberikan jawapan selamat bagi setiap soalan apabila tiada keputusan dapat dibuat; jawapan lalai mempunyai keyakinan 0. Soalan tanpa nilai lalai tidak mendapat jawapan, jadi condition padanya mengambil tepi False.

Ralat

on_error.retry menetapkan berapa kali aktiviti yang gagal dicuba semula; lalainya ialah 1. Selepas cubaan semula terakhir larian tamat, dan dengan fallback lalai iaitu notify_owner, pemilik dimaklumkan. Nebo menyemak parameter wajib setiap aktiviti bertaip apabila larian bermula, dan menolak cabang yang menunjuk kepada aktiviti yang tidak dikenali.