Quelle part d'un store a été réécrite
revisions répond revised sur total : combien de souvenirs d'un store ont été modifiés après avoir été écrits. Il vaut la peine de poser la question avant de vous appuyer sur la mémoire pour quelque chose qui compte, ou quand un fait rappelé ne colle pas à ce que l'utilisateur dit maintenant. Un store dont trois faits sur dix ont été remplacés mérite moins de confiance qu'un store que personne n'a modifié.
Pris en charge à partir de Tablet 2. Appelable via l'API HTTP, depuis les SDK Python, TypeScript et Rust, et comme outil MCP. Les moteurs plus anciens répondent 501 et nomment le modèle qui ne peut pas le servir.
Compteurs
Il compte ce qu'une transformation a touché - remplacé, mis à jour, rétracté, ainsi que les images retirées.
mem.revisions()
# {"revised": 3, "unrevised": 37, "total": 40, …}| Champ | Signification |
|---|---|
| revised | Les souvenirs qu'une transformation a touchés. |
| unrevised | Les souvenirs auxquels rien n'a touché depuis leur écriture. revised + unrevised égale toujours total - cette valeur est dérivée et non comptée séparément, si bien qu'une écriture concurrente ne peut pas mettre les trois en désaccord. |
| total | Les souvenirs présents dans le store. |
| counts / excludes | Des phrases simples, et non des indicateurs, qui précisent ce que les nombres recouvrent. L'appelant est souvent un modèle. |
Lire la liste
Passez include pour obtenir les souvenirs eux-mêmes, et pas seulement leur nombre. Si vous l'omettez, vous n'obtenez que les compteurs, ce qui constitue l'appel le moins coûteux.
page = mem.revisions(include="revised", limit=20)
page["memories"], page["matched"], page["has_more"]| Champ | Ce qu'il fait |
|---|---|
| include | "revised" ou "unrevised". Toute autre valeur est refusée avec un 400 plutôt que de retomber sur les compteurs : une faute de frappe qui supprimerait silencieusement la liste serait indiscernable d'un store vide. |
| limit | 5 à 20, valeur par défaut 20. Une valeur hors bornes, ou d'un type incorrect, est refusée plutôt que ramenée dans les bornes. |
| matched | Nombre total de lignes derrière cette page, et non la taille de la page. |
| ordered_by | Le service indique lui-même son ordre de tri : du plus récemment stocké au plus ancien, et non du plus récemment modifié. |
| next_before | Curseur de la page suivante, avec next_skip_ids. Renvoyez les deux ; les ids s'accumulent au fil des pages. |
La liste est triée selon la date de stockage d'un souvenir, pas selon sa date de modification. Un appelant qui suppose « du plus récemment modifié au plus ancien » lit la page de travers, c'est pourquoi la réponse précise lequel des deux s'applique.
Les suppressions ne sont pas comptées. Un souvenir supprimé ne laisse rien à compter, si bien qu'un store fortement élagué affiche toujours un
revised faible. Ce nombre vous dit quelle part a été réécrite, pas quelle part a disparu.