Menjadwalkan alur kerja Dify melalui XXL-JOB -

Alur kerja Dify memerlukan penjadwalan untuk mengimplementasikan tugas otomatis dalam berbagai skenario, seperti pemantauan risiko, analitik data, pembuatan konten, sinkronisasi data, dan skenario aplikasi khas lainnya. Namun, Dify tidak mendukung fungsi penjadwalan secara native. Topik ini menjelaskan cara mengintegrasikan penjadwal tugas terdistribusi XXL-JOB untuk menjadwalkan aplikasi alur kerja dan memantau statusnya guna memastikan operasi alur kerja yang stabil.

Fitur inti penjadwalan XXL-JOB

Fitur	Ikhtisar
Dukungan tugas	Mendukung penjadwalan alur kerja Dify yang dibuat sendiri di Internet serta alur kerja Dify yang dibuat sendiri di lingkungan jaringan internal Alibaba Cloud.
Konfigurasi waktu fleksibel	Mendukung berbagai jenis waktu: `cron`, `fixed_rate`, `fixed_delay`, `one_time`, dan penjadwalan API, dengan presisi waktu hingga detik. Mendukung pengaturan zona waktu dan kalender kustom untuk memenuhi kebutuhan bisnis global.
Peringatan dan pemantauan tingkat perusahaan	Mengintegrasikan manajemen kontak dan grup kontak CloudMonitor untuk memberikan dukungan peringatan komprehensif tingkat perusahaan. Kebijakan peringatan fleksibel: Tingkat tugas: peringatan kegagalan, peringatan waktu habis, dan notifikasi keberhasilan. Tingkat instans dan aplikasi: peringatan ambang batas. Notifikasi pesan multi-saluran: mendukung berbagai metode notifikasi seperti pesan teks, panggilan telepon, Webhook, dan email.
Kemampuan observabilitas dan dasbor penjadwalan	Menyediakan dasbor penjadwalan tingkat perusahaan yang menampilkan informasi penjadwalan pada tingkat instans dan aplikasi, termasuk kurva metrik utama seperti tren penjadwalan, tingkat keberhasilan, dan tingkat kegagalan.
Riwayat eksekusi dan pelacakan event	Riwayat eksekusi: mencatat detail eksekusi setiap alur kerja Dify, termasuk status, informasi dasar, parameter masukan dan keluaran, konsumsi waktu, serta konsumsi token. Event penjadwalan: mencatat event yang terkait dengan setiap penjadwalan, mencakup informasi event pada tingkat alur kerja dan node. Pelacakan node: pencatatan rinci operasi semua node dalam eksekusi alur kerja, mendukung analisis drill-down mendalam untuk loop, iterasi, dan cabang kondisional.

Ikhtisar solusi

Mengonfigurasi XXL-JOB untuk menjadwalkan aplikasi alur kerja Dify hanya memerlukan tiga langkah:

Buat lingkungan Dify: Buat kluster ACK, instal komponen ack-dify di kluster tersebut, akses layanan Dify, lalu buat aplikasi alur kerja.
Buat dan konfigurasi instans penjadwalan: Buat instans penjadwalan XXL-JOB, buat aplikasi dalam instans tersebut untuk mengelompokkan dan mengelola tugas, lalu konfigurasi parameter tugas agar terhubung ke aplikasi alur kerja Dify.
Uji integrasi: Verifikasi bahwa fungsi penjadwalan terdistribusi beroperasi secara normal dan lihat detail penjadwalan setelah penjadwalan berhasil.

1. Buat lingkungan Dify

① Menerapkan lingkungan Dify

Deploy lingkungan Dify dengan satu klik untuk menyelesaikan operasi seperti menginstal komponen ack-dify dan mengaktifkan akses Internet untuk layanan Dify.

Catatan

Akses Internet digunakan untuk keperluan demonstrasi. Jika Anda melakukan deployment di lingkungan produksi, demi keamanan data aplikasi Anda, kami menyarankan agar Anda mengaktifkan fitur Resource Access Management.

Jika Anda menggunakan kluster ACK untuk pertama kali dan belum terbiasa dengan proses pembuatan kluster, Anda dapat mengklik Deployment satu klik untuk membuat lingkungan runtime yang diperlukan bagi layanan Dify. Solusi ini menggunakan templat aplikasi ack-dify dari pasar ACK untuk mendeploy aplikasi Dify secara cepat melalui Helm dengan biaya rendah, memenuhi kebutuhan pengembangan dan pengujian.

Penting

Sebelum menggunakan deployment satu klik, kami menyarankan agar Anda memeriksa apakah Anda telah mengaktifkan dan memberikan otorisasi kluster Container Service ACK. Untuk informasi selengkapnya, lihat Pembuatan cepat kluster ACK yang dikelola.

Klik Deployment satu klik, di Resource Orchestration Service pilih wilayah Anda (opsional) Tiongkok (Hangzhou), lalu sesuai dengan templat ROS pilih Zone kluster Anda, Instance Specification, Instance Password, Security Confirmation, dan informasi penting lainnya. Biarkan informasi lainnya tetap sebagai default. Setelah pengaturan selesai, klik Create.
Karena kluster memerlukan banyak sumber daya, Anda perlu bersabar menunggu sekitar 10 menit hingga selesai. Setelah kluster dibuat, masuk ke Konsol Container Service. Di panel navigasi sebelah kiri, klik Clusters. Klik nama kluster target untuk membuka halaman detail kluster, lalu klik Beban Kerja > Pod. Namespace-nya adalah dify-system. Verifikasi apakah sumber daya Ack-dify Component telah terinstal dengan benar di kluster target.
(Opsional) Jika Anda menemukan pod dalam status Pending, kemungkinan karena kluster yang ada kekurangan dependensi PVC untuk ack-dify. Buat sistem file CNFS default dan StorageClass NAS yang sesuai untuk kluster tersebut. Untuk informasi selengkapnya, lihat Mengelola sistem file NAS menggunakan CNFS (direkomendasikan). Untuk informasi lebih lanjut tentang pemecahan masalah pengecualian pod, lihat Memecahkan masalah pengecualian pod.

