Contexte et limites
- Leçon 3
- 45 min
- Module 1 : Mettre en place un environnement de travail sûr
Où nous en sommes
Dans la dernière leçon, nous avons préparé un point de départ propre, pour que chaque modification de l'assistant apparaisse dans les différences. Mais les différences montrent un changement seulement après coup. Un assistant serviable peut aussi lire un secret, installer un paquet ou pousser vers un dépôt distant. Dans cette leçon, nous notons ce qu'il peut lire, modifier et exécuter avant qu'il commence, comme une note laissée à la personne qui garde votre appartement.
Leçon 3 sur 15 · Développement logiciel assisté par l'IAContexte et limites
1. Mettre en place un environnement de travail sûr
2. Rédiger des tâches exploitables
3. Réviser le travail généré
4. Déboguer et tester avec l'assistant
5. Livrer un travail facile à maintenir
Ce que vous saurez faire
Avant de commencer, notez ce qu’un assistant de programmation peut lire, modifier et exécuter dans votre projet. Un court fichier de périmètre précise les fichiers, les secrets, les commandes à réviser et les actions qui dépassent votre ordinateur.
Avant de commencerCe qu’il faut savoir et avoir sous la main
Ce que vous devez savoir
- Les trois modes d’assistant et ce que chacun peut toucher, vus dans Modes d’interaction avec l’assistant.
- Les paramètres de
ticket-cleaner, le secretTICKETS_API_TOKENet.env.example, vus dans Configuration et secrets du cours Python pour l’ingénierie de l’IA en pratique. .gitignore, vu dans Garder le dépôt propre du cours L’essentiel de Git et du développement en équipe.
Ce qu’il vous faut sur votre ordinateur
- Le projet
~/projects/ticket-cleaner-assistde Préparer le dépôt, sur la branchefeature/category-option, avec son environnement actif.python -m pytestaffiche25 passed(25 tests réussis), etgit statusindiqueworking tree clean(répertoire de travail propre). - Si le projet manque ou ne fonctionne plus, renommez-le et recréez-le avec les étapes de Mettre en place le projet et Fixer le rapport avec un test.
Une note pour la personne qui garde votre appartement
Section intitulée « Une note pour la personne qui garde votre appartement »Vous partez une semaine et un voisin s’occupe de votre appartement. Vous laissez une clé et une note sur la table de cuisine :
- Vous pouvez utiliser la cuisine. Veuillez arroser les plantes.
- N’ouvrez pas le bureau dans la pièce de travail. Il contient mes documents bancaires.
- Appelez-moi avant de laisser entrer quelqu’un ou de signer pour un colis.
- Ne payez aucune facture pour moi, même si quelqu’un dit que c’est urgent.
La note ne dit pas que votre voisin est malhonnête. Elle précise les pièces, les objets précieux, les décisions qui vous reviennent et les actions qui dépassent l’appartement. Sans elle, un voisin serviable doit deviner. Et une supposition bien intentionnée peut être fausse.
Le problème : un assistant serviable décide des limites
Section intitulée « Le problème : un assistant serviable décide des limites »L’équipe du cours a donné cette requête à un assistant, avec les fichiers de ticket_cleaner/ (transcription refactor-open) :
Refactor the code in ticket_cleaner/ to make it cleaner and easier to maintain.L’assistant a modifié 3 fichiers, ajouté 40 lignes et supprimé 21 lignes. Les 24 tests ont réussi. Une des modifications a réécrit write_json() dans files.py, la fonction qui écrit chaque rapport de façon sûre :
temporary = path.with_name(path.name + ".tmp")with open(temporary, "w", encoding="utf-8") as file: json.dump(data, file, indent=2, ensure_ascii=False) file.write("\n")os.replace(temporary, path)temporary: Path | None = Nonetry: with NamedTemporaryFile(Le nouveau code est peut-être correct. Mais personne n’a demandé une nouvelle façon d’écrire les rapports, et tous les rapports du projet passent maintenant par ce code. Le bogue de Grace, la raison d’examiner ce code maintenant, était toujours présent après la session. La requête ne fixait aucune limite. L’assistant les a donc fixées lui-même.
Un agent peut faire plus que modifier des fichiers. Si vous le permettez, il exécute des commandes, dont certaines dépassent votre ordinateur. pip install télécharge du code sur Internet et en exécute une partie. python -m ticket_cleaner remote envoie une requête à un service Web, avec le jeton si vous en avez défini un. git push publie vos commits (modifications enregistrées) pour l’équipe. Une conversation dépasse aussi votre ordinateur : tout ce que vous collez va sur les serveurs du fournisseur.
L’idée : un périmètre écrit
Section intitulée « L’idée : un périmètre écrit »Le périmètre d’un assistant définit ce qu’il peut lire, modifier et exécuter dans un projet. Notez-le dans un court fichier du projet, en quatre parties, comme la note pour votre voisin :
- Fichiers : ceux qu’il peut modifier, ceux qu’il peut seulement lire et ceux qu’il ne doit jamais ouvrir.
- Secrets : leur emplacement et la règle interdisant de les inclure dans une requête (prompt), un journal ou un fichier.
- Commandes : celles qu’il peut exécuter et celles que vous devez d’abord réviser.
- Actions externes : tout ce qui dépasse cet ordinateur, comme un téléchargement, un téléversement, un message ou un envoi au dépôt distant.
Un périmètre est une demande, pas un verrou. Un modèle peut ignorer une phrase de sa requête. Le fichier de périmètre a donc deux fonctions. Il indique les limites à l’assistant. Et il vous donne une liste pour vérifier les différences et la session. Les vrais verrous sont les paramètres de l’outil et l’endroit où l’assistant travaille.
Un petit exemple : classer six commandes
Section intitulée « Un petit exemple : classer six commandes »Pour rédiger la partie sur les commandes, classez chaque commande selon ce qu’elle peut toucher. Il y a trois groupes : lecture seulement, modification de fichiers sur cet ordinateur ou accès à l’extérieur.
| Commande | Ce qu’elle touche | Groupe |
|---|---|---|
python -m pytest |
lit le code. Elle écrit seulement dans le dossier de cache .pytest_cache/, que Git ignore. Les tests écrivent dans des dossiers temporaires. |
lecture seulement |
ruff check . |
lit le code, écrit seulement dans .ruff_cache/ |
lecture seulement |
ruff format . |
réécrit chaque fichier dont le format est incorrect | modifie des fichiers locaux |
python -m ticket_cleaner data/tickets.csv |
écrit reports/summary.json |
modifie des fichiers locaux |
pip install some-package |
télécharge un paquet depuis PyPI, peut exécuter son code pendant l’installation et modifie .venv/ |
accède à l’extérieur et modifie des fichiers locaux |
git push |
envoie vos commits à un autre dépôt | accède à l’extérieur |
Le premier groupe peut s’exécuter à tout moment. Le deuxième demande d’examiner git diff après l’exécution. Le troisième exige votre décision avant l’exécution. Une règle simplifie le dernier groupe : un assistant n’accède pas à l’extérieur de sa propre initiative.
Écrire le fichier de périmètre pour ticket-cleaner
Section intitulée « Écrire le fichier de périmètre pour ticket-cleaner »Amira écrit ASSISTANT-SCOPE.md dans le dossier du projet, avec Kwame. Pour chaque partie, Kwame pose sa question habituelle : « Que peut toucher l’assistant ici? » Voici le résultat. Il se trouve aussi dans l’instantané end-of-m01 :
# What a coding assistant may do in this project
This file is for anyone who uses a coding assistant on ticket-cleaner: a chatwindow, completions in an editor, or an agent that changes files and runscommands. Give it to the assistant with each task, and check its work against it.
## Files
| Files | The assistant may ||---|---|| `ticket_cleaner/*.py`, `tests/*.py` | read and change them, for the task only || `README.md`, `DECISIONS.md`, `docs/` | read them; change them when the task changes what they say || `data/` | read them; never change, add or delete a data file || `requirements.txt`, `requirements-lock.txt`, `pyproject.toml` | read them; a change needs my review first (see "Dependencies") || `.env.example` | read it; never add a real value || `.env`, `.venv/`, `reports/`, `.git/` | never read or change them |
## Secrets
- `TICKETS_API_TOKEN` is a secret. It is only in my terminal or in `.env`, which is in `.gitignore`. The assistant never sees, prints, logs or writes it.- Never paste a token, a password or a customer's personal data into a prompt. The sample data in `data/` is made up.
## Commands
| Command | Rule ||---|---|| `python -m pytest`, `ruff check .`, `ruff format --check .` | may run at any time: they only read the code || `python -m ticket_cleaner <file> --output <path>` | may run with a file in `data/` and an output in `reports/` or a temporary folder || `ruff format .` | changes files: I review the diff after it || `pip install`, `pip uninstall` | **never without my review**: I check the package first (see "Dependencies") || `git commit`, `git push`, `git checkout`, `git reset`, `rm` | **I run them myself**, after I read the diff || `python -m ticket_cleaner remote` | **needs my review**: it connects to a web service |
## External actions
The assistant does not send anything outside this computer: no web requests, nouploads, no messages, no pull requests. The only command that uses the networkis `remote`, and I run it myself.
## Dependencies
Before a new package is added, I check on https://pypi.org that it exists, thatit is maintained, that its licence fits this project (MIT), and that theproject really needs it. The standard library comes first.
## Every change
- Work happens on a branch, never on `main`.- I read the whole diff before I accept it, and I run the tests and ruff myself.- A change that is not in the task goes into a separate task.Chaque règle a une raison que vous avez déjà rencontrée :
- « Pour la tâche seulement » répond à la session de réusinage ci-dessus. Une modification hors de la tâche devient une tâche distincte, avec sa propre révision.
data/est en lecture seule, car le test de référence de base et le rapport de Grace dépendent de ces lignes exactes. Un fichier de données « nettoyé » ferait paraître correct un programme défectueux..envn’est jamais ouvert, car c’est le seul fichier qui pourrait contenir le vrai jeton..gitignorel’exclut déjà de Git. Un agent qui construit sa carte à partir de Git, comme Aider, ne le liste donc pas.- Les dépendances exigent votre révision, car un modèle peut inventer un nom de paquet. Vérifier les dépendances examine les noms réels et inventés.
- Les commandes Git vous reviennent. Un commit dit « J’ai lu ceci et je l’accepte », et vous seul pouvez le dire. Un
git resetou unrmpeut supprimer du travail qui ne figure dans aucun commit.
Description textuelle du diagramme
Le diagramme comporte trois zones imbriquées. La zone intérieure est le dossier du projet, avec quatre groupes de fichiers. ticket_cleaner/.py et tests/.py peuvent changer, pour la tâche seulement. README.md, DECISIONS.md et docs/ changent seulement si la tâche change leur contenu. data/, les fichiers requirements, pyproject.toml et .env.example sont en lecture seule, et une modification exige une révision. .env, .venv/, reports/ et .git/ ne sont jamais lus ni modifiés. La zone centrale est le terminal sur cet ordinateur. Les commandes qui lisent seulement le code peuvent s’exécuter : python -m pytest, ruff check . et ruff format –check . Une flèche nommée « lecture » va de ces commandes au code. Les commandes qui modifient les fichiers locaux sont ruff format . (réviser les différences après), le programme avec –output reports/…, et git commit, que vous exécutez vous-même. Une flèche nommée « écriture » va de ces commandes aux fichiers. La zone extérieure est hors de cet ordinateur : les services externes. Trois flèches rouges y entrent. pip install va vers PyPI, l’index de paquets. python -m ticket_cleaner remote va vers le service Web de billets. git push va vers le dépôt distant de l’équipe. Vous révisez ou exécutez vous-même ces trois commandes.
Un bac à sable : une limite qui ne dépend pas du modèle
Section intitulée « Un bac à sable : une limite qui ne dépend pas du modèle »Le fichier de périmètre demande. Un bac à sable impose. C’est un endroit où un programme peut travailler sans atteindre ce qui compte pour vous. Le nom évoque le bac à sable d’un enfant : creusez autant que vous voulez, le jardin reste intact.
L’équipe a enregistré chaque session de ce cours dans un bac à sable simple. C’est un bon modèle pour votre travail :
Description textuelle du diagramme
Le diagramme montre une zone verte en pointillés, le bac à sable : un dossier temporaire sur l’ordinateur de l’auteur. Il contient une nouvelle copie de start dans un nouveau dépôt Git, facile à comparer et à jeter. L’assistant, Aider, fonctionne avec les commandes shell et les commits désactivés. Son dossier personnel est le dossier temporaire. Il ne lit donc pas les paramètres personnels de l’auteur. Il pouvait exécuter les tests seulement dans les quelques échanges qui les autorisaient. Sa clé est factice, pas la vraie clé. L’assistant modifie les fichiers de la copie, et chaque modification apparaît dans git diff. Ses requêtes passent par un serveur mandataire de journalisation, qui ajoute la vraie clé et enregistre chaque requête et réponse dans un journal. Le serveur mandataire envoie la requête au modèle sur Azure, hors de l’ordinateur. Hors du bac à sable, en rouge, se trouvent les projets personnels de l’auteur, les paramètres de l’éditeur et de l’assistant, et les autres clés. L’assistant ne peut pas y accéder.
Chaque élément est un vrai paramètre du script d’enregistrement, par exemple --no-suggest-shell-commands et --no-auto-commits. La vraie clé existait seulement dans le serveur mandataire. Aucune transcription ni aucun journal ne la contient donc.
Vous pouvez construire un bac à sable plus simple avec vos connaissances. Travaillez dans une copie, comme ticket-cleaner-assist, jamais dans la seule copie d’un projet. Faites un commit avant chaque session pour que git restore . puisse annuler les modifications. Utilisez les paramètres de votre outil pour désactiver les commandes indésirables ou demander votre accord avant chacune. Et gardez les secrets hors du dossier et du terminal où l’assistant travaille.
Ajouter le fichier de périmètre à votre projet
Section intitulée « Ajouter le fichier de périmètre à votre projet »-
Dans
~/projects/ticket-cleaner-assist, vérifiez l’état de départ :Fenêtre de terminal git statusLa sortie doit indiquer
On branch feature/category-option(sur la branche feature/category-option) etnothing to commit, working tree clean(rien à enregistrer, répertoire de travail propre). -
Copiez le fichier de périmètre depuis l’instantané
end-of-m01:Fenêtre de terminal cp ../nextia-learning-labs/C15/snapshots/end-of-m01/ASSISTANT-SCOPE.md .Fenêtre de terminal Copy-Item ..\nextia-learning-labs\C15\snapshots\end-of-m01\ASSISTANT-SCOPE.md .Vous pouvez aussi le saisir vous-même à partir de l’encadré ci-dessus. La vérification de l’étape suivante détectera alors toute erreur de saisie.
-
Lisez le fichier dans votre éditeur, une règle à la fois. Pour chaque règle, nommez sa partie : fichiers, secrets, commandes ou actions externes.
-
Faites un commit :
Fenêtre de terminal git add ASSISTANT-SCOPE.mdgit commit -m "Write down what an assistant may do in this project"git log --onelineSortie [feature/category-option 03e50ea] Write down what an assistant may do in this project1 file changed, 52 insertions(+)create mode 100644 ASSISTANT-SCOPE.md03e50ea Write down what an assistant may do in this project245d23e Pin today's report of the sample file2498e15 StartVos empreintes sont différentes.
-
Exécutez de nouveau les vérifications :
Fenêtre de terminal python -m pytestruff check .ruff format --check .Output (the end of each command) ============================== 25 passed in 0.04s ==============================All checks passed!17 files already formattedruff vérifie aussi le format des fichiers Markdown. Il compte donc un fichier de plus.
-
Sur macOS et Linux, comparez votre projet à l’instantané. Les dossiers créés par vous-même, comme
.venv, sont exclus :Fenêtre de terminal diff -rq . ../nextia-learning-labs/C15/snapshots/end-of-m01 -x .git -x .venv -x reports -x __pycache__ -x .pytest_cache -x .ruff_cacheLa commande n’affiche rien : votre projet correspond à
end-of-m01. Sur Windows, sautez cette étape.
Donner le périmètre à l’assistant
Section intitulée « Donner le périmètre à l’assistant »La façon dont l’assistant reçoit le fichier dépend du mode :
- Conversation : collez les parties utiles à la tâche avant la tâche elle-même. La conversation ne peut pas exécuter de commandes. Les parties fichiers et secrets comptent donc le plus.
- Complétion : le périmètre vous sert pendant que vous acceptez ou refusez chaque suggestion.
- Agent : ajoutez le fichier à la session comme fichier à lire, pas à modifier. Plusieurs agents peuvent aussi lire un fichier d’instructions du projet au début de chaque session. La documentation de votre outil donne son nom. Utilisez ensuite les paramètres de l’outil pour que les commandes exigent votre approbation.
Dans chaque mode, le périmètre reste votre liste de vérification. Après la session, comparez git diff --stat à la partie fichiers, et les commandes de la session à la partie commandes.
Quand écrire un périmètre et ce qu’il coûte
Section intitulée « Quand écrire un périmètre et ce qu’il coûte »Écrivez-en un avant la première session de chaque projet et gardez-le court : un écran. Cela prend quelques minutes. Mettez-le à jour quand le projet change, par exemple avec un nouveau secret ou une nouvelle commande qui accède à l’extérieur.
Un périmètre a un coût. Un périmètre strict bloque du travail utile : si l’assistant ne peut pas modifier README.md, il ne peut pas documenter l’option ajoutée. Voilà pourquoi le fichier dit « si la tâche change leur contenu », et non « jamais ». Et un périmètre ne rend jamais une modification correcte. Il limite les endroits où les erreurs peuvent survenir. La révision dans le module Examiner le travail généré les trouve.
Erreur courante
Un secret se retrouve dans une requête
Symptôme : un test de l’entrée remote échoue avec une erreur du service Web. Pour obtenir de l’aide, vous collez la sortie et votre fichier .env dans une conversation. La réponse est utile. Plus tard, vous remarquez que le vrai TICKETS_API_TOKEN est dans la conversation.
Cause : tout ce que vous collez dans une conversation va sur les serveurs du fournisseur. Cela peut rester dans votre historique, dans les journaux du fournisseur et dans toute copie de la conversation que vous partagez. Un secret qui a quitté votre ordinateur n’est plus un secret.
Correction : considérez le jeton comme divulgué. Demandez un nouveau jeton au propriétaire du service et invalidez l’ancien, même si rien de grave n’est encore arrivé. Suivez ensuite le périmètre : collez seulement .env.example, dont les valeurs sont vides, et remplacez toute vraie valeur par un substitut comme <token>. Le code des paramètres du cours Python pour l’ingénierie de l’IA en pratique exclut déjà le jeton de la sortie du programme, avec field(repr=False).
Exercice du module : un projet jetable avec son propre périmètre
Section intitulée « Exercice du module : un projet jetable avec son propre périmètre »L’exercice du module : préparez un projet jetable et documentez le périmètre d’une nouvelle tâche. Un projet jetable est une copie que vous pouvez supprimer à tout moment. Utilisez-le pour expérimenter et essayer un nouvel assistant.
Voici votre tâche : un assistant ajoutera des tests pour count_by_category() dans report.py, et rien d’autre.
- Dans
~/projects, copiez l’instantanéend-of-m01dans un nouveau dossier,ticket-cleaner-try. - Créez son environnement, un dépôt Git avec un commit et une branche
try/tests-only. - Vérifiez la référence de base :
python -m pytestaffiche25 passed. - Remplacez son
ASSISTANT-SCOPE.mdpar un périmètre pour cette tâche seulement. Utilisez les quatre parties. Réfléchissez aux fichiers que l’assistant peut modifier maintenant et à ceux qu’il peut seulement lire. - Faites un commit du périmètre. Supprimez ensuite le dossier : il était jetable.
Afficher un exemple de réponse
Les commandes, sur macOS et Linux (sur Windows, utilisez Copy-Item -Recurse, python -m venv .venv et .venv\Scripts\Activate.ps1, comme dans la dernière leçon) :
cd ~/projectscp -R nextia-learning-labs/C15/snapshots/end-of-m01 ticket-cleaner-trycd ticket-cleaner-trypython3 -m venv .venvsource .venv/bin/activatepython -m pip install -r requirements-lock.txtgit initgit add -Agit commit -m "Start"git switch -c try/tests-onlypython -m pytestLa dernière ligne est 25 passed. Voici un périmètre possible :
# What a coding assistant may do in this copy
Task: add tests for `count_by_category()` in `ticket_cleaner/report.py`.This folder is a disposable copy: I delete it when the task is done.
## Files
| Files | The assistant may ||---|---|| `tests/*.py` | read and change them; add a new test file || `ticket_cleaner/*.py` | read them only: a test must not change the code || `data/`, `README.md`, `requirements*.txt`, `pyproject.toml` | read them only || `.env`, `.venv/`, `reports/`, `.git/` | never read or change them |
## Commands
| Command | Rule ||---|---|| `python -m pytest`, `ruff check .`, `ruff format --check .` | may run at any time || `ruff format tests/` | changes files: I review the diff after it || `pip install`, `git commit`, `git push`, `rm` | never: I decide and run them myself |
## Secrets and external actions
No secret is needed for this task. Nothing leaves this computer: no `remote`,no `pip install`, no push.Ensuite :
git add ASSISTANT-SCOPE.mdgit commit -m "Scope for the tests-only task"python -m pytestcd ..rm -rf ticket-cleaner-trypytest affiche toujours 25 passed : le fichier de périmètre ne modifie aucun code. Sur Windows, supprimez le dossier avec Remove-Item -Recurse -Force ticket-cleaner-try.
La principale différence avec le fichier d’Amira tient en une ligne : ticket_cleaner/*.py est maintenant en lecture seule. Une tâche « ajouter des tests » qui modifie le code testé est une autre tâche. Si les nouveaux tests trouvent un bogue, l’assistant le signale, et vous décidez de la suite. Votre fichier peut utiliser d’autres mots. Vérifiez qu’il contient les quatre parties et qu’un réviseur pourrait dire « cette ligne des différences dépasse le périmètre ».
Vérification du module
Section intitulée « Vérification du module »La vérification de fin du module : indiquez quelles actions modifient les fichiers locaux et lesquelles touchent des systèmes hors de votre ordinateur. Classez ces huit actions en trois groupes : lecture seule, modification de fichiers locaux, accès à l’extérieur. Certaines actions appartiennent à deux groupes.
python -m pytestruff format .python -m ticket_cleaner data/tickets.csvgit commit -m "Add the option"git restore .pip install -r requirements-lock.txtpython -m ticket_cleaner remotegit push, et collercli.pydans une fenêtre de clavardage
Afficher la réponse
| Action | Groupe | Pourquoi |
|---|---|---|
python -m pytest |
lecture seule | lit le code; Git ignore son dossier de cache |
ruff format . |
modification de fichiers locaux | réécrit les fichiers dont le format est incorrect : examinez git diff ensuite |
python -m ticket_cleaner data/tickets.csv |
modification de fichiers locaux | écrit dans reports/summary.json |
git commit |
modification de fichiers locaux | ajoute un commit (enregistrement des modifications) à .git/; rien ne quitte l’ordinateur |
git restore . |
modification de fichiers locaux | rétablit les fichiers enregistrés dans un commit et supprime les modifications non enregistrées |
pip install -r requirements-lock.txt |
accès à l’extérieur et modification de fichiers locaux | télécharge des paquets depuis PyPI, puis modifie .venv/ |
python -m ticket_cleaner remote |
accès à l’extérieur et modification de fichiers locaux | envoie une requête au service web, avec le jeton s’il est défini, puis écrit le rapport |
git push |
accès à l’extérieur | envoie des commits à un autre dépôt. Dans le cours sur Git, c’était un dossier sur votre ordinateur; en équipe, c’est un serveur |
coller cli.py dans un clavardage |
accès à l’extérieur | le texte va aux serveurs du fournisseur |
Le fichier de limites soumet le deuxième groupe à votre révision, et le troisième à votre décision.
Vous avez terminé le module quand vous pouvez aussi montrer ces résultats dans votre propre projet :
git log --onelineaffiche trois commits surfeature/category-option:Start(début),Pin today's report of the sample file(figer le rapport actuel du fichier d’exemple) etWrite down what an assistant may do in this project(consigner ce qu’un assistant peut faire dans ce projet).python -m pytestaffiche25 passed(25 tests réussis), et vous pouvez expliquer ce que protègetests/test_baseline.py.- Vous pouvez expliquer chaque partie de
ASSISTANT-SCOPE.md, et pourquoi un fichier de limites n’est pas un verrou à lui seul.
Réinitialisation. Si votre projet ne fonctionne plus, renommez-le et recréez-le à partir de deux instantanés. main reçoit l’instantané start du cours, comme dans Préparer le dépôt. La branche reçoit l’instantané du dernier module terminé, dans un seul commit. Dans ~/projects, sur macOS et Linux :
mv ticket-cleaner-assist ticket-cleaner-assist-oldcp -R nextia-learning-labs/C15/snapshots/start ticket-cleaner-assistcd ticket-cleaner-assistpython3 -m venv .venvsource .venv/bin/activatepython -m pip install -r requirements-lock.txtgit initgit add -Agit commit -m "Start"git switch -c feature/category-optioncp -R ../nextia-learning-labs/C15/snapshots/end-of-m01/. .git add -Agit commit -m "Copy the snapshot end-of-m01"python -m pytestLa dernière ligne est 25 passed. Les modules suivants utilisent les mêmes étapes, avec leur propre instantané aux deux endroits contenant end-of-m01. main reste toujours au point de départ du cours. Ainsi, la demande de tirage (pull request) du module 5 montre l’ensemble des modifications.
Après une réinitialisation, le dépôt contient deux commits plutôt que trois : Start sur main, et un commit sur la branche. Les vérifications des modules suivants comptent les commits des étapes des leçons. Vous en avez donc moins après une réinitialisation. Ce n’est pas un problème : les fichiers, les tests et la vérification diff -rq sont ce qui compte.
Sur Windows, dans PowerShell : Rename-Item ticket-cleaner-assist ticket-cleaner-assist-old, puis Copy-Item -Recurse nextia-learning-labs\C15\snapshots\start ticket-cleaner-assist. Utilisez python -m venv .venv et .venv\Scripts\Activate.ps1. Pour la deuxième copie, utilisez Copy-Item -Recurse -Force ..\nextia-learning-labs\C15\snapshots\end-of-m01\* .. Les commandes Windows n’ont pas été testées.
Vérification des connaissances
Section intitulée « Vérification des connaissances »Vérifiez votre compréhension
Nommez les quatre parties d'un fichier de limites, avec une règle de ASSISTANT-SCOPE.md pour chacune.
Afficher la réponse
- Fichiers :
ticket_cleaner/*.pyettests/*.pypeuvent changer, uniquement pour la tâche;data/est en lecture seule;.envn’est jamais lu ni modifié. - Secrets :
TICKETS_API_TOKENreste uniquement dans votre terminal ou dans.env. Il ne va jamais dans une requête (prompt), un journal ou un fichier. - Commandes :
python -m pytestetruff check .peuvent être exécutées à tout moment.pip installne s’exécute jamais sans votre révision. Vous exécutez vous-mêmegit commitetgit push. - Actions externes : l’assistant n’envoie rien hors de cet ordinateur. La seule commande qui utilise le réseau est
remote, et vous l’exécutez vous-même.
Votre réponse contient-elle les points principaux de la nôtre ?
Connectez-vous et inscrivez-vous au cours pour enregistrer vos réponses. Chaque vérification compte pour le certificat.
Vérifiez votre compréhension
Tomás dit : « On a écrit le fichier de limites et on l'a donné à l'agent. Maintenant, il ne peut plus toucher à .env. » A-t-il raison? Qu'est-ce qui limite vraiment un agent?
Afficher la réponse
Il a tort. Un fichier de limites est du texte dans la requête. Un modèle peut l’ignorer ou mal le comprendre. Ce fichier ne limite rien à lui seul. Deux choses limitent un agent. La première est la configuration de son outil : aucune commande shell, par exemple, ou une approbation avant chaque commande. La deuxième est son environnement de travail : une copie du projet enregistrée dans un commit, sans secret dans le dossier ni le terminal. C’est un bac à sable. Le fichier de limites reste important : il indique les limites à l’assistant. Il vous sert aussi de liste de vérification pour réviser les différences et la session.
Votre réponse contient-elle les points principaux de la nôtre ?
Connectez-vous et inscrivez-vous au cours pour enregistrer vos réponses. Chaque vérification compte pour le certificat.
Vérifiez votre compréhension
Dans la session refactor-open, la demande « rendre le code plus propre » a modifié write_json() dans files.py. Tous les tests ont réussi. Quelle ligne de ASSISTANT-SCOPE.md un réviseur utiliserait-il pour contester cette modification? Pourquoi est-ce important ici?
Afficher la réponse
« Lisez-les et modifiez-les, uniquement pour la tâche » et « Une modification hors de la tâche va dans une tâche distincte. » La tâche concernait l’option de catégorie ou le bogue de Grace, pas une nouvelle façon d’écrire les fichiers. write_json() écrit tous les rapports du projet. Une modification à cet endroit exige donc sa propre révision et ses propres tests, même si elle semble être une amélioration. Les tests réussis ne répondent pas à cette question : ils montrent seulement que les tests existants réussissent encore.
Votre réponse contient-elle les points principaux de la nôtre ?
Connectez-vous et inscrivez-vous au cours pour enregistrer vos réponses. Chaque vérification compte pour le certificat.
Récapitulatif
Cette leçon
- Les limites d’un assistant définissent ce qu’il peut lire, modifier et exécuter.
ASSISTANT-SCOPE.mdles consigne en quatre parties : fichiers, secrets, commandes et actions externes. - Classez les commandes en trois groupes. Certaines lisent seulement (
pytest,ruff check .). Certaines modifient des fichiers locaux (ruff format ., le rapport,git commit). Certaines accèdent à l’extérieur (pip install,remote,git push, et le collage dans un clavardage). - Un fichier de limites demande; un bac à sable impose. Le cours a enregistré ses sessions dans une copie jetable, avec les commandes shell désactivées et une clé factice.
Module 1 : mettre en place un environnement de travail sûr
- Trois modes : le clavardage voit ce que vous collez, la complétion suggère du texte là où vous écrivez. Un agent modifie des fichiers et peut exécuter des commandes. Plus il intervient, plus vous vérifiez.
- Un point de départ propre : un environnement créé à partir du fichier de verrouillage, une branche propre sur un commit et des vérifications de référence de base. Un test fige le rapport actuel.
- Votre projet correspond à
end-of-m01: trois commits surfeature/category-optionet25 passed.
Ensuite, dans le module 2, vous transformerez le courriel de Grace en tâche. Un assistant ou un collègue pourra la terminer et la vérifier sans devoir deviner.
Leçon suivante : Problème et critères d'acceptation