Alur Kerja

Membaca otomatisasi workflow fasilitas: daftar workflow, graf lengkap satu workflow, jenis node yang dapat digunakan graf, dan template pilihan. Baca node_types sebelum membuat atau mengedit graf agar setiap jenis dan parameter valid di fasilitas.

Aksi:

• list: Mencantumkan workflow. Setiap workflow beserta status live, versi terbitan, jumlah eksekusi, eksekusi terakhir, dan node-nya (id, name, type). Workflow merek dan organisasi tidak dicantumkan.
• get: Mengambil workflow. Graf draf lengkap (node, koneksi, catatan, pengaturan) dan meta: active, publishedVersionId dan, setelah diterbitkan, publishedWorkflow, graf yang sedang live. Hanya workflow fasilitas ini. Memerlukan workflowId.
• node_types: Jenis node. Entri palet dengan type, label, category, outputs (cabang), dan inputSchema, yaitu parameter yang perlu diisi. available bernilai false, beserta alasannya, jika fasilitas tidak memiliki modul yang diperlukan node. Alat MCP muncul sebagai node mcp...
• templates: Template. Titik awal untuk otomatisasi umum, dengan risk dan riskNote (apa yang salah jika diterbitkan secara sembarangan), jenis node, modul yang diperlukan, ketersediaan di fasilitas ini, dan graf pratinjau. Ubah template menjadi graf dengan workflow_definitions_write instantiate_template.

Membuat, mengedit, menerbitkan, menghentikan, dan menghapus otomatisasi workflow fasilitas. Alur penyusunan: baca node_types dengan workflow_definitions_read, susun graf (atau mulai dari instantiate_template), buat sebagai draf, coba dengan workflow_runs_write test (disimulasikan), lalu terbitkan. Pengeditan draf tidak pernah mengubah versi live hingga draf diterbitkan.

Aksi:

• create: Membuat workflow. Menyimpan draf baru yang tidak aktif dari graf lengkap dengan setidaknya satu node; name default-nya "Untitled workflow". Masalah validasi dikembalikan dalam errors beserta detail node. Memerlukan nodes.
• update: Menyimpan draf. Mengganti seluruh draf: kirim setiap node dan koneksi, bukan hanya perubahannya. Versi live tetap berjalan hingga Anda menerbitkan. Masalah validasi dikembalikan dalam errors beserta detail node. Memerlukan workflowId, nodes.
• patch_meta: Mengganti nama. Hanya mengubah nama atau deskripsi; graf dan versi live tetap seperti semula. changed bernilai false jika keduanya sudah sesuai. Memerlukan workflowId.
• duplicate: Menduplikasi. Menyalin workflow ke draf baru bernama " (copy)" dengan id node baru, tidak pernah diterbitkan atau aktif. Workflow asli tidak tersentuh. Memerlukan workflowId.
• delete: Menghapus. Menghapus workflow secara permanen: draf, versi terbitan, riwayat eksekusi, dan perutean pemicu. set_active false menghentikannya tetapi tetap menyimpannya; discard_draft hanya mengatur ulang pengeditan draf. Memerlukan workflowId. Meminta konfirmasi.
• discard_draft: Membuang pengeditan draf. Mengatur ulang draf ke versi terbitan terakhir, membuang pengeditan sejak saat itu. Versi live tidak pernah terpengaruh; memerlukan versi terbitan. Memerlukan workflowId. Meminta konfirmasi.
• publish: Menerbitkan. Memvalidasi draf, menyimpannya sebagai versi live, dan mengaktifkan workflow, sehingga pemicunya berjalan dan aksinya dijalankan secara nyata. Eksekusi yang sedang berlangsung selesai pada versi lama. Jika langkah Delay yang sedang menunggu akan dijadwalkan ulang, hasilnya memiliki kode WAIT_RETARGET_CONFIRMATION_REQUIRED dan impacts: panggil lagi dengan confirmWaitRetargets dan impacts tersebut. Memerlukan workflowId. Meminta konfirmasi.
• set_active: Mengaktifkan atau menonaktifkan. active true mengaktifkan kembali workflow yang telah diterbitkan. active false menghentikannya: pemicu berhenti berjalan dan langkah Delay yang tertunda dibatalkan sehingga tidak pernah selesai. Tidak ada yang dihapus. Meminta konfirmasi terlebih dahulu kecuali sudah dalam status tersebut. Memerlukan workflowId, active. Dapat meminta konfirmasi.
• instantiate_template: Graf dari template. Mengubah template menjadi graf yang siap untuk create: { name, description, nodes, connections } dengan id node baru. Template sengaja mengosongkan penerima, pintu, dan waktu; isi terlebih dahulu. Tidak menyimpan apa pun. Memerlukan templateId.
• generate: Menghasilkan graf. Menyusun graf dari prompt dalam bahasa sederhana dengan AI fasilitas dan mengembalikan { name, description, nodes, connections } yang hanya menggunakan jenis node yang valid. Kirim workflow untuk merevisi workflow yang ada; graf hasil revisi lengkap akan dikembalikan. Tidak menyimpan apa pun, tetapi menggunakan kredit AI fasilitas. Memerlukan prompt. Meminta konfirmasi.

