Guider votre agent IA comme un nouveau salarié

Comment guider un agent IA comme un nouveau salarié — accès, briques, consignes.

En bref : un agent IA n'arrive pas dans la boîte avec vos conventions en tête. Il découvre. Si vous ne montrez rien une première fois, et que vous ne consignez rien là où il le retrouvera, vous corrigerez indéfiniment les mêmes gestes. Voici comment le guider comme un nouvel arrivant. Montrez un seul collègue : votre mémoire écrite.

1. Ce n'est pas un génie, c'est un nouveau

La bonne image n'est pas « une machine qui sait tout ». C'est « un nouveau salarié qui ne connaît pas encore la boîte ». Il est brillant sur les généralités. Ignorant sur votre structure. Une boîte qui accueille bien un nouvel arrivant fait deux choses. Elle lui donne les accès dont il a besoin. Elle lui montre des exemples. Une boîte qui accueille mal fait le contraire : elle espère qu'il devine.

Le premier geste de guidage, c'est donc le démarrage. Lancez votre agent. Donnez-lui pas à pas les accès à votre structure. Pas tout d'un coup, au point où il se noie. Pas rien, au point où il tourne en rond. Les accès qui comptent — identifiants, chemins, dépôts — se posent dans un endroit sûr qu'il peut consulter. Un coffre. Plus besoin de les répéter ensuite. Il les lit, comme un salarié lit la notice de son badge.

2. Brique par brique, jamais en vrac

Personne n'arrive dans une boîte et ne comprend tout en une journée. Vous lui donnez une première brique, toute petite. Vous le laissez la construire. Vous regardez. Puis vous l'orientez vers la suivante. Le piège inverse — lui décrire les dix briques en même temps pour « gagner du temps » — produit exactement le contraire. Il entremêle. Il invente l'ordre. Il faut tout refaire.

À chaque brique, posez-lui des questions de découverte, pas des ordres. Au lieu de « fais ce script », demandez : « Est-ce que tu vois un fichier qui devrait faire ça ? ». Il fouille, il trouve, il se trompe peut-être. Vous l'orientez. C'est ainsi qu'il apprend où vivent les choses chez vous. Pas en théorie.

3. Une fonction de recherche, faite pour être tenue à jour

Très vite, le goulot ne sera plus de faire. Il sera de retrouver. Au bout de quelques briques, votre agent ne sait plus où il a rangé quoi. La réponse n'est pas de lui resservir l'information en boucle. C'est de lui faire construire, dès le début, une fonction de recherche. Un petit outil qui dit où sont les choses dans votre structure.

Voici le nœud : demandez-lui de la spécifier, puis de la coder, puis, à chaque fois que vous découvrez un nouvel endroit, mettez cette fonction à jour. Il a cherché, vous l'avez orienté, il a trouvé où vit la configuration. Cette découverte entre tout de suite dans la fonction de recherche. La fois suivante, il n'a plus à chercher. Il demande. L'outil grandit avec la boîte. Il ne devient pas obsolète.

À ne pas faire : finir la brique, découvrir l'endroit qui la rendra reproductible, et oublier de le mettre dans la fonction. Une découverte qu'on ne consigne pas a un second coût. On la paiera à chaque session suivante.

4. Montrez une fois, consignez toujours

C'est la loi la plus dure, et celle qu'on oublie le plus. Si vous ne montrez pas une fois un geste, et que vous ne le consignez pas dans un endroit qu'il consulte pour ses prochains travaux, vous aurez du mal à travailler de pair avec lui. Pas parce qu'il est lent. Parce que vous passerez à côté. Chaque fois, il refera la même erreur. Vous, la même correction.

Le bon rythme : je montre, il comprend, je l'écris là où il regardera la prochaine fois. Je vérifie qu'il l'a trouvé avant de passer à autre chose. La consigne n'est pas un compte rendu de fin de session, destiné à être oublié. C'est un outil de travail, destiné à être relu.

5. Parlez-lui comme à un collègue qu'on forme

Résumons l'attitude qui marche : parlez-lui comme si vous guidiez un nouveau salarié dans la boîte. Rassurez. Orientez. Donnez du contexte. Montrez un exemple. Ne le laissez pas deviner les règles implicites. Dans une entreprise, ce genre de règles tacites coûte des semaines à un nouveau. Chez vous, elles coûtent une session entière à chaque fois qu'elles sont tues.

Et surtout : ne gardez pas la découverte pour vous. Ce que vous avez montré une fois devient, consigné, un réflexe. L'objet n'est pas que l'agent soit plus malin. C'est que votre méthode de travail soit quelque part. Réutilisable. Indépendante de votre présence et de votre mémoire. C'est exactement la différence entre déléguer une fois et constituer une équipe.

Ce qu'on en retient : accueillez l'agent comme un nouvel arrivant. Des accès sûrs et consultables. Une brique à la fois. Des questions qui le font découvrir. Une fonction de recherche qu'il fait vivre. Chaque geste consigné là où il le relira. Ce n'est pas du confort. C'est la condition pour travailler de pair sans se répéter. La discipline, ici comme ailleurs, se scripte. Et se consigne.
🔭