Sélectionner des capacités

Choisissez un preset pour un projet standard, Custom pour une sélection interactive, ou --caps si vous connaissez déjà les composants dont vous avez besoin.

Utiliser un preset

Utiliser un preset

mistral init my-app --preset app
mistral init my-workflow --preset workflow

Le preset app crée un frontend web, une API Python, une base de données Postgres et un worker de workflows. Le preset workflow crée un projet de workflow. Les presets sélectionnent les composants sans vous demander de les choisir un par un.

Sélectionner de façon interactive

Sélectionner de façon interactive

mistral init my-app

Choisissez Custom quand la CLI vous le demande. Elle regroupe les capacités par type de composant, par exemple frontend, backend ou base de données, et affiche la sélection complète avant de l'installer. Les composants requis et les dépendances sont inclus automatiquement.

mistral apps init my-app passe la première question et ouvre directement les sélecteurs de composants.

Indiquer les capacités

Indiquer les capacités

Listez les identifiants disponibles, puis passez une sélection séparée par des virgules :

mistral apps capability list
mistral init my-app --caps tanstack-start,fastapi

Vous ne pouvez pas combiner --preset et --caps. Utilisez les identifiants affichés par capability list, comme mistralai-capabilities/backend/fastapi, ou la forme courte, comme fastapi, quand elle n'est pas ambiguë. Si vous omettez apps, la CLI l'ajoute, car c'est la seule capacité de déploiement. La CLI signale les composants incompatibles ou manquants au lieu de les remplacer sans prévenir.

Modifier une app existante

Modifier une app existante

Astuce

Commitez votre travail avant de modifier la sélection. Vous pourrez ensuite examiner le diff et restaurer vos fichiers si nécessaire.

Exécutez ces commandes depuis le répertoire de l'app :

mistral apps capability add workflows
mistral apps capability remove workflows
mistral apps capability select --caps tanstack-start,fastapi,postgres,apps

add étend la sélection. remove retire une capacité sélectionnée, mais pas un composant requis ni une dépendance dont une autre capacité a encore besoin. select remplace l'ensemble de la sélection : incluez tous les composants que vous voulez garder.

Retirer une capacité ne supprime pas son module de mistral.json. select signale les modules qui ne sont plus utilisés, remove ne le fait pas. Si vous n'avez plus besoin d'un module, supprimez son entrée vous-même.

Mettre à jour les capacités

Mettre à jour les capacités

Pour réaligner les capacités installées sur leurs versions déclarées et régénérer leurs fichiers, exécutez :

mistral apps capability update

La CLI affiche le plan de mise à jour et les entrées de changelog associées. Examinez les fichiers modifiés et lancez les vérifications de votre app avant de déployer. Pour mettre à jour une seule capacité vers une version précise, indiquez son identifiant et la version :

mistral apps capability update CAPABILITY_ID VERSION

Remplacez les paramètres par l'identifiant d'une capacité installée et la version souhaitée. Pour les options, consultez la Référence de la CLI.