Riwayat eksekusi workflow, terbaru lebih dulu, dan satu eksekusi langkah demi langkah. Gunakan untuk memeriksa apakah otomatisasi telah berjalan, mengikuti eksekusi yang dimulai dengan workflow_runs_write, atau menemukan node mana yang gagal dan mengapa.

Aksi:

• list: Mencantumkan eksekusi. Setiap eksekusi beserta status, mode (live atau test), efek samping, pemicu, siapa yang memulainya, waktu, jumlah langkah, node yang sedang ditunggu, dan kesalahan apa pun. Memerlukan workflowId.
• get: Mengambil eksekusi. Status eksekusi ditambah setiap langkah secara berurutan, dengan input, output, catatan, dan kesalahan setiap node. Eksekusi bersifat asinkron: eksekusi dengan Delay menunggu hingga kelanjutannya jatuh tempo. Memerlukan workflowId, executionId.

Memulai, menguji, membatalkan, dan memutar ulang eksekusi workflow. Utamakan test, yang menjalankan draf dengan efek samping yang disimulasikan; run mengeksekusi workflow terbitan secara nyata. Eksekusi bersifat asinkron: ikuti dengan workflow_runs_read get.

Aksi:

• run: Jalankan sekarang. Menjalankan workflow terbitan dari pemicu manualnya (custom.manualTrigger), dengan efek samping nyata. Pemicu terjadwal, webhook, dan peristiwa berjalan dengan sendirinya. Mengembalikan executionId eksekusi dan status pertamanya. Memerlukan workflowId. Meminta konfirmasi.
• test: Menguji draf. Menjalankan draf yang tersimpan tanpa menerbitkannya, dicatat sebagai eksekusi uji. Efek samping disimulasikan secara default: tidak ada yang dikirim atau dialihkan, dan setiap node melaporkan apa yang akan dilakukannya. sideEffects live meminta konfirmasi terlebih dahulu. Memerlukan workflowId. Dapat meminta konfirmasi.
• cancel: Membatalkan eksekusi yang menunggu. Membatalkan eksekusi yang sedang menunggu Delay: penantian yang tertunda ditutup dan langkah setelahnya tidak pernah dijalankan. Eksekusi yang sudah selesai dan eksekusi yang sedang di tengah langkah tidak dapat dibatalkan. Memerlukan workflowId, executionId. Meminta konfirmasi.
• retry: Memutar ulang eksekusi. Memutar ulang eksekusi yang sudah selesai dari input pemicu yang tercatat, ditautkan kembali melalui retryOf. published (default) menjalankan ulang versi yang digunakannya, secara nyata, dan meminta konfirmasi terlebih dahulu; draft-test menjalankan draf saat ini secara simulasi, pilihan yang tepat saat memperbaiki kegagalan. Memerlukan workflowId, executionId. Dapat meminta konfirmasi.