Identifier la ressource, pas seulement son nom
La collection galaris://documentation/ donne accès en lecture seule aux sources produit autorisées. Les outils d’annuaire exposent aussi les adresses des profils d’agents à jour : lire la fiche par sa référence évite d’en conserver une copie périmée.
Un fichier appelé « rapport.pdf » peut exister dans plusieurs systèmes. Galaris utilise une URI pour identifier sa source et le service qui en contrôle l’accès. L’agent découvre les familles disponibles avant de choisir une opération.
| Adresse | Ressource |
|---|---|
document:// |
Documents HTML, Datasets JSON et collections de pièces jointes |
memory:// |
Connaissances accessibles |
galaris:// |
tâches, Goals, cycles, processus et autres objets exposés |
console:// |
Fichiers du home de la console active |
mail:// |
Pièces jointes d’un message identifié |
| URI d’un Tool connecté | Fichiers de ce provider, notamment Nextcloud ou une messagerie |
| HTTPS public | Lecture ou transfert web dans les limites du provider |
Chercher, lire et modifier dans le bon périmètre
Les outils communs couvrent liste, métadonnées, recherche par nom ou contenu, lecture paginée, création, remplacement, ajout, modification ciblée, copie, déplacement et suppression. Chaque provider annonce les opérations qu’il supporte.
La lecture peut se poursuivre avec un curseur. Une modification utilise les préconditions de révision lorsqu’elles sont requises. Les objets métier protégés restent soumis à leur propre contrat ; une opération de fichier ne permet pas de contourner leur gestion.
Copier directement vers la destination
Un agent peut copier une pièce jointe de messagerie vers un document ou un stockage connecté sans inventer un chemin local intermédiaire. La destination peut être une collection qui conserve le nom du fichier. L’écrasement doit être explicite.
Les médias entrants gardent l’outil qui les a reçus. Lorsqu’une bibliothèque exige des octets locaux, Galaris crée une matérialisation temporaire bornée ; ce temporaire ne devient pas un nouvel espace de stockage de l’agent.
Réutiliser les fichiers d’un espace AFFiNE
Un outil connecté configuré pour AFFiNE peut lire les métadonnées, télécharger, copier ou téléverser les fichiers d’un workspace. Leur référence conserve le code de l’outil, le workspace et la clé du blob. Les accès et les limites de téléchargement restent contrôlés. Ce transport concerne les pièces jointes ; il ne synchronise pas l’ensemble des pages AFFiNE.
Ouvrir sans perdre le contexte
Les visionneuses prennent en charge les formats prévus : texte, images, PDF, audio, vidéo, pages HTML et scènes 3D. Les aperçus et conversions dépendent du type de ressource. Les liens Galaris ouvrent l’objet correspondant en appliquant ses droits.
Retrouver les entrées et les livrables
Le Working Set d’une tâche conserve les ressources d’entrée, les fichiers produits et les livrables finaux avec leurs preuves d’outil. Un fichier déjà produit peut faire l’objet d’une reprise de livraison, sans relancer le modèle.
Une console n’est nécessaire que pour disposer d’un espace console://. Les documents et fichiers des autres providers restent utilisables avec leurs propres connexions.
Éditer des documents · Utiliser une console
Lire le fichier et comprendre un transfert interrompu
Les pièces jointes Markdown ont un lecteur rendu ; code, JSON et texte gardent une vue source avec copie et téléchargement. Les aperçus 3D prennent en charge GLB, glTF autonome, OBJ, STL et PLY dans leurs limites ; ils ne remplacent pas un logiciel de CAO.
Lors d’une copie préparée par téléchargement, un rejet avant l’upload n’a pas modifié la destination. Une erreur après le début de l’écriture peut laisser une issue inconnue. La reprise doit tenir compte de cette différence pour éviter une seconde écriture.
Documents HTML et Datasets JSON
document:// identifie aussi les Datasets. Pour en créer un, l’agent utilise file_create avec document_type="dataset" ; HTML reste le type par défaut. Le type est fixé à la création, y compris lors d’une écriture, d’une copie vers une cible existante ou d’une restauration.
La lecture et l’édition portent sur les lignes JSON réelles. Chaque modification valide le JSON complet et contrôle la révision attendue. file_append concatène du texte : ce n’est pas l’ajout d’une ligne de données. Pour ajouter une entrée à un tableau depuis une application documentaire, utilisez le SDK Dataset. Une ressource JSON copiée vers la collection Documents crée un Dataset.
Retrouver les fichiers sans mémoriser leur emplacement
Le catalogue privé de chaque agent rend recherchables les fichiers et répertoires rencontrés lors de listes et recherches autorisées. Choisissez Indexation désactivée, Uniquement les fichiers déjà connus — le défaut des fournisseurs compatibles — ou la découverte récursive quand elle existe. Nextcloud permet cette découverte ; Console, AFFiNE et Grav se limitent aux adresses connues. Mail est exclu ; les fichiers reçus en messagerie rejoignent le catalogue à leur réception.
Dream parcourt progressivement les répertoires, conserve sa progression et peut reprendre. Le reparcours est hebdomadaire par défaut, avec des choix quotidien ou désactivé. Dans Dream → Indexation, vérifiez la couverture, lancez ou annulez un parcours et relancez ses réparations.
Une ressource, plusieurs copies
Les copies strictement identiques sont reconnues par l’empreinte des octets complets. Pour un même agent, elles peuvent partager une fiche avec plusieurs emplacements, leurs descriptions, notes et sources. Une copie modifiée prend une identité distincte ; retirer un emplacement n’efface pas les autres. L’accès est revérifié sur la source à chaque consultation, et les identités restent séparées entre agents.
Documents, pièces jointes et fichiers indexés disposent de miniatures et d’aperçus selon leur format : image, PDF, bureautique, tableur, audio, vidéo, Markdown, code ou 3D. Un format non pris en charge reste téléchargeable. Explorer la mémoire et les sources.

