Mengimpor aplikasi Dify — asisten chat dalam instalasi Dify
Aplikasi chat Dify, yang diekspor dalam DSL Dify, diimpor oleh aggrega import menjadi sebuah Aggregate, sebuah Release, dan sebuah Manifest yang mem-build instalasi Dify dari pustaka standar yang membawanya, untuk Kubernetes sebagaimana tertulis.
Mengimpor aplikasi Dify membahasnya langkah demi langkah: perintahnya, berkas yang ditulisnya, build-nya, dan satu kali menjalankan hasil build-nya. Folder ini memuat setiap tahap dari panduan tersebut:
| folder | isinya |
|---|---|
source/ | aplikasinya, support-assistant.yml; .aggrega-config.yaml yang menjadikan folder ini ruang kerja; dan import-answers.yaml, jawaban atas apa yang tidak dapat dimuat aplikasi mana pun: nama Secret Kubernetes yang menyimpan rahasia aplikasi instalasi dan kata sandi pemilik, serta email akun pemilik |
draft/ | berkas yang ditulis oleh aggrega import support-assistant.yml --target helm, tanpa diubah, dan apa yang dicetaknya: stdout.txt pada keluaran standar, import.txt pada galat standar |
source/support-assistant.yml ditulis untuk contoh ini, dalam bentuk yang digunakan Dify saat mengekspor aplikasi pada DSL versi 0.7.0.
Dalam checkout repositori dokumentasi, check.sh menjalankan impor lagi, membandingkan apa yang ditulis dan dicetaknya dengan draft/, membandingkan blok yang dikutip panduan dengan berkas-berkas ini, serta memvalidasi dan mem-build apa yang ditulis oleh impor. Skrip ini memerlukan katalog pustaka standar (cara mendapatkannya) yang di-checkout di samping repositori ini, atau direktorinya disebutkan dalam AGGREGA_CATALOG_DIRS.
Membuat contoh
Anda dapat menjalankan impor contoh ini dengan perintah di bawah, atau meminta asisten AI Anda menjalankannya untuk Anda.
Tulis contoh ke folder baru yang dinamai sesuai contoh itu:
aggrega scaffold --example import-difyKemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:
cd import-difyBuild
Impor menyusun draf berkas Aggrega di samping proyek, di source/, mengambil dari import-answers.yaml apa yang tidak dapat dimuat aplikasi mana pun, dan menarik apa yang dibutuhkan build. Impor menimbang proyek terhadap katalog pustaka standar, yang diterbitkan registry default ruang kerja sebagai snapshot bertanda tangan: impor pertama mengambilnya, memverifikasinya, menyimpannya di cache konten ruang kerja, dan menamainya dengan digest-nya dalam catatan yang ditulisnya di samping draf. Ruang kerja yang menyebutkan folder katalognya sendiri — di AGGREGA_CATALOG_DIRS, atau di bawah workspace.catalog_dirs — mengimpor terhadap folder tersebut sebagai gantinya:
cd sourceaggrega import support-assistant.yml --target helmaggrega validate --release release.yamlaggrega build --release release.yamlPembuatan Secret yang dibaca manifest hasil build, dan cara menjalankannya, ada di panduan langkah demi langkah yang ditautkan di atas.
Dengan asisten AI
Asisten AI yang disiapkan dengan tool Aggrega dapat melakukan hal yang sama: tempelkan prompt ini ke asisten tersebut.
Gunakan hanya alat Aggrega, dan jangan membuat folder sendiri. Jika folder ruang kerja belum berisi folder `import-dify`, panggil alat `scaffold` sekali dengan `example` diatur ke `import-dify` dan tanpa `dir`: alat itu menulis contoh ke folder `import-dify` yang baru, dengan folder `source` di dalamnya yang berisi apa yang diimpor contoh ini. Lalu panggil alat `import` dengan `workspace_root` diatur ke `import-dify/source`, `source` diatur ke `support-assistant.yml`, dan `target` diatur ke `helm`: alat itu membaca jawaban yang dibutuhkannya dari `import-answers.yaml` di samping `support-assistant.yml`, menulis drafnya ke `import-dify/source`, dan menarik apa yang dibutuhkan draf tersebut. Lalu panggil alat `validate` dengan `workspace_root` diatur ke `import-dify/source` dan `release` diatur ke `release.yaml`, serta alat `build` dengan `workspace_root` diatur ke `import-dify/source`, `release` diatur ke `release.yaml`, dan `write` diatur ke true. Beri tahu saya berkas mana yang ditulis build; berkas tersebut berada di bawah `import-dify/source/dist/`.Mengujinya
Diimpor dengan --target compose dan dijalankan seperti yang ditunjukkan bagian Di Docker Compose dari panduan, instalasi menjawab di mesin ini: API di http://127.0.0.1:5001 dan konsol di http://127.0.0.1:3001/signin. Aplikasi menjawab pesan yang dikirim dengan kuncinya sendiri, yang dibuat oleh panduan setelah masuk, memasang penyedia OpenAI dari marketplace plugin Dify, yang dapat dijangkau instalasi berkat marketplace_enabled pada Release hasil draf, dan mengatur kunci penyedia:
curl -sS http://127.0.0.1:5001/v1/chat-messages \ -H 'Authorization: Bearer <app key>' -H 'Content-Type: application/json' \ -d '{"inputs": {}, "query": "In one short sentence: what does a support plan cover?", "response_mode": "blocking", "user": "test-it"}'Kunci penyedia pada eksekusi ini adalah placeholder, yang ditolak Dify dengan Incorrect API key provided dari OpenAI saat kunci itu diatur, sehingga pesan tersebut mendapat:
{"code":"provider_not_initialize","message":"Model gpt-4o-mini credentials is not initialized.","status":400}Dibangun seperti di atas, untuk Kubernetes, dan diterapkan seperti bagian Jalankan dari panduan menerapkannya, API menjawab permintaan yang sama di alamat yang sama setelah sebuah port lokal diteruskan ke Service-nya; eksekusi tersebut mendapat balasan yang sama di sana:
kubectl port-forward -n <namespace> svc/dify-zdapi-default 5001:5001