Aliran kerja pertama
Tambah peta workflows pada agent.json. Setiap kunci menamakan aliran kerja; setiap nilai mempunyai pencetus dan aktiviti.
{
"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." }
]
}
}
} Aliran kerja ini berjalan pada pukul 08:00 pada hari bekerja, mengikut waktu tempatan bot. Pekerja melaksanakan aktiviti dengan persona, kemahiran dan sambungannya sendiri.
Medan aliran kerja
| Medan | Maksud |
|---|---|
trigger | Wajib. Bila aliran kerja berjalan. Lihat Pencetus. |
description | Tujuan aliran kerja. |
activities | Langkah-langkah. Lihat Aktiviti. |
connections | Tepi {from, to, label} yang menjadikan aktiviti sebuah graf. __trigger__ ialah permulaan dan __emit__ penghujung. |
emit | Peristiwa yang diumumkan oleh aliran kerja ini apabila selesai: senarai, atau satu rentetan yang dipisahkan koma. Lihat Peristiwa. |
inputs | Nilai yang dihantar kepada setiap larian. |
budget | {total_per_run, cost_estimate}. Dalam larian graf, total_per_run mengehadkan token output; selain itu kedua-duanya ialah anggaran. |
case | Menjadikan aliran kerja satu kes jangka panjang bagi setiap orang atau perkara. Lihat Kes. |
Aliran kerja dengan pencetus dan tanpa aktiviti adalah sah. Pemerhatian tanpa aktiviti hanya menyampaikan peristiwanya kepada aliran kerja lain.
Cara larian dilaksanakan
Tanpa connections, aktiviti berjalan mengikut urutan dan pekerja melaksanakan setiap satu. Hasil setiap aktiviti dihantar kepada yang seterusnya. Aktiviti tanpa output menamatkan larian.
Dengan connections, aktiviti membentuk graf. Cabang berjalan secara selari, dan enam jenis aktiviti berjalan tanpa model: condition, loop, wait, http, command dan decide. Gunakan graf apabila penghalaan mesti 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 oleh larian
Pekerja sentiasa mempunyai personanya dan jawapan pemilik kepada soalan inputs-nya. Larian juga menerima nilai ini, bergantung pada pencetusnya.
| Input | Ada apabila |
|---|---|
_event_source, _event_payload, _event_origin | Pencetus peristiwa dicetuskan. Muatan bersaiz 8 KB atau lebih dipendekkan kepada medan skalarnya, dengan pengepala e-mel dan rujukan lampiran dikekalkan. |
_watch_payload | Pencetus pemerhatian atau folder dicetuskan. Satu baris output pemerhati, atau {files} untuk folder. |
inputs | Sentiasa. Nilai inputs aliran kerja itu sendiri. |
Kes
Sesetengah kerja berlarutan beberapa hari: prospek yang memerlukan susulan, permintaan yang menunggu dokumen. Tambah case dan aliran kerja mengekalkan satu kes terbuka bagi setiap orang atau perkara dan bukannya bermula semula setiap kali.
| Medan | Maksud |
|---|---|
key | Wajib. Laluan bertitik yang dipisahkan koma ke dalam data pencetus yang mengenal pasti subjek, seperti contactEmail,email,phone. |
type | Jenis kes, seperti lead. Aliran kerja dengan jenis yang sama berkongsi kes. Lalai kepada nama aliran kerja. |
default_wait | Berapa lama untuk menunggu apabila sesuatu giliran tidak menyatakan tempoh menunggu: 3d, 12h, 45m. Lalai tiga hari. |
Setiap giliran kes mesti berakhir dengan satu objek JSON dan tiada apa-apa selepasnya. result ialah keadaan perniagaan; next memberitahu enjin untuk wait atau close. Tarikh akhir ialah RFC 3339 atau tempoh relatif. Selain itu ialah giliran yang tidak sah.
{"result": {"status": "awaiting_documents", "summary": "Requested two bank statements"},
"next": {"action": "wait", "on": "signal", "deadline": "3d", "reason": "documents"}} Had dan pemulihan
- Setiap aktiviti boleh mengambil sehingga 50 giliran model, kecuali
params.maxIterationsmenyatakan sebaliknya. - Dalam graf, satu aktiviti boleh berjalan paling banyak 10,000 kali dalam satu larian.
- Had perbelanjaan pemilik untuk pekerja menghentikan larian apabila dicapai.
token_budgetaktiviti ialah anggaran. - Larian yang terganggu oleh mula semula ditandakan sebagai terganggu dan disambung semula sekali.
- Pekerja boleh menamatkan larian lebih awal dengan alat
exit.
Jalankan dan urus aliran kerja
Pemilik boleh menjalankan mana-mana aliran kerja secara manual. Pekerja mengurus aliran kerja dengan run_workflow, workflow_status, list_workflow_runs, set_workflow_enabled dan alat aliran kerja lain yang disenaraikan di Pembantu dan Pasukan.