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" }
} | Kolom | Bawaan | Arti |
|---|---|---|
id | wajib | Unik dalam alur kerja. Digunakan di connections dan path data. |
type | custom | Langkah karyawan, atau salah satu dari condition, loop, wait, http, command, decide. |
intent | tidak ada | Apa yang harus dicapai karyawan. Langkah karyawan membutuhkan intent atau steps. |
steps | [] | Instruksi berurutan, jika satu kalimat tidak cukup. |
label | tidak ada | Nama 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. |
model | tidak ada | Id model untuk langkah ini. |
params | tidak ada | Parameter untuk aktivitas bertipe, dan maxIterations untuk langkah karyawan. |
min_iterations | tidak ada | Jumlah minimum giliran model sebelum langkah boleh selesai. |
token_budget | tidak 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:
| Mode | Ekspresi |
|---|---|
expression | Bawaan. path op value dengan ==, !=, >=, <=, >, atau <, dibandingkan sebagai angka jika kedua sisi berupa angka; atau path saja, bernilai benar jika nilainya truthy. |
exists | Sebuah path; bernilai benar jika menghasilkan nilai truthy. |
contains | path contains text, atau teks biasa yang dicocokkan dengan output sebelumnya. |
regex | Pola 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" } } | Tipe | Wajib | Perilaku |
|---|---|---|
wait | params.duration | Berhenti sejenak selama rentang dalam s, m, atau h. Tidak ada tunggu-hingga; untuk melanjutkan saat ada event, picu alur kerja kedua dengan event tersebut. |
http | params.url | Mengirim permintaan. method, headers, dan body bersifat opsional. |
command | params.command | Menjalankan 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 pertanyaan | criteria | Jawaban |
|---|---|---|
choice | Objek pilihan ke deskripsi, 2 sampai 255 pilihan. | choice, confidence, dan probabilities. |
score | Daftar 2 sampai 10 tingkat berurutan. | score dari 0 (tingkat pertama) ke atas, dan confidence. |
noul | Tidak 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.