Setelah Ack-dify Component terinstal, Anda dapat melanjutkan ke langkah berikutnya.

② Lihat alamat IP Eksternal

Setelah konfigurasi selesai, klik Layanan > Layanan > ack-dify. Namespace-nya adalah dify-system. Anda akan melihat External IP Address layanan ack-dify. Masukkan alamat IP Eksternal ini di bilah alamat browser Anda untuk mengakses layanan Dify.

③ Daftar untuk layanan Dify

Akses External IP Address dan ikuti petunjuk di halaman untuk Set Up An Administrator Account (alamat email, nama pengguna, dan kata sandi) guna mendaftar ke platform Dify dan menggunakan layanan tersebut.

④ Buat aplikasi alur kerja Dify

Untuk pengujian penjadwalan selanjutnya, Anda perlu membuat contoh alur kerja Dify yang sederhana. Anda dapat mengimpor file yang disediakan dify-flow.yml ke Dify untuk membangun aplikasi alur kerja secara cepat dan menyelesaikan publikasi pembaruan.

Penting

Penjadwalan alur kerja Dify melalui XXL-JOB hanya mendukung aplikasi alur kerja Dify. Aplikasi jenis chat saat ini belum didukung.

2. Buat dan konfigurasi instans penjadwalan

① Buat instans Masuk ke Konsol XXL-JOB, pilih wilayah di bilah menu atas, lalu klik Create Instance. Versi mesin harus ≥ 2.2.0. Region: Harus konsisten dengan wilayah lingkungan kluster Dify. Instance Name: Dify-demo. VPC: Harus konsisten dengan VPC lingkungan kluster Dify.
② Buat aplikasi Sebelum menggunakan tugas XXL-JOB, Anda perlu membuat aplikasi terlebih dahulu. Pembuatan aplikasi bertujuan untuk pengelompokan dan pengelolaan tugas secara logis. Setiap aplikasi dapat dipandang sebagai unit eksekusi tugas independen, sehingga memudahkan peninjauan, konfigurasi, dan penjadwalan tugas secara seragam nanti. Di halaman instans XXL-JOB, temukan instans target dan klik Task Management di kolom Tindakan. Di panel navigasi sebelah kiri, pilih Application Management, lalu klik Create Application. AppName: Misalnya, Dify-AppName. Name: Misalnya, Dify-AppName. AccessToken: Dihasilkan secara otomatis oleh sistem.
③ Buat tugas Tugas adalah unit penjadwalan untuk logika bisnis tertentu. Setelah aplikasi dibuat, aplikasi tersebut perlu diikat ke pelaksana tugas. Pelaksana mendaftar ke aplikasi melalui AppName, lalu mengeksekusi tugas di bawah aplikasi tersebut. Catatan Jika Anda tidak membuat aplikasi terlebih dahulu, pelaksana tidak dapat mendaftar dengan benar, sehingga menyebabkan tugas gagal dijadwalkan dan dieksekusi secara normal. Task Name: Dify-test. Associated Application: Aplikasi yang telah dibuat, misalnya Dify-AppName. Task Type: Alur kerja Dify. Lainnya: Biarkan sebagai default.
④ Konfigurasi parameter tugas Setelah aplikasi alur kerja Dify dipublikasikan dan diperbarui, pilih Access API untuk melihat parameter tugas yang diperlukan. Endpoint: Server API alur kerja Dify. API Key: Kunci API alur kerja Dify. Setiap alur kerja memiliki kunci yang berbeda. Input: Input alur kerja dalam format JSON. `{"input_text": "what is your name"}`

3. Uji integrasi

① Jalankan tugas uji coba

Untuk memverifikasi bahwa fungsi penjadwalan terdistribusi dapat beroperasi secara normal, Anda perlu menguji penjadwalan tugas. Anda dapat memilih Task Management, lalu klik Run Once untuk menguji tugas terjadwal.

② Lihat detail penjadwalan

Pilih Execution List, klik Details untuk melihat detail tugas penjadwalan. Anda dapat melihat bahwa tugas penjadwalan uji coba telah berhasil dan melihat detailnya.

③ Informasi detail

Klik Details untuk melihat Informasi Dasar.
Klik Details untuk melihat Input dan Output.
Klik Details untuk melihat Pelacakan Node.
Catatan
Untuk struktur seperti iterator dan cabang loop, Anda dapat melihat informasi atau data node yang lebih rinci.

Penafian

Dify di ACK adalah solusi deployment Helm yang menyesuaikan proyek open source Dify untuk lingkungan ACK Alibaba Cloud, memungkinkan deployment cepat. ACK tidak menjamin operasi aplikasi Dify itu sendiri atau kompatibilitasnya dengan komponen ekosistem lainnya, seperti plugin dan database. ACK tidak memberikan kompensasi atau layanan komersial lainnya atas kerugian bisnis yang disebabkan oleh cacat pada Dify atau komponen ekosistemnya. Kami menyarankan agar Anda mengikuti pembaruan dari komunitas open source dan secara proaktif memperbaiki masalah pada perangkat lunak open source untuk memastikan stabilitas dan keamanan deployment Dify Anda.