Répéter le travail avec des routines

Créez, gérez et exécutez des routines dans Cartographer pour enregistrer les workflows de tâches réutilisables et les exécuter en un seul clic.

Les routines sont des workflows réutilisables que vous pouvez exécuter en un seul clic. Ils capturent les modèles de travail que vous effectuez de manière répétée, ce qui vous permet d'automatiser des tâches courantes sans les reconstruire à chaque fois. Elles se trouvent dans la section Routages de la barre latérale, avec une entrée de routines planifiées pour celles que vous avez planifiées.

Cartographer est livré avec un ensemble de routines prédéfinies prêtes à l'emploi, ainsi que celles que vous créez vous-même.

Qu'est-ce qu'une routine?

Une routine est une compétence qui a été marquée comme invocable par l'utilisateur — même packaging, même publication, une propriété supplémentaire. Les routines bien conçues comportent généralement:

• Une description claire du déclencheur expliquant quand l’utiliser
• Entrées (paramètres) qui varient à chaque exécution
• Une sortie cohérente (document, rapport, mise à jour, etc.)

Chaque routine est une compétence; chaque compétence n'est pas une routine - la différence est cette propriété supplémentaire. C'est pourquoi la barre latérale a une liste Routes pour celles invocables, tandis que Modules complémentaires et Intégrations → Compétences répertorie tout ce que l'agent peut puiser dans, invoquant ou non. Voir Référence des compétences.

Pensez aux routines comme votre bibliothèque d'automatisation personnelle - les workflows que vous concevez une fois et exécutez chaque fois que nécessaire.

Quand créer une routine

Créez une routine lorsque vous vous trouvez:

• Demander au Cartographer d’effectuer le même type de tâche sur la semaine (par exemple, « Préparer mon résumé du lundi) »
• Suivi d’un processus cohérent avec des données variables (par exemple, « Générer un rapport de statut à partir de ce projet Jira»)
• Partager un workflow avec des collègues qui doivent effectuer la même tâche
• Souhaitez-vous que l’automatisation s’exécute à des heures spécifiques

Créer une routine

Sélectionnez Nouvelle routine dans la section Routages de la barre latérale, et choisissez l'une des quatre méthodes:

Method	Ce qu’il fait
Créer à partir d’une invite	Décrivez une tâche et laissez l’agent construire la routine
Créer à partir d’une compétence	Commencez par un modèle de compétence existant
Créer des étapes à partir de l’enregistrement	Convertissez un workflow enregistré en routine
Enregistrer un nouveau workflow	Enregistrez votre écran pour capturer un nouveau workflow

L'enregistrement d'un workflow est également disponible depuis Enregistrements dans les paramètres — voir Paramètres d'enregistrement et Enregistrement de vos tâches.

En coulisses, une routine est un fichier SKILL.md — pour les utilisateurs à l'aise avec Markdown et la configuration du système de fichiers, la modifier directement est une autre façon de façonner une routine. Voici un exemple de structure:

---
name: my-routine
friendly_name: Weekly Sales Report
version: 1.0.0
description: "Generates a weekly sales summary from spreadsheet data"
icon: FaChartBar
color: "3B82F6"
trigger: "When you need a summary of weekly sales performance"
inputs:
  - name: week_ending
    type: date
    description: "The last day of the week to report on"
  - name: data_file
    type: file
    description: "Path to the sales data spreadsheet"
output:
  type: file
  description: "PowerPoint presentation with sales charts"
---

## Steps

1. Read the sales data from {data_file}
2. Filter for the week ending {week_ending}
3. Calculate total sales, top products, and regional breakdown
4. Create a PowerPoint with:
   - Title slide: "Weekly Sales Report - {week_ending}"
   - Summary slide with key metrics
   - Chart slide showing product performance
   - Regional breakdown table
5. Save as "Sales_Report_{week_ending}.pptx" on the Desktop

Exécution d'une routine

• Sélectionnez une routine dans la liste Routages de la barre latérale. Cela remplit automatiquement la zone de chat avec la commande / de la routine — envoyez-la pour l'exécuter.
• Tapez / dans la zone de discussion pour ouvrir un menu de routines et de commandes disponibles, et sélectionnez-en une pour la remplir automatiquement de la même manière.
• Référencez la routine par nom dans une conversation, par exemple: Run the Weekly Sales Report for last week using the file in ~/Documents/Sales/. Cartographer reconnaît le nom de la routine et l’exécute avec vos paramètres spécifiés.

