Przejdź do głównej zawartości
AggregaAggrega
Wybierz język: Polski
Ta strona została przetłumaczona maszynowo. Przeczytaj oryginał w języku angielskim.

Import aplikacji Dify — asystent czatu w instalacji Dify

Aplikacja czatu Dify, wyeksportowana w DSL Dify, zaimportowana przez aggrega import do encji Aggregate, Release i Manifest, które kompilują zawierającą ją instalację Dify z biblioteki standardowej dla Kubernetes, w postaci, w jakiej zostały zapisane.

Import aplikacji Dify omawia to krok po kroku: polecenie, pliki, które zapisuje, kompilację i uruchomienie tego, co kompiluje. Ten folder zawiera każdy etap tego przewodnika:

folderzawartość
source/aplikacja, support-assistant.yml; .aggrega-config.yaml, który czyni folder obszarem roboczym; oraz import-answers.yaml, odpowiedzi na to, czego żadna aplikacja nie może zawierać: nazwy obiektów Secret Kubernetes przechowujących sekret aplikacji instalacji i hasło właściciela oraz adres e-mail konta właściciela
draft/pliki zapisane przez aggrega import support-assistant.yml --target helm, bez zmian, oraz to, co polecenie wypisało: stdout.txt na standardowe wyjście, import.txt na standardowe wyjście błędów

source/support-assistant.yml jest napisany na potrzeby tego przykładu, w postaci, w jakiej Dify eksportuje aplikację w wersji DSL 0.7.0.

W kopii repozytorium dokumentacji check.sh ponownie uruchamia import, porównuje to, co zapisuje i wypisuje, z draft/, porównuje bloki cytowane w przewodniku z tymi plikami oraz waliduje i kompiluje to, co zapisał import. Wymaga katalogu biblioteki standardowej (skąd go pobrać) pobranego obok tego repozytorium albo jego folderu wskazanego w AGGREGA_CATALOG_DIRS.

Generowanie przykładu

Import tego przykładu można uruchomić poleceniami poniżej albo zlecić jego uruchomienie swojemu asystentowi AI.

Należy zapisać przykład w nowym folderze nazwanym tak jak on:

Terminal window
aggrega scaffold --example import-dify

Następnie wypisuje polecenia do uruchomienia w dalszej kolejności. Pierwsze przechodzi do nowego folderu:

Terminal window
cd import-dify

Kompilacja

Import tworzy szkice plików Aggrega obok projektu, w source/, odczytuje z import-answers.yaml to, czego żadna aplikacja nie może zawierać, i pobiera to, czego potrzebuje kompilacja. Porównuje projekt z katalogiem biblioteki standardowej, który domyślny rejestr obszaru roboczego publikuje jako podpisaną migawkę: pierwszy import go pobiera, weryfikuje, przechowuje w pamięci podręcznej treści obszaru roboczego i wskazuje go po jego skrócie (digest) w zapisie, który tworzy obok szkiców. Obszar roboczy, który wskazuje własne foldery katalogu — w AGGREGA_CATALOG_DIRS lub pod workspace.catalog_dirs — importuje zamiast tego względem nich:

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

Tworzenie obiektów Secret odczytywanych przez manifesty builda oraz ich uruchamianie opisano w przewodniku krok po kroku podlinkowanym powyżej.

Z asystentem AI

Asystent AI skonfigurowany z narzędziami Aggrega może zrobić to samo: wystarczy wkleić mu ten prompt.

Używaj wyłącznie narzędzi Aggrega i nie twórz samodzielnie żadnego folderu. Jeśli folder obszaru roboczego nie zawiera jeszcze folderu `import-dify`, wywołaj raz narzędzie `scaffold` z `example` ustawionym na `import-dify` i bez `dir`: zapisze ono przykład w nowym folderze `import-dify`, którego folder `source` zawiera to, co importuje ten przykład. Następnie wywołaj narzędzie `import` z `workspace_root` ustawionym na `import-dify/source`, `source` ustawionym na `support-assistant.yml` i `target` ustawionym na `helm`: odczytuje ono potrzebne odpowiedzi z `import-answers.yaml` obok `support-assistant.yml`, zapisuje swoje szkice w `import-dify/source` i pobiera to, czego one potrzebują. Następnie wywołaj narzędzie `validate` z `workspace_root` ustawionym na `import-dify/source` i `release` ustawionym na `release.yaml` oraz narzędzie `build` z `workspace_root` ustawionym na `import-dify/source`, `release` ustawionym na `release.yaml` i `write` ustawionym na true. Powiedz mi, które pliki zapisała kompilacja; znajdują się w `import-dify/source/dist/`.

Testowanie

Po zaimportowaniu z --target compose i uruchomieniu tak, jak pokazuje sekcja W Docker Compose przewodnika, instalacja odpowiada na tej maszynie: API pod http://127.0.0.1:5001, a konsola pod http://127.0.0.1:3001/signin. Aplikacja odpowiada na wiadomość wysłaną z jej własnym kluczem, który przewodnik tworzy po zalogowaniu się, zainstalowaniu dostawcy OpenAI z marketplace wtyczek Dify, do którego marketplace_enabled ze szkicu encji Release daje instalacji dostęp, i ustawieniu klucza dostawcy:

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

Klucz dostawcy użyty w przebiegu był symbolem zastępczym, który Dify odrzucił przy ustawianiu komunikatem OpenAI Incorrect API key provided, więc wiadomość otrzymała:

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

Po zbudowaniu jak wyżej, dla Kubernetes, i zastosowaniu tak, jak stosuje je sekcja Uruchom przewodnika, API odpowiada na te same żądania pod tym samym adresem, gdy tylko lokalny port zostanie przekierowany do jego Service; przebieg otrzymał tam te same odpowiedzi:

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