Utiliser HagiTask
Public concerné : personnes ayant installé HagiCode et souhaitant gérer ou exécuter des tâches.
Prérequis : vous avez installé HagiTask, ou l’application fournit déjà des préréglages intégrés.
Découvrir des tâches
Ouvrez l’interface de gestion HagiTask et des tâches communautaires dans l’application. Elle regroupe les tâches intégrées, les paquets communautaires installés, les paquets de l’espace de travail et les sources gérées, tout en indiquant l’origine de chaque tâche et si elle peut être supprimée. Le catalogue de la Community Gallery sert à découvrir et récupérer des paquets communautaires ; les répertoires visibles par le serveur servent à découvrir les sources des tâches lors de l’exécution.
Installer une tâche
Sélectionnez une tâche dans la Gallery et installez-la, ou installez localement une archive ZIP prise en charge que vous avez déjà obtenue. Après l’installation, l’application enregistre l’identifiant canonique, la version, l’éditeur, l’origine, l’empreinte de l’archive et le répertoire d’installation. Une tâche installée portant le même identifiant n’est pas remplacée silencieusement : traitez d’abord l’installation existante.
Activer et désactiver
- Activer : ajoute une tâche installée au catalogue actif afin qu’elle puisse être découverte et exécutée.
- Désactiver : conserve l’enregistrement et les fichiers du paquet, mais retire la tâche du catalogue actif ; elle ne peut alors plus être exécutée.
- Désinstaller : possible uniquement pour les tâches communautaires disposant d’un enregistrement d’installation. Les tâches intégrées ne sont affichées qu’à titre informatif et ne peuvent pas être désinstallées.
Après un changement d’état, l’application actualise le catalogue. Si cette actualisation échoue, l’opération doit préserver l’état fonctionnel précédent plutôt que laisser un catalogue partiellement mis à jour.
Actualiser et exécuter
Utilisez l’action d’actualisation pour relire le catalogue des tâches actuel. Si vous forcez l’actualisation du catalogue de la Gallery, l’application le récupère et le vérifie à nouveau ; un cache valide existant peut rester disponible lors d’une panne temporaire de la source. L’actualisation ne modifie pas automatiquement l’état d’activation ni la version des tâches.
Avant d’exécuter une tâche, vérifiez qu’elle est activée et que ses dépendances sont satisfaites, puis lancez-la depuis son panneau ou le point d’entrée prévu. Si elle n’apparaît pas, actualisez d’abord le catalogue, puis vérifiez l’état de l’installation, l’identifiant de tâche et les indications de compatibilité. Si le schéma ou les ressources du paquet sont invalides, consultez le guide de contribution communautaire.
Gestion des paquets et gestion des sources côté serveur
Ces deux opérations sont souvent confondues :
| Fonction | Rôle | Signification du chemin |
|---|---|---|
| Gestion des paquets | Installer, activer, désactiver et désinstaller des paquets HagiTask locaux. | Répertoire de données géré par l’application. |
| Gestion des sources côté serveur | Configurer les sources dans lesquelles l’environnement d’exécution découvre les tâches. | Répertoire visible par le serveur. |
Les chemins des sources côté serveur sont lus par le backend pour découvrir les paquets dans ces répertoires : ce ne sont ni des chemins du navigateur ni des champs de téléversement. La procédure d’installation actuelle ne téléverse pas directement un dossier local du navigateur comme paquet de la Community Gallery. Pour installer un paquet, utilisez la Gallery ou la procédure ZIP locale prise en charge.
Si une tâche est indisponible
- Vérifiez que l’identifiant de la tâche, sa version et son enregistrement d’installation existent toujours.
- Vérifiez que la tâche est activée et que les agents, skills et outils CLI requis sont prêts.
- Actualisez le catalogue des tâches et rouvrez l’interface de gestion.
- Si la source est un répertoire côté serveur, vérifiez que le processus backend dispose des droits de lecture sur ce chemin.
- Si la vérification de l’archive ou des ressources du paquet échoue, revenez au dépannage de l’installation. Si vous maintenez le paquet, consultez Contribuer à la communauté.
Étape suivante : Contribuer à la communauté ou revenir à la présentation de HagiTask.