Contexte de fichiers

Pourquoi le contexte de fichiers est important

Lorsque vous demandez a YeePilot de modifier un fichier de configuration, deboguer un script ou analyser un journal, l'IA fonctionne mieux lorsqu'elle peut voir le contenu reel du fichier. Le contexte de fichiers vous permet de charger des fichiers directement dans la conversation afin que l'IA puisse les referencer, comprendre leur structure et generer des commandes precises.

Sans contexte de fichiers, l'IA doit deviner les formats de fichiers et les valeurs actuelles. Avec le contexte de fichiers, elle peut voir exactement ce qui s'y trouve et proposer des modifications ciblees.

Ajouter des fichiers

Utilisez la commande /file suivie d'un chemin de fichier :

> /file /etc/nginx/nginx.conf

YeePilot lit le fichier et ajoute son contenu au contexte de l'IA. L'IA peut maintenant referencer le contenu du fichier dans ses reponses et utiliser les informations pour generer des commandes plus precises.

Vous pouvez ajouter plusieurs fichiers un par un :

> /file /etc/nginx/sites-available/myapp.conf
> /file /var/log/nginx/error.log
> /file /home/deploy/myapp/docker-compose.yml

Exemple pratique

> /file /etc/nginx/nginx.conf
Ajoute /etc/nginx/nginx.conf au contexte (2,1 Ko)
 
> Le site renvoie des erreurs 502. Verifier la config nginx pour des problemes
  et corriger ceux que tu trouves.

Avec le fichier de configuration charge, l'IA peut lire les blocs serveur reels, les definitions d'upstream et les parametres de proxy plutot que de travailler a l'aveugle.

Lister les fichiers charges

Voir quels fichiers sont actuellement dans le contexte de l'IA :

> /files

Cela affiche tous les fichiers charges avec leurs tailles :

Fichiers en contexte :
  1. /etc/nginx/nginx.conf           (2,1 Ko)
  2. /etc/nginx/sites-available/myapp.conf  (856 o)
  3. /var/log/nginx/error.log         (12,3 Ko)
 
Total : 3 fichiers, 15,3 Ko

Retirer des fichiers

Retirez un fichier du contexte lorsqu'il n'est plus necessaire :

> /unfile /var/log/nginx/error.log

Cela libere de l'espace de contexte pour d'autres fichiers ou conversations. Retirer les fichiers dont vous n'avez plus besoin aide a maintenir l'utilisation des tokens basse et garde l'IA concentree sur le contenu pertinent.

Telecharger des fichiers

La commande /upload fournit un moyen alternatif d'ajouter des fichiers :

> /upload

Cela ouvre un flux de selection de fichiers. Utilisez-la lorsque vous souhaitez ajouter des fichiers de maniere interactive plutot que de taper les chemins directement.

Limites

Le contexte de fichiers a des limites raisonnables pour eviter de submerger la fenetre de contexte de l'IA :

Les fichiers depassant la limite par fichier seront rejetes avec un message expliquant la contrainte de taille. Si la taille totale chargee devait depasser 512 Ko, vous devrez retirer certains fichiers avant d'en ajouter de nouveaux.

Ajuster les limites

Vous pouvez personnaliser ces limites dans votre fichier de configuration (~/.yeepilot/config.yaml) :

files:
  max_entries: 20
  max_file_size: 102400    # octets (100 Ko)
  max_total: 524288        # octets (512 Ko)

Augmenter ces limites utilise plus de la fenetre de contexte de l'IA par message, ce qui augmente les couts de tokens et peut declencher la compaction du contexte plus tot. Les valeurs par defaut conviennent bien a la plupart des taches d'administration de serveurs.

Panneau de diffusion en direct

Lorsque la boucle d'agent de YeePilot effectue des modifications de fichiers pendant une tache multi-etapes, le panneau de diffusion en direct affiche ces changements en temps reel. Cela vous donne une visibilite sur exactement ce que l'IA lit et modifie pendant qu'elle travaille.

Activer/Desactiver la diffusion en direct

> /livestream

Cela active ou desactive le panneau de diffusion en direct. Lorsqu'il est active, le panneau apparait a cote de la conversation principale et affiche :

• Le contenu des fichiers lus par l'IA
• Les modifications proposees mises en evidence avec des diffs
• La progression en temps reel a travers les operations multi-fichiers

La diffusion en direct est particulierement utile en mode agent lorsque l'IA travaille a travers une sequence de modifications de fichiers, comme la mise a jour de plusieurs fichiers de configuration ou l'application d'un ensemble de changements dans un projet.

Flux de travail courants

Examen de configuration

Chargez un fichier de configuration et demandez a l'IA de l'examiner :

> /file /etc/ssh/sshd_config
> Examiner cette configuration SSH pour des problemes de securite et suggerer des changements de durcissement

L'IA lit les valeurs de configuration reelles et fournit des recommandations specifiques avec les modifications exactes des lignes.

Analyse de journaux

Chargez un fichier de journal pour obtenir de l'aide a comprendre les erreurs :

> /file /var/log/syslog
> Quelles erreurs se sont produites dans la derniere heure ? Resumer les problemes.

Pour les fichiers de journal volumineux qui depassent la limite de taille, utilisez plutot l'IA pour lire des sections specifiques :

> Montre-moi les 200 dernieres lignes de /var/log/syslog qui contiennent "error" ou "fail"

Contexte multi-fichiers

Lorsque vous travaillez sur une tache impliquant plusieurs fichiers lies, chargez-les tous :

> /file /etc/nginx/nginx.conf
> /file /etc/nginx/sites-available/api.conf
> /file /etc/letsencrypt/renewal/api.example.com.conf
> /file docker-compose.yml
 
> Configurer nginx comme reverse proxy pour le service Docker sur le port 3000
  avec SSL en utilisant le certificat Let's Encrypt existant

Avec tous les fichiers pertinents charges, l'IA peut croiser la configuration du service Docker, les chemins des certificats SSL existants et la configuration nginx actuelle pour generer une configuration complete et correcte.

Developpement de scripts

Chargez un script existant pour obtenir de l'aide pour l'etendre ou le deboguer :

> /file /home/deploy/backup.sh
> Ce script de sauvegarde echoue silencieusement. Ajouter une gestion d'erreurs
  appropriee et envoyer une notification par e-mail en cas d'echec.

L'IA voit la structure actuelle du script et peut ajouter une gestion d'erreurs qui s'integre au style de codage et au flux logique existants.

Conseils

• Chargez les fichiers avant de poser des questions a leur sujet. L'IA donne de bien meilleures reponses lorsqu'elle peut voir le contenu reel plutot que de deviner.
• Retirez les fichiers dont vous n'avez plus besoin. Cela garde le contexte propre et les couts bas.
• Utilisez /files pour verifier ce qui est charge avant de commencer une nouvelle tache. Les fichiers restants d'une tache precedente peuvent perturber l'IA.
• Pour les fichiers tres volumineux, demandez a l'IA de lire des sections specifiques avec des commandes comme head, tail ou grep plutot que de charger le fichier entier dans le contexte.