Boucle d'agent

Qu'est-ce que la boucle d'agent ?

Le mode standard dans YeePilot suit un schema simple : vous demandez, l'IA propose une commande, vous approuvez, elle s'execute. La boucle d'agent va plus loin. Elle permet a l'IA de travailler sur des taches complexes en plusieurs etapes en lisant des fichiers, en executant des commandes, en analysant la sortie et en decidant quoi faire ensuite -- tout en vous gardant dans la boucle d'approbation pour chaque commande.

Pensez-y comme la difference entre donner une instruction a la fois a quelqu'un et decrire un objectif en le laissant determiner les etapes.

Activer la boucle d'agent

Il existe deux facons d'activer le mode agent :

Utiliser la commande slash

Tapez /think dans le chat pour activer la reflexion etendue pour la session en cours :

> /think
Mode agent active (reflexion : on)

Vous pouvez egalement specifier une intensite de reflexion :

> /think high
Mode agent active (reflexion : high)

Via la configuration

Pour activer le mode agent par defaut, definissez-le dans votre fichier de configuration (~/.yeepilot/config.yaml) :

ai:
  agent_mode: true

Comment ca fonctionne

Lorsque vous decrivez une tache complexe en mode agent, YeePilot suit cette boucle :

1. Analyser -- L'IA decompose votre requete et determine la premiere etape
2. Proposer -- Elle genere une ou plusieurs commandes pour l'etape en cours
3. Approuver -- Vous examinez et approuvez (ou rejetez) les commandes proposees
4. Executer -- Les commandes approuvees s'executent et la sortie est capturee
5. Evaluer -- L'IA lit la sortie, determine si l'objectif est atteint et decide l'etape suivante
6. Repeter -- Les etapes 2 a 5 se repetent jusqu'a ce que la tache soit terminee ou que la limite d'iteration soit atteinte

L'IA peut effectuer jusqu'a 25 iterations par tache avant de s'arreter. Cette limite empeche les boucles infinies et garde les couts previsibles.

Exemple : Diagnostiquer un serveur lent

> L'application sur le port 8080 repond lentement. Diagnostiquer le probleme.

En mode agent, YeePilot pourrait travailler a travers cette sequence :

1. Verifier si le processus est en cours d'execution et son utilisation des ressources (ps, top)
2. Examiner les journaux recents de l'application pour des erreurs
3. Verifier les ressources systeme (CPU, memoire, disque, E/S)
4. Examiner les connexions reseau et l'etat des sockets
5. Revoir les changements ou deploiements recents du systeme
6. Resumer les conclusions et suggerer des correctifs

A chaque etape, vous voyez les commandes proposees, les approuvez et voyez les resultats avant que l'IA passe a l'etape suivante.

Modes de reflexion etendue

La commande /think accepte un argument de mode qui controle le niveau de raisonnement de l'IA avant de generer des commandes :

Les modes de reflexion superieurs utilisent plus de tokens par etape mais produisent une analyse plus approfondie. Pour les taches de routine, low ou le mode on par defaut est generalement suffisant. Pour diagnostiquer des problemes obscurs, high donne a l'IA plus d'espace pour examiner les possibilites.

Ce que l'IA peut faire en mode agent

Pendant la boucle d'agent, l'IA a acces a plusieurs outils :

Executer des commandes

L'outil principal. L'IA propose des commandes shell pour votre approbation et execution. Chaque commande passe toujours par la validation des risques et necessite votre confirmation.

Lire des fichiers

L'IA peut lire des fichiers sur votre systeme pour recueillir du contexte. Par exemple, lire un fichier de configuration avant de suggerer des modifications, ou examiner un fichier de log pour comprendre une erreur.

Lecture de /etc/nginx/nginx.conf ...
 
D'apres la configuration, worker_processes est defini a 1.
Etant donne que ce serveur a 8 coeurs CPU, je recommande de l'augmenter.
 
Plan :
  1. sed -i 's/worker_processes 1/worker_processes 8/' /etc/nginx/nginx.conf
 
Executer ? [O/n]

Lister les fichiers

L'IA peut lister le contenu des repertoires pour comprendre la structure du projet, trouver des fichiers pertinents ou verifier que les fichiers attendus existent.

Rechercher

L'IA peut rechercher dans le contenu des fichiers des motifs specifiques, l'aidant a localiser des valeurs de configuration, des messages d'erreur ou des references de code.

Garder le controle

Le mode agent ne contourne aucun mecanisme de securite :

• Chaque commande necessite votre approbation. L'IA ne peut rien executer sans que vous appuyiez sur Entree.
• La classification des risques s'applique toujours. Les commandes DANGEROUS sont signalees. Les commandes BLOCKED sont refusees.
• Vous pouvez arreter a tout moment. Appuyez sur Ctrl+C ou tapez "stop" pour mettre fin a la boucle d'agent et revenir au mode standard.
• La limite de 25 iterations empeche les boucles infinies. Si l'IA n'a pas termine la tache en 25 etapes, elle s'arrete et resume sa progression.

Quand utiliser le mode agent

Le mode agent est le plus utile pour :

• Les flux de diagnostic ou l'etape suivante depend de la sortie de la precedente
• Les configurations multi-services qui necessitent la configuration de plusieurs composants en sequence
• Le depannage lorsque la cause racine est inconnue et necessite une investigation
• Les audits systeme qui verifient plusieurs aspects de la configuration d'un serveur

Pour les taches simples a une seule commande ("montre-moi l'utilisation disque"), le mode standard est plus rapide et plus efficace.

Conseils pour le mode agent

• Soyez specifique sur votre objectif. "Configurer un reverse proxy pour l'application sur le port 3000 avec SSL via Let's Encrypt" donne a l'IA une cible claire vers laquelle travailler.
• Commencez avec /think medium pour la plupart des taches. Passez a high si l'IA semble manquer des considerations importantes.
• Surveillez l'utilisation des tokens. Le mode agent consomme plus de tokens que le mode en une seule etape. Utilisez Ctrl+S pour verifier votre utilisation.
• Laissez l'IA terminer son analyse avant d'interrompre avec de nouvelles instructions. Si vous la redirigez en pleine boucle, l'IA perd le fil de son investigation.