Aller au contenu
AggregaAggrega
Selectionner la langue: Français
Cette page a été traduite automatiquement. Lire l’original en anglais.

Importer une application Dify — un assistant de chat dans l’installation Dify

Une application de chat Dify, exportée dans le DSL de Dify, importée par aggrega import dans un Aggregate, une Release et un Manifest qui compilent l’installation Dify de la bibliothèque standard qui la porte, pour Kubernetes, tels qu’ils sont écrits.

Importer une application Dify le présente pas à pas : la commande, les fichiers qu’elle écrit, la compilation et une exécution de ce qu’elle compile. Ce dossier contient chaque étape de ce tutoriel :

dossierce qu’il contient
source/l’application, support-assistant.yml ; le .aggrega-config.yaml qui fait du dossier un espace de travail ; et import-answers.yaml, les réponses à ce qu’aucune application ne peut contenir : les noms des Secrets Kubernetes qui contiennent le secret applicatif de l’installation et le mot de passe du propriétaire, et l’adresse e-mail du compte propriétaire
draft/les fichiers que aggrega import support-assistant.yml --target helm a écrits, inchangés, et ce qu’il a affiché : stdout.txt sur la sortie standard, import.txt sur la sortie d’erreur standard

source/support-assistant.yml est écrit pour cet exemple, dans la forme sous laquelle Dify exporte une application en version DSL 0.7.0.

Dans un checkout du dépôt de la documentation, check.sh exécute à nouveau l’import, compare ce qu’il écrit et affiche avec draft/, compare les blocs que le tutoriel cite avec ces fichiers, et valide et compile ce que l’import a écrit. Il nécessite le catalogue de la bibliothèque standard (où en obtenir un) extrait à côté de ce dépôt, ou son répertoire indiqué dans AGGREGA_CATALOG_DIRS.

Générer l’exemple

Vous pouvez exécuter l’import de cet exemple avec les commandes ci-dessous, ou le faire exécuter par votre assistant IA.

Écrivez l’exemple dans un nouveau dossier qui porte son nom :

Terminal window
aggrega scaffold --example import-dify

Elle affiche ensuite les prochaines commandes à exécuter. La première vous place dans le nouveau dossier :

Terminal window
cd import-dify

Build

L’import rédige les brouillons des fichiers Aggrega à côté du projet, dans source/, prend dans import-answers.yaml ce qu’aucune application ne peut contenir, et récupère ce dont la compilation a besoin. Il confronte le projet au catalogue de la bibliothèque standard, que le registre par défaut de l’espace de travail publie sous forme d’instantané signé : le premier import le récupère, le vérifie, le conserve dans le cache de contenu de l’espace de travail et le désigne par son digest dans l’enregistrement qu’il écrit à côté des brouillons. Un espace de travail qui désigne ses propres dossiers de catalogue — dans AGGREGA_CATALOG_DIRS, ou sous workspace.catalog_dirs — importe plutôt par rapport à ceux-ci :

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

La création des Secrets que lisent les manifestes du build, et leur exécution, figurent dans le guide pas à pas lié ci-dessus.

Avec un assistant IA

Un assistant IA configuré avec les outils d’Aggrega peut faire de même : collez-lui ce prompt.

Utilisez uniquement les outils Aggrega et ne créez vous-même aucun dossier. Si le dossier de l’espace de travail ne contient pas encore de dossier `import-dify`, appelez une fois l’outil `scaffold` avec `example` défini à `import-dify` et sans `dir` : il écrit l’exemple dans un nouveau dossier `import-dify`, dont le dossier `source` contient ce que cet exemple importe. Appelez ensuite l’outil `import` avec `workspace_root` défini à `import-dify/source`, `source` défini à `support-assistant.yml` et `target` défini à `helm` : il lit les réponses dont il a besoin dans `import-answers.yaml`, à côté de `support-assistant.yml`, écrit ses brouillons dans `import-dify/source` et récupère ce dont ils ont besoin. Appelez ensuite l’outil `validate` avec `workspace_root` défini à `import-dify/source` et `release` défini à `release.yaml`, puis l’outil `build` avec `workspace_root` défini à `import-dify/source`, `release` défini à `release.yaml` et `write` défini à true. Indiquez-moi quels fichiers le build a écrits ; ils se trouvent sous `import-dify/source/dist/`.

Tester

Importée avec --target compose et démarrée comme le montre la section Sur Docker Compose du guide, l’installation répond sur cette machine : l’API à http://127.0.0.1:5001 et la console à http://127.0.0.1:3001/signin. L’application répond à un message envoyé avec sa propre clé, que le guide crée après la connexion, l’installation du fournisseur OpenAI depuis la marketplace de plugins de Dify, que le marketplace_enabled de la Release ébauchée permet à l’installation d’atteindre, et la définition de la clé du fournisseur :

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

La clé de fournisseur de l’exécution était un espace réservé, que Dify a refusé avec le message Incorrect API key provided d’OpenAI lorsqu’elle a été définie ; le message a donc reçu :

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

Construite comme ci-dessus, pour Kubernetes, et appliquée comme l’applique la section L’exécuter du guide, l’API répond aux mêmes requêtes à la même adresse une fois un port local redirigé vers son Service ; l’exécution y a obtenu les mêmes réponses :

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