Barrel
EN GitHub

Glossaire

Cette page explique les mots qu’emploie la documentation de Barrel, par ordre alphabétique. Chaque entrée dit ce qu’est la chose, pourquoi elle vous concerne, et où en lire plus. Les autres pages renvoient ici la première fois qu’elles emploient un terme : revenez-y dès qu’un mot n’est pas clair.

Actif-actif

Chaque copie d’une base accepte des écritures, et les copies convergent quand elles se répliquent. Vous ne choisissez pas de copie principale : un portable, un téléphone et deux serveurs peuvent tous accepter des modifications du même document pendant qu’ils sont séparés. Les modifications concurrentes sont gardées comme conflit au lieu d’être perdues. Voir Synchronisation.

barrel-lite

Un client TypeScript qui garde une copie locale d’une base dans le navigateur et la synchronise avec un serveur Barrel. Votre application web lit et écrit en local, continue de fonctionner hors ligne, et converge avec le serveur quand elle se reconnecte. Le navigateur peut effacer les données locales : c’est la synchronisation qui rend les écritures durables. Voir barrel-lite.

BM25

Un classement par mots-clés : il ne renvoie que les documents qui contiennent les mots de votre requête, classés selon leur correspondance. Utilisez-le quand les termes exacts comptent, comme un code d’erreur ou un nom de produit. Son score est la valeur BM25 brute, sans borne supérieure. Voir Vectorielle, mots-clés et hybride.

BQL

Le langage de requête de Barrel, un dialecte de PartiQL (du SQL pour JSON). Une seule instruction SELECT peut filtrer des documents, lancer une recherche vectorielle ou par mots-clés et relier les résultats à leurs documents, ou s’abonner aux mises à jour en direct. Elle se compile vers le même moteur que l’API structurée find/2. Voir Interroger avec BQL.

Branche

Une bifurcation d’une base, créée en temps constant quelle que soit sa taille, parce que la branche partage ses fichiers sur disque avec sa base parente. La branche est une base normale : un agent ou une expérience y travaille seul, puis vous fusionnez ce qui a passé la revue. Les modifications concurrentes des deux côtés deviennent des conflits ordinaires. Voir Brancher, fusionner, restaurer.

Canal

Un ensemble nommé de motifs de chemins, déclaré à la création d’une base, qui choisit un sous-ensemble de documents à répliquer. Barrel range les écritures correspondantes dans un flux propre au canal au moment où elles ont lieu : une récupération filtrée ne lit donc que ce flux, et non tout l’historique. Servez-vous-en, par exemple, pour n’envoyer à un téléphone que ses tâches. Voir Synchronisation.

Conflit

Deux copies ont modifié le même document avant de se synchroniser : aucune version n’a vu l’autre. Barrel garde les deux comme versions sœurs, affiche le même gagnant sur chaque copie, et liste les autres dans _conflicts jusqu’à ce que vous les résolviez. Par ailleurs, une écriture avec un _rev périmé est refusée avec {error, conflict} : vous n’écrasez jamais une modification que vous n’avez pas lue. Voir Versions, conflits, convergence.

Convergence

La garantie que chaque copie d’une base finit avec les mêmes versions, le même gagnant, le même corps et le même indicateur de suppression, quel que soit l’ordre des écritures et des synchronisations. C’est ce qui vous permet d’écrire partout et de synchroniser plus tard sans coordinateur. Voir Pourquoi cela converge.

Document

Un objet JSON avec un id, comme l’article de support kb-142. Chaque écriture crée une nouvelle version, et chacun de ses champs est indexé : vous pouvez donc interroger n’importe quel champ sans déclarer d’index. Les champs de premier niveau qui commencent par _ sont réservés à Barrel. Voir L’enregistrement.

Embarqué

Faire tourner Barrel dans votre propre release Erlang ou Elixir, comme une bibliothèque, sans serveur ni saut réseau. Vous disposez de toute l’API dans le processus : documents, recherche, pièces jointes, mode enregistrement et timeline. Choisissez ce mode quand votre application possède les données. Voir Intégrer barrel dans une application Erlang.

Embedding

Le vecteur qu’un modèle calcule à partir d’un texte, de sorte que des textes de sens proches reçoivent des vecteurs proches. Barrel appelle un fournisseur d’embeddings (un modèle local, un serveur Ollama ou une API cloud) à chaque écriture et à chaque requête textuelle. Le fournisseur que vous choisissez décide où part votre texte. Voir Choisir un fournisseur d’embeddings.

Enregistrement

Tout ce que Barrel garde sous un même id : le document, ses pièces jointes et, en mode enregistrement, son vecteur. Vous les lisez, écrivez, répliquez et supprimez par cet id : ils ne se désynchronisent jamais. Voir L’enregistrement.

Épingle

Un élément de contexte que vous attachez à une session avec pin_context, comme un fait clé que l’agent doit garder sous les yeux. Les épingles sont stockées comme documents dans l’espace et listées avec list_pinned : tout détenteur d’un jeton pour l’espace peut donc les lire. Voir Espaces, sessions, passations.

Espace

