İçeriğe geç
AggregaAggrega
Dil seçin: Türkçe
Bu sayfa makine çevirisiyle çevrilmiştir. İngilizce orijinalini okuyun.

Bir Dify uygulamasını içe aktarma — Dify kurulumunda bir sohbet asistanı

Dify DSL’inde dışa aktarılmış bir Dify sohbet uygulaması, aggrega import ile bir Aggregate, bir Release ve bir Manifest olarak içe aktarılmış; bunlar, uygulamayı taşıyan standart kütüphane Dify kurulumunu yazıldıkları haliyle Kubernetes için derler.

Bir Dify uygulamasını içe aktarma bunu adım adım anlatır: komutu, yazdığı dosyaları, derlemeyi ve derlediği şeyin bir çalıştırmasını. Bu klasör, o adım adım anlatımın her aşamasını içerir:

klasöriçeriği
source/uygulama, support-assistant.yml; klasörü bir çalışma alanı yapan .aggrega-config.yaml; ve hiçbir uygulamanın tutamayacağı şeylerin yanıtları olan import-answers.yaml: kurulumun uygulama sırrını ve sahibin parolasını tutan Kubernetes Secret’larının adları ile sahip hesabının e-posta adresi
draft/aggrega import support-assistant.yml --target helm komutunun yazdığı dosyalar, değiştirilmemiş haliyle, ve komutun yazdırdıkları: standart çıktıya stdout.txt, standart hataya import.txt

source/support-assistant.yml bu örnek için, Dify’ın bir uygulamayı DSL sürümü 0.7.0 ile dışa aktardığı biçimde yazılmıştır.

Belge deposunun bir checkout’unda check.sh, içe aktarmayı yeniden çalıştırır, yazdıklarını ve yazdırdıklarını draft/ ile karşılaştırır, adım adım anlatımın alıntıladığı blokları bu dosyalarla karşılaştırır ve içe aktarmanın yazdıklarını doğrulayıp derler. Standart kütüphane kataloğunun (nereden edinilir) bu deponun yanında checkout edilmiş olmasına ya da dizininin AGGREGA_CATALOG_DIRS içinde belirtilmesine ihtiyaç duyar.

Örneği oluşturun

Bu örneğin içe aktarmasını aşağıdaki komutlarla çalıştırabilir ya da yapay zekâ asistanınıza sizin yerinize çalıştırtabilirsiniz.

Örneği, adını taşıyan yeni bir klasöre yazın:

Terminal window
aggrega scaffold --example import-dify

Ardından sırada çalıştırılacak komutları yazdırır. İlki yeni klasöre geçer:

Terminal window
cd import-dify

Derleme

İçe aktarma, Aggrega dosyalarını projenin yanında, source/ içinde taslak olarak oluşturur, hiçbir uygulamanın tutamayacağı şeyleri import-answers.yaml dosyasından alır ve derlemenin ihtiyaç duyduklarını çeker. Projeyi, çalışma alanının varsayılan kayıt defterinin imzalı bir anlık görüntü olarak yayımladığı standart kütüphane kataloğuyla karşılaştırır: ilk içe aktarma onu getirir, doğrular, çalışma alanının içerik önbelleğinde saklar ve taslakların yanına yazdığı kayıtta onu özetiyle (digest) adlandırır. Kendi katalog klasörlerini belirten bir çalışma alanı — AGGREGA_CATALOG_DIRS içinde ya da workspace.catalog_dirs altında — bunun yerine onlara göre içe aktarır:

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

Derlemenin manifestlerinin okuduğu Secret’ların oluşturulması ve bu manifestlerin çalıştırılması, yukarıda bağlantısı verilen adım adım anlatımdadır.

Bir yapay zekâ asistanıyla

Aggrega araçlarıyla kurulmuş bir yapay zekâ asistanı da aynısını yapabilir: bu istemi ona yapıştırın.

Yalnızca Aggrega araçlarını kullanın ve kendiniz hiçbir klasör oluşturmayın. Çalışma alanı klasöründe henüz bir `import-dify` klasörü yoksa `scaffold` aracını `example` değeri `import-dify` olacak şekilde ve `dir` olmadan bir kez çağırın: araç örneği yeni bir `import-dify` klasörüne yazar; bu klasörün içindeki `source` klasörü, bu örneğin içe aktardığı şeyleri içerir. Ardından `import` aracını `workspace_root` değeri `import-dify/source`, `source` değeri `support-assistant.yml` ve `target` değeri `helm` olacak şekilde çağırın: araç ihtiyaç duyduğu yanıtları `support-assistant.yml` dosyasının yanındaki `import-answers.yaml` dosyasından okur, taslaklarını `import-dify/source` içine yazar ve taslakların ihtiyaç duyduklarını çeker. Ardından `validate` aracını `workspace_root` değeri `import-dify/source` ve `release` değeri `release.yaml` olacak şekilde, `build` aracını da `workspace_root` değeri `import-dify/source`, `release` değeri `release.yaml` ve `write` değeri true olacak şekilde çağırın. Derlemenin hangi dosyaları yazdığını bana söyleyin; bunlar `import-dify/source/dist/` altındadır.

Test edin

--target compose ile içe aktarılıp kılavuzun Docker Compose üzerinde bölümünde gösterildiği gibi başlatıldığında kurulum bu makinede yanıt verir: API http://127.0.0.1:5001 adresinde, konsol ise http://127.0.0.1:3001/signin adresinde. Uygulama, kendi anahtarıyla gönderilen bir mesajı yanıtlar; bu anahtarı kılavuz oturum açtıktan, OpenAI sağlayıcısını taslak Release’teki marketplace_enabled değerinin kurulumun erişmesine izin verdiği Dify eklenti pazar yerinden kurduktan ve sağlayıcının anahtarını ayarladıktan sonra oluşturur:

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"}'

Çalıştırmanın sağlayıcı anahtarı bir yer tutucuydu; Dify bu anahtarı ayarlandığında OpenAI’ın Incorrect API key provided iletisiyle reddetti, bu nedenle mesaj şu yanıtı aldı:

{"code":"provider_not_initialize","message":"Model gpt-4o-mini credentials is not initialized.","status":400}

Yukarıdaki gibi Kubernetes için derlenip kılavuzun Çalıştırın bölümünün uyguladığı gibi uygulandığında, yerel bir port Service’ine yönlendirildiği anda API aynı adreste aynı isteklere yanıt verir; çalıştırma orada da aynı yanıtları aldı:

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