Gestion des routines

Ouvrez le menu des options à côté d'une routine dans la liste Routages pour ces actions:

Action	Ce qu’il fait
Favori	Épingler la routine pour qu’elle soit plus facile à trouver
Afficher le fichier	Découvrez ce que fait la routine et comment l’utiliser
Planification	Configurez une exécution récurrente ou unique — voir Planifier une routine
Renommer	Modifier le nom complet de la routine
Accéder au projet	Déplacer la routine vers un autre projet
Supprimer (Delete)	Supprimer la routine

Pour modifier une routine, modifiez son fichier SKILL.md associé directement - voir Avancé: stockage de routine.

Planifier une routine

Sélectionnez Planifier à côté d'une routine ou Planifier une routine dans la liste Routages et configurez:

Champ	Description
Routine	Quelle routine exécuter
Planifier la routine	Date et heure de l'exécution
Récurrence	Fréquence de répétition - la valeur par défaut est Aucune (une fois)
Mode	Premier plan (utilise Apps, la souris et le clavier) ou Arrière-plan
Modèle	Quel modèle exécute la routine planifiée

Gestion des routines planifiées

Affichez et gérez toutes les routines planifiées depuis les routines planifiées dans la barre latérale: consultez les exécutions à venir, le statut et l'historique de la dernière exécution, et activez, désactivez, modifiez ou supprimez des planifications individuelles.

Les routines planifiées s’exécutent à l’aide de vos connexions et autorisations stockées. Si l’authentification expire, la routine peut échouer jusqu’à ce que vous vous reconnectiez.

Partager une routine

Étant donné qu'une routine est une compétence, en partager une avec un coéquipier ou en la publier plus globalement suit le même flux de publication, de révision et d'installation que toute autre compétence - voir Partager des compétences avec votre équipe.

Meilleures pratiques de routine

Conception pour la clarté

• Nom descriptif: « Rapport de vente hebdomadaire» et non « Rapport 1»
• Écrivez des déclencheurs clairs: expliquez quand quelqu'un doit utiliser cette routine
• Entrées du document: expliquez le contenu de chaque paramètre et le format attendu
• Spécifier les sorties: décrivez ce que l'utilisateur recevra

Gérer la variabilité

• Utilisez des paramètres d’entrée pour tout ce qui change (dates, chemins d’accès aux fichiers, noms)
• Indiquez des valeurs par défaut sensibles dans la mesure du possible
• Validez les entrées dans les étapes de routine (par exemple, « Vérifiez que le fichier existe»)
• Gérez les entrées manquantes avec soin avec un comportement de secours

Tester de manière approfondie

• Exécutez d’abord le mode guidé pour détecter les étapes inattendues
• Tester avec des cas particuliers (fichiers vides, dates futures, caractères spéciaux)
• Vérifier que les sorties correspondent aux attentes avant de les partager
• Tester sur différentes machines si partage avec une équipe

Contrôle de version

• Dupliquer avant des changements majeurs pour conserver les versions de travail
• Documenter les modifications dans la description de la routine ou un Journal des modifications
• Utiliser le contrôle de version sémantique dans Compétence.md (1.0.0, 1.1.0, 2.0.0) — les versions ne sont jamais suivies

Considérations de sécurité

• Ne codez pas les informations d’identification en dur dans les étapes de routine - utilisez des connexions
• Soyez prudent avec les chemins de fichiers - utilisez des chemins relatifs ou des paramètres d'entrée
• Examiner les autorisations avant le partage - assurez-vous que les destinataires ont accès aux systèmes requis
• Nettoyer les entrées qui entrent dans les commandes shell ou les URL

Avancé: stockage de routine

Les routines sont stockées sous forme de fichiers SKILL.md dans le dossier LocalSkills/:

LocalSkills/
├── my-routine/
│   └── SKILL.md
└── another-routine/
    └── SKILL.md

Voir Paramètres d'emplacement des fichiers pour connaître l'emplacement de ce dossier. Vous pouvez sauvegarder vos routines en les copiant ou les synchroniser entre les machines via le stockage cloud. Faites attention aux chemins absolus dans les routines si vous le faites, car ils peuvent ne pas fonctionner sur une autre machine.

Prochaines étapes

• Référence des compétences - Comment une routine est associée à une compétence
• Partage des compétences avec votre équipe — Publication, installation et examen des compétences et des routines
• Enregistrement de vos tâches - Enregistrez un workflow pour le transformer en une routine ou une compétence de connaissance