Passer au contenu principal
Memories est le système qui permet de partager et de conserver le contexte entre les conversations. Dans Cascade, il existe deux mécanismes à cet effet : les Memories, que Cascade peut générer automatiquement, et les règles, définies manuellement par l’utilisateur aux niveaux local et global.

Comment gérer les Memories

Les Memories et les Rules sont accessibles et peuvent être configurées à tout moment en cliquant sur l’icône Customisations dans le menu coulissant en haut à droite de Cascade. Pour modifier une Memory existante, cliquez simplement dessus, puis cliquez sur le bouton Edit.

Mémoires

Au cours d’une conversation, Cascade peut générer et stocker automatiquement des mémoires lorsqu’il rencontre un contexte qu’il juge utile de retenir. Vous pouvez également demander à Cascade de créer une mémoire à tout moment. Il suffit de lui demander : « créer une mémoire de … ». Les mémoires générées automatiquement par Cascade sont associées au workspace dans lequel elles ont été créées, et Cascade les retrouvera lorsqu’il estimera qu’elles sont pertinentes. Les mémoires créées dans un workspace ne seront pas disponibles dans un autre.
La création et l’utilisation de mémoires générées automatiquement ne consomment PAS de crédits

Règles

Les utilisateurs peuvent définir explicitement leurs propres règles que Cascade doit suivre. Les règles peuvent être définies au niveau global ou au niveau du workspace. global_rules.md - règles appliquées à tous les workspaces .windsurf/rules - répertoire au niveau du workspace contenant des règles associées à des globs ou à des descriptions en langage naturel.

Découverte des règles

Windsurf découvre automatiquement des règles à partir de plusieurs emplacements pour offrir une organisation flexible :
  • Workspace actuel et sous-répertoires : Tous les répertoires .windsurf/rules dans votre workspace actuel et ses sous-répertoires
  • Structure du dépôt Git : Pour les dépôts Git, Windsurf recherche également jusqu’à la racine du dépôt afin de trouver des règles dans les répertoires parents
  • Prise en charge de plusieurs workspaces : Lorsque plusieurs dossiers sont ouverts dans le même workspace, les règles sont dédupliquées et affichées avec le chemin relatif le plus court

Emplacements de stockage des règles

Les règles peuvent être stockées dans l’un des emplacements suivants :
  • .windsurf/rules dans le répertoire de votre workspace actuel
  • .windsurf/rules dans n’importe quel sous-répertoire de votre workspace
  • .windsurf/rules dans les répertoires parents jusqu’à la racine Git (pour les dépôts Git)
Lorsque vous créez une nouvelle règle, elle est enregistrée dans le répertoire .windsurf/rules de votre workspace actuel, pas nécessairement à la racine Git. Pour commencer avec les règles, cliquez sur l’icône Customisations dans le menu coulissant en haut à droite de Cascade, puis accédez au panneau Rules. Vous pouvez ensuite cliquer sur le bouton + Global ou + Workspace pour créer de nouvelles règles au niveau global ou au niveau du workspace, respectivement.
Vous pouvez trouver des modèles de règles sélectionnés par l’équipe Windsurf à l’adresse https://windsurf.com/editor/directory pour vous aider à démarrer.
Les fichiers de règles sont limités à 12 000 caractères chacun.

Bonnes pratiques

Pour aider Cascade à suivre efficacement vos règles, appliquez ces bonnes pratiques :
  • Rédigez des règles simples, concises et précises. Des règles trop longues ou vagues peuvent dérouter Cascade.
  • Il n’est pas nécessaire d’ajouter des règles génériques (p. ex. « écrire du bon code »), car elles sont déjà intégrées aux données d’entraînement de Cascade.
  • Mettez vos règles en forme avec des puces, des listes numérotées et du Markdown. Elles sont plus faciles à suivre pour Cascade qu’un long paragraphe.
Par exemple :
  • Les balises XML peuvent être un moyen efficace d’exprimer et de regrouper des règles similaires. Par exemple :

Règles système (Enterprise)

Les organisations Enterprise peuvent déployer des règles système qui s’appliquent globalement à tous les workspaces et ne peuvent pas être modifiées par les utilisateurs finaux sans droits d’administrateur. Idéal pour faire respecter, à l’échelle de l’organisation, les normes de codage, les politiques de sécurité et les exigences de conformité. Les règles système sont chargées à partir de répertoires spécifiques au système d’exploitation : macOS :
Linux/WSL :
Windows :
Placez vos fichiers de règles (sous forme de fichiers .md) dans le répertoire correspondant à votre système d’exploitation. Le système chargera automatiquement tous les fichiers .md situés dans ces répertoires.

Fonctionnement des règles système

Les règles au niveau système sont combinées avec les règles de workspace et les règles globales, ce qui fournit un contexte supplémentaire à Cascade sans remplacer les règles définies par les utilisateurs. Cela permet aux organisations de définir des normes de base tout en laissant aux équipes la possibilité d’ajouter des personnalisations spécifiques à leurs projets. Dans l’interface Cascade, les règles système sont affichées avec un libellé « System » et ne peuvent pas être supprimées par les utilisateurs finaux.
Important : Les règles au niveau système doivent être gérées par votre équipe IT ou sécurité. Assurez-vous que vos équipes internes gèrent le déploiement, les mises à jour et la conformité conformément aux politiques de votre organisation. Vous pouvez utiliser des outils et des workflows standard tels que Mobile Device Management (MDM) ou Configuration Management pour ce faire.