Lewati ke konten
AggregaAggrega
Pilih Bahasa: Bahasa Indonesia
Halaman ini diterjemahkan oleh mesin. Baca versi asli dalam bahasa Inggris.

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:

folderisinya
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:

Terminal window
aggrega scaffold --example import-dify

Kemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:

Terminal window
cd import-dify

Build

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:

Terminal window
cd source
aggrega import support-assistant.yml --target helm
aggrega validate --release release.yaml
aggrega build --release release.yaml

Pembuatan 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:

Terminal window
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:

Terminal window
kubectl port-forward -n <namespace> svc/dify-zdapi-default 5001:5001