Couche agent

Agents & MCP

Donnez aux agents une memoire cloisonnee et partageable. Espaces, jetons de capacite, sessions et transferts, exposes via REST et le Model Context Protocol.

Espaces

Un espace est une base de donnees de contexte partagee avec son propre chiffrement et son propre ensemble d'autorisations. Agents et personnes travaillent dans le meme espace.

Jetons de capacite

Remettez a un agent un jeton limite a un espace avec des droits de lecture, d'ecriture ou d'admin. Refus par defaut ; revocable a tout moment.

Sessions

Memoire de travail avec un TTL glissant : messages ordonnes, donnees structurees et resumes, purges a leur expiration.

Transferts

Passez une tache d'un agent a un autre par reference, en transportant une capacite. Le destinataire accepte et l'autorisation de l'emetteur est revoquee.

Natif MCP

barrel_server monte un point de terminaison Model Context Protocol, ainsi un runtime d'agent parle directement a la base de donnees, avec le meme cloisonnement de capacites que la surface REST.

Outils

Documents, requetes BQL, recherche, timeline et la couche agent comme outils MCP.

Ressources en direct

Abonnez-vous a une requete et recevez des notifications resource-updated a chaque changement.

Provenance

Chaque ecriture enregistre l'acteur, la session et la source, ainsi les actions des agents restent auditables.

Demarrage Rapide

cURL 
# Create a space (a shared context database)
curl -X POST https://your-host/spaces \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"label": "research-team"}'

# Issue a scoped capability token for an agent
curl -X POST https://your-host/spaces/$SPACE/grants \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"rights": ["read", "write"]}'

# The agent talks to the same database over MCP at /mcp
#   tools: db_create, doc_put, query, search, branch_create, ...
#   resources: live query subscriptions pushed as updates

Quand l'Utiliser

Utilisez la couche agent quand :

  • + Plusieurs agents partagent et se transferent du contexte
  • + Vous avez besoin d'un cloisonnement d'acces revocable par agent
  • + Vous voulez un magasin de memoire natif MCP
  • + Les actions des agents doivent etre auditables

Considerez des alternatives quand :

  • + Un seul agent sans partage suffit
  • + Vous n'avez pas besoin de cloisonnement de capacites ni de MCP
  • + Vous n'avez besoin que de stockage brut (utilisez alors juste Barrel)
Lire la Documentation Voir le Code Source