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
| Kolom | Arti |
|---|---|
trigger | Wajib. Kapan alur kerja berjalan. Lihat Pemicu. |
description | Tujuan alur kerja. |
activities | Langkah-langkahnya. Lihat Aktivitas. |
connections | Sisi {from, to, label} yang menjadikan aktivitas sebagai graf. __trigger__ adalah awal dan __emit__ adalah akhir. |
emit | Event yang diumumkan alur kerja ini saat selesai: daftar, atau satu string yang dipisahkan koma. Lihat Event. |
inputs | Nilai 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. |
case | Menjadikan 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.
| Input | Ada saat |
|---|---|
_event_source, _event_payload, _event_origin | Pemicu event aktif. Payload berukuran 8 KB atau lebih dipersingkat menjadi kolom skalarnya, dengan header email dan referensi lampiran tetap dipertahankan. |
_watch_payload | Pemicu watch atau folder aktif. Satu baris output pemantau, atau {files} untuk folder. |
inputs | Selalu. 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.
| Kolom | Arti |
|---|---|
key | Wajib. Path bertitik yang dipisahkan koma ke dalam data pemicu yang mengidentifikasi subjek, seperti contactEmail,email,phone. |
type | Jenis kasus, seperti lead. Alur kerja dengan tipe yang sama berbagi kasus. Bawaannya nama alur kerja. |
default_wait | Berapa 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.maxIterationsmenentukan 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_budgetsebuah 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.