Accéder à la documentation
Docs

Un File est un fichier — et c'est déjà puissant

Un File n'est pas une pièce jointe jetable. Il représente une source canonique du filesystem sur le Canvas et rend clair quel contenu le travail doit lire, revoir, modifier ou utiliser comme entrée.

Voyez un PDF participer au travail sur le Canvas → (s’ouvre dans un nouvel onglet)

Le File garde le contenu visible pendant que vous organisez agents, décisions et exécution autour de lui.

Ce que fait un File

À lui seul, un File permet de visualiser et d'utiliser une source du Workspace. Selon son format, Kavor propose l'édition de texte, la recherche, des préférences de lecture et un aperçu enrichi.

Les formats texte incluent Plain Text, Markdown, JSON, SQL, TypeScript, JavaScript, YAML, Shell, HTML et CSS. Les images et les PDF peuvent être visualisés sur le Canvas ; un SVG peut alterner entre aperçu et source.

Le File continue de pointer vers la vraie source. Si le fichier change en dehors de Kavor, le Node reflète ce changement et signale lorsqu'une modification locale doit être réconciliée. Vous ne confondez ainsi pas une copie de contexte avec l'artefact qui sera réellement versionné.

Un File comme portée explicite

Connecté à un CodingAgent, un File transforme une intention générale en source de travail concrète. Il peut délimiter un module, fournir un contrat d'entrée, garder une image ou un PDF disponible pour l'analyse, ou identifier la configuration à revoir.

Une demande de départ peut être :

Lis le File connecté comme la source canonique de cette tâche. Explique ce qui doit changer, préserve la portée et n'édite qu'après ma confirmation du plan.

Lorsque l'agent doit seulement consulter le contenu, utilisez le Guardrail file_read_only sur la Connection directe. L'agent peut toujours atteindre le File, mais ne peut pas modifier sa source par les opérations médiées par Kavor.

Un File comme entrée d'un Terminal

Une Connection File + Terminal exporte le chemin absolu canonique du fichier vers la session au moyen d'un nom de variable d'environnement choisi par vous. La valeur est le chemin, pas une copie du contenu.

Le chemin est appliqué au démarrage de la session Terminal. Si vous modifiez la Connection ou son paramètre alors que le shell est déjà ouvert, l'interface indique que la session doit être redémarrée pour recevoir la nouvelle valeur.

C'est utile pour les scripts, SQL, configurations et rapports : le File garde la source explicite sur le Canvas et le Terminal exécute la commande sans copier de chemins entre fenêtres.

Trois façons de l'utiliser

Revoir une source existante

Connectez le File à un CodingAgent et demandez une lecture orientée vers les risques. Pour une revue visuelle, gardez le File, une Sticky Note pour les findings et un Terminal pour les contrôles dans le même graphe.

Implémenter avec une portée claire

Connectez une Specification, le File et le Builder. La Specification explique le résultat ; le File identifie la source concrète ; le CodingAgent effectue la modification et enregistre les preuves aux endroits appropriés.

Transformer un artefact en entrée exécutable

Connectez un File SQL ou script à un Terminal, nommez la variable et lancez la commande depuis le shell. Si un agent est aussi connecté, il peut aider à interpréter la sortie pendant que vous suivez le processus.

Exemples : le même élément, trois types d'entrée

Le code comme cible d'une revue

Ajoutez le fichier du client HTTP comme File, connectez un Reviewer et gardez une Sticky Note accessible pour les findings. Demandez :

Examine le File du client HTTP, notamment les délais d'expiration, le retry et la gestion des erreurs. Utilise-le comme cible de l'analyse. Si une conclusion dépend d'un autre fichier, identifie cette dépendance avant d'élargir l'enquête. Consigne uniquement les findings étayés par le code ou une reproduction et n'implémente pas de corrections.

Le résultat attendu est une revue ciblée, avec scénario et référence au passage pertinent. Le File explicite la cible ; il ne constitue pas un sandbox pour les outils natifs du harness. Délimitez le périmètre dans la demande et utilisez le Guardrail approprié pour les opérations de Kavor.

Un PDF ou une image comme référence

Gardez un PDF d'exigences ou une image de référence dans le même graphe que la Specification et le CodingAgent :

Compare le contenu du File à la Specification. Sépare exigences explicites, interprétations et questions. Pour chaque divergence, indique la page ou l'élément observé et consigne la question dans la Sticky Note. N'invente pas de contenu que tu ne peux pas lire.

Vous attendez une comparaison vérifiable, pas seulement un résumé. La capacité d'interprétation dépend du format et des outils disponibles dans le harness ; l'aperçu de Kavor garde la référence visible pour vous.

Un script comme entrée du Terminal

Créez un File pour un petit script Node.js et configurez sa Connection au Terminal avec le nom CHECK_SCRIPT :

console.log('Canvas file connection is working');

Démarrez la session Terminal après avoir configuré la Connection et exécutez :

test -n "$CHECK_SCRIPT" && node "$CHECK_SCRIPT"

Le résultat attendu est Canvas file connection is working. La variable contient le chemin du script. Si elle est vide, vérifiez le nom sur la Connection et redémarrez la session pour recevoir la configuration. Cet exemple utilise un shell POSIX et exige que Node.js soit installé ; dans PowerShell, consultez la variable avec $env:CHECK_SCRIPT et exécutez node $env:CHECK_SCRIPT.

Limites importantes

  • une Connection ne transforme pas le File en accès générique au filesystem ; le Node représente toujours sa source canonique configurée ;
  • tous les formats binaires ne sont pas éditables comme du texte ;
  • le chemin exporté au Terminal ne contient pas le corps du fichier ;
  • une Connection directe avec un CodingAgent est nécessaire pour un Guardrail propre au File ;
  • les modifications externes ou concurrentes doivent être réconciliées avant de remplacer une modification locale ;
  • être près d'un File sur le Canvas ne donne pas accès à son contenu.

Pour aller plus loin

Dernière révision 1 oct. 2026Vérifié avec Kavor 1.6.2Partager un avis sur la documentation
Modifier cette page