Memory permet à Kiro de conserver du contexte utile d'une session de clavardage à la suivante. Il peut retenir les commandes et les conventions d'un dépôt, les corrections, les constats de débogage, les approches déjà écartées et votre façon préférée de travailler. Lorsque ce contexte redevient pertinent, Kiro peut l'utiliser dans un travail ultérieur. Vous passez moins de temps à reconstruire le contexte et plus de temps à poursuivre la tâche.
Memory fait partie du harnais d'agent de Kiro, le système qui assemble le contexte et exécute l'agent. Il résout deux problèmes liés : décider ce qui, dans votre travail, est assez utile pour être conservé, et trouver la mémoire pertinente pour la tâche en cours. Chaque mémoire est un enregistrement composé d'un titre, d'une description et d'un contenu, et non une copie d'une conversation passée. Les mémoires sont stockées localement par compte utilisateur, et non par espace de travail. Kiro IDE et Kiro CLI sur la même machine partagent les mémoires stockées, mais chaque application a son propre paramètre Memory.
Memory ajoute l'apprentissage et le rappel au contexte que Kiro utilise déjà :
- Commencer par la tâche en cours. Votre requête, la conversation en cours et le Steering entrent dans le harnais d'agent comme contexte courant.
- Apprendre du travail. Le harnais peut repérer du contexte utile et créer ou affiner une mémoire.
- Rappeler au moment pertinent. Dans une session ultérieure, Kiro peut récupérer une mémoire correspondante pendant qu'il travaille sur votre requête.
Memory fonctionne de concert avec les autres formes de contexte dans le harnais d'agent :
- Memory : le contexte que Kiro apprend de votre travail et peut rappeler dans une session ultérieure.
- Steering : les règles et les consignes que vous rédigez lorsque vous voulez un contrôle explicite sur ce que Kiro suit.
- Historique de session : la conversation et le travail déjà en cours lorsque vous poursuivez ou reprenez la même session.
- Compaction : un résumé de l'historique de conversation plus ancien qui maintient une longue session dans sa limite de contexte.
- Knowledge Bases (CLI) : du matériel de référence que vous choisissez et indexez pour que Kiro puisse y faire des recherches au besoin.
Ces formes de contexte peuvent fonctionner ensemble. Memory ajoute du contexte appris; il ne remplace pas votre conversation en cours, le Steering ni le matériel de référence. Si une règle doit s'appliquer de façon constante, écrivez-la dans le Steering.
Choisissez votre application pour voir comment l'apprentissage et le rappel sont contrôlés.
Dans Kiro IDE 1.4.236 ou une version ultérieure, choisissez un niveau Memory dans le menu des paramètres de la vue Memories. L'agent conserve ce choix. Le paramètre Kiro Agent: Memory est obsolète et vous dirige vers ce menu. Dans Kiro IDE 1.4.215 ou une version ultérieure, le niveau par défaut se nomme Don't use. Avant la version 1.4.215, il se nommait Off. Kiro IDE 1.4.215 a renommé les quatre niveaux; le paramètre stocké et le comportement sont inchangés, et un niveau que vous avez choisi sous son ancien nom est conservé. Avant la version 1.4.215, les niveaux se nommaient Use and learn, Use but don't learn, Use only et Off.
- Sélectionnez l'icône Memories dans la barre d'activité pour ouvrir la vue Memory.
- Dans Kiro IDE 1.4.236 ou une version ultérieure, sélectionnez l'engrenage dans la barre de titre de la vue, puis choisissez un niveau d'accès.
- Dans les versions antérieures, sélectionnez l'engrenage Memory settings, puis choisissez un niveau d'accès dans le paramètre Kiro Agent: Memory.
Dans Kiro IDE 1.4.236 ou une version ultérieure, confirmez le changement en ouvrant de nouveau le menu de l'engrenage et en vérifiant que le niveau choisi est sélectionné. Dans les versions antérieures, confirmez la valeur choisie dans le paramètre Kiro Agent: Memory.
| Niveau d'accès | Effet |
|---|---|
| Use and create automatically | Kiro utilise les mémoires et peut les modifier, selon vos permissions. Il crée et affine aussi des mémoires automatiquement. |
| Use and create when asked | Kiro utilise les mémoires et peut les modifier lorsque vous le demandez, selon vos permissions. Il ne crée ni ne met à jour de mémoires automatiquement. |
| Use but don't create | Kiro utilise les mémoires existantes, mais ne les crée, ne les met à jour ni ne les supprime jamais, même lorsque vous le demandez. Memory est en lecture seule. |
| Don't use | Kiro n'utilise ni ne modifie les mémoires. C'est la valeur par défaut. |
Activer ou désactiver Memory, ou passer à Use but don't create ou en sortir, s'applique aux nouvelles sessions. L'IDE affiche l'avis « Memory settings updated. The change applies to new sessions. » avec une action Start new session. Passer de Use and create automatically à Use and create when asked, ou inversement, prend effet immédiatement dans les sessions locales ouvertes.
Le paramètre Memory est un paramètre utilisateur. Une valeur dans les paramètres de l'espace de travail n'a aucun effet.
Dans Kiro IDE 1.4.121 ou une version ultérieure, un sous-agent que Kiro dépêche peut lire les mémoires locales accessibles à sa session parente. Il ne peut ni les ajouter, ni les modifier, ni les supprimer.
Choisissez votre application pour voir comment inspecter les mémoires stockées.
Sélectionnez l'icône Memories dans la barre d'activité pour ouvrir la vue Memory. Elle liste les mémoires Global et les mémoires limitées aux dépôts ouverts dans la fenêtre actuelle.
Chaque mémoire a un type, qui indique le genre d'information qu'elle contient, et un emplacement, qui montre où elle s'applique : Global ou le nom d'un dépôt. La plupart des mémoires affichent le type Preference ou Fact. Un type que l'IDE ne peut pas nommer s'affiche comme Other.
- Chaque rangée affiche le titre, le temps écoulé depuis la création de la mémoire, un résumé d'une ligne, son type et son emplacement.
- Saisissez du texte dans Search memories... pour filtrer par titre ou par résumé. Sélectionnez Sort pour trier la liste par date de création, de la plus récente ou de la plus ancienne en premier. Sélectionnez Filter pour la restreindre par Type et par Applies to (Global ou un dépôt); Clear filters affiche de nouveau toutes les mémoires. Le pied de page indique combien de mémoires sont stockées, par exemple
3 of 12 memorieslorsqu'un filtre est actif. - Sélectionnez une rangée pour ouvrir la mémoire dans un onglet d'éditeur. L'onglet affiche son type, son emplacement, son heure de création, Summary et Content, avec un bouton Delete.
- Dans l'onglet, survolez le badge de type ou placez le focus dessus pour lire ce que le type signifie : How you like Kiro to work. pour Preference, Something true about this repository. pour Fact, et Not a preference or a fact. pour Other.
- Survolez le badge d'emplacement ou placez le focus dessus pour lire où la mémoire est utilisée : Used in every workspace. pour Global, ou Used only in suivi du nom du dépôt pour une mémoire de dépôt.
- Pour supprimer une mémoire, faites un clic droit sur sa rangée et choisissez Delete, ou sélectionnez Delete dans son onglet. Kiro vous demande de confirmer avant de supprimer la mémoire.
- Dans Kiro IDE 1.4.215 ou une version ultérieure, la vue et les onglets de mémoire ouverts se mettent à jour automatiquement lorsqu'un clavardage ajoute, modifie ou supprime une mémoire, et lorsque vous y revenez, et il n'y a pas de bouton Refresh. Avant la version 1.4.215, sélectionnez Refresh Memories dans la barre de titre de la vue, ou Refresh dans un onglet de mémoire, pour recharger. Si la vue affiche Memory is not available, sélectionnez Retry.
Vous pouvez supprimer une mémoire à partir de la vue Memory même avec Use but don't create. Pour corriger le contenu d'une mémoire, demandez-le à Kiro dans le clavardage. Kiro ne peut faire le changement qu'avec Use and create automatically ou Use and create when asked dans un espace de travail approuvé.
Supposons que Kiro apprenne, en déboguant, que les tests d'intégration d'un dépôt échouent tant que la base de données locale n'est pas amorcée. Une mémoire peut consigner ce constat. Dans une session ultérieure, Kiro peut le rappeler et amorcer la base de données en premier plutôt que de redécouvrir la cause.
Lorsque Kiro utilise des mémoires, le clavardage regroupe cette activité dans des entrées repliables telles que Memory accessed (1), Memory created (1) ou Memory updated (1). Chaque entrée liste les titres des mémoires concernées. Survolez un titre pour voir le type et le résumé de la mémoire. Dans les entrées Memory accessed, Memory created, Memory updated et Memory listed, sélectionnez un titre pour ouvrir la mémoire. Une entrée Memory deleted nomme des mémoires qui n'existent plus, et une entrée Memory imported nomme la source de l'importation; leurs titres ne s'ouvrent donc pas.
L'exemple de débogage pourrait afficher :
Memory accessed (1)
seed-db-before-integration-tests
La mémoire rappelée indique à Kiro d'amorcer la base de données locale avant d'exécuter les tests d'intégration.
Un appel à Memory qui a échoué ou que Kiro n'a pas pu confirmer apparaît plutôt dans sa propre carte, telle que Couldn't save memory ou Memory not saved, avec le texte de résultat de l'agent. Lorsqu'il est disponible, la carte affiche aussi le nom de la mémoire.
Les mémoires rappelées consomment aussi du contexte. Sélectionnez l'indicateur d'utilisation du contexte dans la zone de saisie du clavardage pour ouvrir Context Usage. Une rangée Memory apparaît après Steering files lorsque des mémoires consomment du contexte.
Memory