Identifier la ressource, pas seulement son nom
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.
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.