Une base Barrel que plusieurs agents partagent, chacun détenant un jeton de capacité pour elle. Son nom est sp_ suivi de 16 caractères, et un registre garde la trace de qui a reçu quels droits. Utilisez un espace par travail partagé, comme un brouillon de recherche commun. Voir Espaces et capacités.

Jeton de capacité

Une chaîne secrète qui commence par bsp_ et donne à son détenteur des droits read, write ou admin sur un seul espace, et sur rien d’autre. Elle n’est affichée qu’une fois, à l’émission ; Barrel ne stocke que son hachage SHA-256. barrel_server la vérifie à chaque requête, alors que dans votre propre nœud Erlang elle est indicative. Voir Espaces et capacités.

MCP

Le Model Context Protocol, un moyen standard pour les runtimes d’agents et les IDE d’appeler des outils. Le serveur Barrel sert un point d’accès MCP sur /mcp, avec des outils pour les documents, BQL, la recherche, la timeline, les espaces et les contextes. Votre agent parle directement à Barrel, soumis aux mêmes jetons de capacité qu’en REST. Voir Point d’accès MCP.

Mode enregistrement

Un réglage de base qui indique à Barrel quels champs traiter, avec quel fournisseur et à quelle dimension. Barrel calcule alors le vecteur à chaque écriture et le supprime à la suppression : la recherche correspond toujours aux documents courants, et vous n’appelez jamais vector_add vous-même. Voir Mode enregistrement.

Passation

Le moyen pour un agent de transmettre une tâche à un autre dans un espace. Elle émet un jeton de capacité pour la tâche ; le premier qui l’accepte obtient une session dans le même espace, et une deuxième acceptation échoue. Rien n’est copié : l’agent suivant lit le contexte là où il se trouve. Voir Espaces et capacités.

Pièce jointe

Un fichier binaire nommé, stocké sous l’id d’un document, comme steps.md sur l’article de support kb-142. Les pièces jointes ne sont pas versionnées : la dernière écriture l’emporte selon son horodatage, et en écrire une ne change pas la révision du document. Elles se répliquent sur leur propre flux, à côté des documents. Voir Pièces jointes.

Point de reprise

Un petit enregistrement local, gardé des deux côtés d’une réplication, qui note jusqu’où est allée la dernière exécution. L’exécution suivante repart de là au lieu de tout reprendre : vous pouvez donc arrêter et relancer la réplication à tout moment. Une réplication filtrée garde son propre point de reprise. Voir Synchronisation.

Recherche hybride

Une recherche qui lance une recherche vectorielle (par le sens) et une recherche BM25 (par mots-clés), puis fusionne les deux classements en un seul. Elle trouve les documents qui disent la même chose avec d’autres mots, tout en classant bien les termes exacts. La fusion par défaut se fonde sur les rangs, pas sur les scores bruts. Voir Vectorielle, mots-clés et hybride.

Réplication

La copie de versions d’une base vers une autre, dans la même VM Erlang ou sur HTTP vers un serveur Barrel. Elle s’exécute une fois ou en continu, reprend depuis son point de reprise, et peut ne transporter qu’un sous-ensemble grâce à un canal. Envoyer une version deux fois est sans danger. Voir Synchronisation.

Restauration à un instant donné

Lire une base telle qu’elle était à un instant passé, en créant une branche à cet instant. Vous obtenez les données d’hier à côté de celles d’aujourd’hui, sans restaurer une sauvegarde par-dessus la base en service. Cela fonctionne dans la fenêtre de rétention (30 jours par défaut) ; l’historique plus ancien a disparu. Voir Sauvegarde et restauration.

Révision

Le champ _rev que Barrel ajoute quand vous lisez un document : le jeton de sa version gagnante, construit à partir d’une horloge et de l’id de la base qui l’a écrite. Renvoyez-le quand vous mettez le document à jour ; un _rev absent ou périmé renvoie {error, conflict}. Voir Le jeton de version.

Serveur Barrel

barrel_server met une base Barrel sur le réseau : du REST/JSON sur HTTP, et un point d’accès MCP pour les agents. Utilisez-le quand les clients sont dans d’autres langages, sur d’autres machines, ou doivent être limités par un jeton de capacité. Il ne contient aucune logique de base de données et ne fait pas partie de la compilation embarquée par défaut. Voir Lancer le serveur.

Session

Le contexte de travail d’un agent dans un espace : ses messages, ses données clé/valeur et ses épingles, stockés comme documents dans l’espace. Elle expire après une période sans activité (3600 secondes par défaut), sauf si vous la rendez durable. Tout détenteur d’un jeton pour l’espace peut la lire. Voir Espaces et capacités.

Vecteur

Une liste de nombres qui représente le sens du texte d’un document, et sert à trouver des documents par similarité. En mode enregistrement, il suit le document : écrit avec lui, supprimé avec lui. Les vecteurs ne sont pas répliqués ; chaque copie calcule les siens. Voir Vectorielle, mots-clés et hybride.

Traduit de la page anglaise: /docs/concepts/glossary/ Modifier cette page Voir en Markdown

Haut et bas pour se déplacerEntrée pour ouvrir