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 :
| dossier | ce 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 :
aggrega scaffold --example import-difyElle affiche ensuite les prochaines commandes à exécuter. La première vous place dans le nouveau dossier :
cd import-difyBuild
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 :
cd sourceaggrega import support-assistant.yml --target helmaggrega validate --release release.yamlaggrega build --release release.yamlLa 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 :
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 :
kubectl port-forward -n <namespace> svc/dify-zdapi-default 5001:5001