Aller au contenu
English

Réflexion et prolongements

  • Leçon 22
  • 60 min
  • Module 7 : Préparer la présentation du portfolio

Où nous en sommes

Dans les deux leçons précédentes, nous avons remis le dépôt et planifié la démo. Le projet est terminé, mais nous n'en avons pas encore tiré de leçons. Dans cette leçon, nous revenons sur ce qui a bien fonctionné, ce qui n'a pas fonctionné et ce que nous ferions autrement, chaque point avec une preuve, et nous planifions un prolongement facultatif. Nous commençons par une équipe qui regarde la vidéo de son match.

Ce que vous saurez faire

Faites le bilan du projet pour en tirer des leçons. Planifiez la suite sans briser ce qui fonctionne. Écrivez ce qui a bien fonctionné, ce qui a moins bien fonctionné et ce que vous feriez autrement. Appuyez chaque réponse sur des preuves. Proposez ensuite un prolongement facultatif, avec le cours à suivre d’abord et les preuves nécessaires.

Avant de commencerCe qu’il faut savoir et avoir sous la mainEnviron 60 minutes

Ce que vous devez savoir

Ce qu’il vous faut sur votre ordinateur

  • La copie de end-of-m06 de la dernière leçon, avec la base de données en marche et l’ensemble de données chargé. Une seule commande de cette leçon en a besoin.

Testé sur macOS (Apple silicon).

Une équipe de soccer joue le samedi. Le lundi, les joueurs et l’entraîneur regardent ensemble la vidéo du match. Ils ne cherchent pas qui blâmer. Ils arrêtent la vidéo à trois types de moments. Ici, les passes ont bien fonctionné : gardons cette façon de faire. Ici, nous avons perdu le ballon quatre fois de la même façon : pourquoi? Ici, nous ferions autrement la prochaine fois : qu’allons-nous travailler exactement à l’entraînement cette semaine?

Chaque moment a ses preuves : la vidéo, le chronomètre, le nombre de passes. « Nous avons mal joué » ne décrit pas un moment. « Nous avons perdu le ballon quatre fois du côté gauche, après une longue passe » en décrit un. C’est seulement après qu’ils parlent de nouveaux joueurs pour la prochaine saison. Un nouvel attaquant n’aide pas une équipe qui perd le ballon en défense.

Le problème : deux mauvaises réflexions et un prolongement séduisant

Section intitulée « Le problème : deux mauvaises réflexions et un prolongement séduisant »

À la fin du projet, Sam écrit un premier brouillon de sa réflexion en cinq minutes :

« Dans l’ensemble, le projet s’est bien passé. J’ai beaucoup appris sur le RAG, l’authentification et Docker. Certaines choses étaient difficiles par manque de temps. Ensuite, j’ajouterai un agent, parce que les agents sont l’avenir. »

Kwame le lit et pose trois questions. Qu’est-ce qui a bien fonctionné, exactement, et comment le savez-vous? Qu’est-ce qui était difficile, et que changeriez-vous? Et l’agent : que ferait-il, que devez-vous apprendre d’abord et comment sauriez-vous qu’il fonctionne?

La dernière phrase est dangereuse. Tomás demande un agent depuis le module 1. Supposons que l’agent rédige et envoie lui-même des réponses aux clients. Regardez ce que fait l’assistant aujourd’hui avec la question réservée B34, posée chez Bramble Books :

Ines (owner) at Bramble Books asks: How much goodwill credit can an agent give at Larkfield?
Answer (answerable): An agent can give up to $15 in goodwill credit, once per customer per year.

La bonne réponse est « Les documents de Bramble ne décrivent pas Larkfield ». Aujourd’hui, un membre du personnel lit cette réponse et décide. Un agent autonome l’enverrait. Une faiblesse connue du produit de base devient une mauvaise action auprès d’un client. Le prolongement ajoute un risque avant que le produit de base soit prêt à le gérer.

Un deuxième piège se cache dans le mot « ensuite ». Sam connaît maintenant les cinq questions réservées qui ont échoué. Supposons que Sam modifie la requête jusqu’à ce que B34 réussisse. Sam relance ensuite l’évaluation sur les données réservées et annonce 37 sur 41. Ce nombre n’est plus honnête : les données réservées ont aidé à choisir la modification. Elles sont donc devenues des données de réglage.

L’idée : une rétrospective avec des preuves, puis un prolongement soumis à une barrière

Section intitulée « L’idée : une rétrospective avec des preuves, puis un prolongement soumis à une barrière »

Une rétrospective est un bilan planifié du travail terminé, pour améliorer le prochain travail. Le nom vient du latin et signifie « regarder en arrière ». Elle pose trois questions, et chaque réponse doit avoir des preuves :

  1. Qu’est-ce qui a bien fonctionné, et pourquoi? Gardez-le dans le prochain projet.
  2. Qu’est-ce qui a moins bien fonctionné, et quelle en était la cause? Cherchez la cause, pas une personne à blâmer.
  3. Que feriez-vous autrement? Un changement concret, assez petit pour l’essayer la prochaine fois.

Une rétrospective n’est ni une liste d’excuses ni une note. Sa valeur est dans la troisième réponse : un changement que vous pouvez appliquer.

Un prolongement est un travail facultatif qui ajoute une capacité une fois que le produit de base fonctionne. Ce cours en présente trois types : un modèle personnalisé, un agent et un serveur MCP. Chacun a son propre cours qui enseigne des compétences absentes de celui-ci. Chaque proposition de prolongement comporte donc une barrière à franchir, puis trois parties :

Une décision : les éléments 1 à 4 de la grille sont-ils tous démontrés? Si non : corriger d'abord le produit de base; un prolongement ne remplace jamais un élément obligatoire. Si oui : choisir un prolongement. Trois options. Modèle personnalisé : préalable, le cours sur le déploiement des modèles; première preuve, le même rapport sur les données réservées, le coût et le temps p95 sur le même portable. Agent qui rédige des réponses : préalable, le cours sur les agents; première preuve, un test montrant qu'il n'agit jamais sans approbation. Serveur MCP pour la recherche : préalable, le cours sur MCP; première preuve, les vérifications d'isolation par l'outil, 0 fuite.
La barrière du prolongement. Un prolongement commence seulement quand les quatre éléments obligatoires sont démontrés. Chacun précise son cours préalable et la première preuve à produire.
Description textuelle du diagramme

Le diagramme commence par une question : les éléments 1 à 4 de la grille sont-ils tous démontrés? Sinon, la flèche mène à « corriger d’abord le produit de base » : un prolongement ne remplace jamais un élément obligatoire. Si oui, la flèche mène à « choisir un prolongement », qui comporte trois branches. Un modèle personnalisé exige d’abord le cours sur le déploiement des modèles. Sa première preuve est le même rapport sur les données réservées, le coût et le temps p95 sur le même portable. Un agent qui rédige des réponses exige le cours sur les agents. Sa première preuve est un test montrant qu’il n’agit jamais sans approbation. Un serveur MCP pour la recherche exige le cours sur MCP. Sa première preuve est l’exécution des vérifications d’isolation par l’outil, avec 0 fuite.

Les préalables sont les compétences nécessaires avant de commencer et le cours qui les enseigne. La première preuve est la vérification qui montrerait que le prolongement fonctionne et protège le produit de base. L’écrire avant de construire quoi que ce soit reprend la même habitude que le plan de preuves du module 1.

Prenons un problème rencontré par Sam : les premiers résultats d’évaluation semblaient moins bons que les réponses. Écrivons-le de trois façons dans la rétrospective :

Version Texte Sam peut-il agir?
Une excuse « L’évaluation était injuste parce que les corrigés étaient mauvais. » Non. Cette phrase blâme l’outil et cache la cause.
Vague « L’évaluation est difficile; je dois faire plus attention. » Non. « Faire plus attention » n’est pas un changement.
Utile « Certains corrigés étaient plus stricts que les réponses de référence : Q46 exigeait “5 to 10”, et la réponse disait “5–10”. La prochaine fois, j’examinerai chaque échec avant de me fier à un résultat. Je testerai aussi chaque corrigé avec sa réponse de référence. » Oui : une cause, des preuves et un changement à essayer.

La phrase utile nomme les preuves : Q46 et les deux façons d’écrire la valeur. Elle nomme la cause : un corrigé plus strict que sa réponse de référence. Et elle nomme un changement : tester chaque corrigé avec sa réponse de référence. L’équipe de soccer arrêterait la vidéo à ce moment-là.

Le projet intégrateur détaillé : la réflexion de Sam

Section intitulée « Le projet intégrateur détaillé : la réflexion de Sam »

Sam réécrit le brouillon dans docs/reflection.md, dans end-of-m06. Chaque ligne a maintenant ses preuves.

Ce qui a bien fonctionné. Écrire les critères d’acceptation et réserver les questions dès la première semaine. Chaque discussion ultérieure (« est-ce assez bon? ») pouvait s’appuyer sur un nombre. La demande de Tomás, « laissons tomber les données réservées, nous manquons de temps », avait aussi une réponse. Les réserver avait pris dix minutes, à la première semaine. Deuxièmement, créer un parcours complet avant toute fonctionnalité supplémentaire. L’adaptateur simulé a permis de faire fonctionner la page, le téléversement et les états des tâches avant d’utiliser un modèle. Troisièmement, vérifier l’isolation à quatre niveaux : recherche, niveau d’accès, API et base de données. La sécurité au niveau des lignes n’a rien trouvé de nouveau, ce qui est le but d’un deuxième verrou.

Ce qui a moins bien fonctionné. Les corrigés stricts, comme dans le petit exemple. Et les modèles locaux exigent environ 1 Go de téléchargements et occupent la majeure partie de l’image. La démo est donc lente à démarrer sur un nouvel ordinateur.

Ce que je ferais autrement. Écrire les quatre cas de défaillance sous forme de tests dès le premier jour du module 4. Le faire avant le code qui les gère. Et tenir un court journal de décisions dès la première semaine : une ligne par décision, avec sa date et ses preuves. À la fin, Sam a dû retrouver plusieurs décisions dans l’historique des commits (enregistrements des modifications).

Une rétrospective examine aussi ce qui ne fonctionne toujours pas, pour choisir le prochain travail. Sam relance l’évaluation en affichant les échecs. Les réponses sont enregistrées, donc cette exécution reproduit exactement le premier passage du rapport :

Fenêtre de terminal
python -m scripts.evaluate --set heldout --show-failures
hybrid, answer_v2, recorded: 41 questions | correct 0.878 | retrieval hit 0.886 | citations valid 1.000 | abstained when it should 0.833 | injection obeyed 0 of 2 | median 9 ms | US$0.000167 per question
answerable 12 correct 0.833 hit 0.833
contradiction 3 correct 1.0 hit 1.0
exact-code 4 correct 1.0 hit 1.0
injection-bait 2 correct 1.0 hit 1.0
other-shop 2 correct 0.5 hit None
staff-only 5 correct 1.0 hit 1.0
table 5 correct 0.8 hit 0.8
unanswerable 4 correct 1.0 hit None
version 4 correct 0.75 hit 0.75
WRONG Q13 (larkfield, answerable, hit False): The documents do not say whether Larkfield sells extended warranties.
WRONG Q28 (larkfield, version, hit False): The documents do not say whether a Rewards member pays for a return label in this case.
WRONG Q37 (larkfield, table, hit False): Les documents ne précisent pas la durée de la garantie d’un barbecue.
WRONG B12 (bramble, answerable, hit False): The documents do not say whether we can ship a book to a customer in Seattle.
WRONG B34 (bramble, other-shop, hit None): An agent can give up to $15 in goodwill credit, once per customer per year.
  • La récupération a manqué le passage
  • Réponse à une question sur une autre boutique
  • Aucun échec
La version retenue sur les 41 questions réservées (premier passage), par type : réponse = question à laquelle on peut répondre, boutique = question sur une autre boutique, autres = les cinq types sans échec. Quatre des cinq échecs viennent de passages manqués par la récupération; le cinquième est B34.
Description textuelle du graphique

Un diagramme à colonnes montre la proportion de questions réservées avec une réponse correcte, par type. Questions auxquelles on peut répondre : 83 % (10 sur 12; Q13 et B12 ont échoué). Questions sur les versions : 75 % (3 sur 4; Q28 a échoué). Questions sur les tableaux : 80 % (4 sur 5; Q37 a échoué). Ces trois colonnes ont la même couleur : pour chaque échec, la récupération n’a pas trouvé le bon passage. Questions sur une autre boutique : 50 % (1 sur 2; B34 a échoué), dans une deuxième couleur. Les cinq autres types réunis, codes exacts, contradictions, réservées au personnel, pièges d’injection et questions sans réponse : 100 % (18 sur 18), dans une troisième couleur.

Quatre des cinq échecs affichent hit False : le bon passage n’a jamais atteint le modèle. Leurs réponses sont des refus honnêtes, pas des faits erronés. Le cinquième, B34, est l’inverse : une réponse assurée qui devrait être un refus. Sam inscrit les deux dans les prochaines étapes de sa réflexion : des questions de réglage en français (Q37). Et une règle dans la requête pour les questions qui nomment une autre boutique (B34).

Sam écrit aussi la règle qui protège le prochain cycle. Ces cinq questions sont maintenant connues, donc elles ne peuvent pas mesurer leur propre correction. Avant toute modification, Sam écrira de nouvelles questions de réglage semblables et les utilisera pour le réglage. De nouvelles données réservées mesureront la prochaine version. Éviter la contamination, dans le cours sur l’évaluation, explique pourquoi.

Sam propose les trois prolongements dans un tableau, sans en construire aucun dans ce cours :

Prolongement Ce qu’il ajoute Cours à suivre d’abord Première preuve nécessaire
Modèle personnalisé un petit modèle exécuté localement pour l’étape de réponse, afin de réduire le coût et de garder les documents sur l’ordinateur Déployer des modèles d’IA pour de vrais utilisateurs le même rapport sur les données réservées, le coût par question et le temps p95 sur le même portable
Agent rédige une réponse au client et demande au personnel de l’approuver; il ne l’envoie jamais seul Agents d’IA et orchestration des flux de travail, surtout Limites d’approbation un test montrant qu’il n’agit jamais sans approbation, et le rapport sur les brouillons pour les questions réservées
Serveur MCP la recherche de l’assistant comme outil pour d’autres clients d’IA, avec les mêmes vérifications d’accès par boutique MCP : connecter les applications d’IA aux outils et aux données, surtout Identité et autorisations les vérifications d’isolation exécutées par l’outil MCP : 0 fuite

Regardez la ligne de l’agent. L’idée de Tomás revient, mais sous une forme sûre : l’agent rédige, et une personne approuve. Sa première preuve est un test du risque précis révélé par B34. Kwame accepte le tableau. Il demande aussi à Sam de classer les prolongements. Sam choisit d’abord le serveur MCP, parce que sa première preuve réutilise les vérifications d’isolation existantes.

Exercice guidé : la tâche du module, étape par étape

Section intitulée « Exercice guidé : la tâche du module, étape par étape »

Le module se termine par un livrable : votre produit, prêt à être remis à quelqu’un d’autre. Regardez d’abord celui du projet intégrateur détaillé, avec toutes ses parties visibles.

  1. Ouvrez les quatre fichiers de remise dans end-of-m06 : README.md, docs/portfolio-checklist.md, docs/demo-script.md et docs/reflection.md.

  2. Ouvrez docs/marking-rubric.md. Il contient quatre éléments obligatoires : un parcours utilisateur fonctionnel; un dépôt et un déploiement reproductibles; une évaluation sur des données réservées et des vérifications d’isolation; une démo, une architecture et des limites claires.

  3. Pour chaque élément, trouvez les preuves dans les quatre fichiers. Élément 1 : la section Quick start (démarrage rapide) du README et scripts/smoke.py (7 sur 7). Élément 2 : le test par une personne qui ne connaît pas le projet et le flux de travail CI. Élément 3 : le rapport d’évaluation et scripts.isolation (0 fuite). Élément 4 : le scénario de démo, le dossier de conception et la section Limitations (limites).

  4. Lisez le rapport final de Sam dans l’encadré ci-dessous. C’est la page qu’un réviseur lit en premier.

Rapport final de Sam (exemple détaillé)
Final report: the document assistant (one page)
## What it is
A document assistant for two shops (Larkfield, Bramble Books): answers from each shop's own
documents with a citation for every claim, or a clear "no answer". Synthetic documents (CC0).
## Required items, with evidence and my own mark
1. Working user journey: demonstrated. README Quick start; scripts/smoke.py: 7 of 7 checks passed;
screenshots of upload, cited answer, no answer, read-only refusal.
2. Reproducible repository and deployment: demonstrated (local Compose; cloud steps written, not run).
Stranger test on a fresh copy: 108 tests passed; CI workflow; rollback drill in docs/runbook.md.
3. Held-out evaluation and isolation: demonstrated, with one criterion not met. 36 of 41 correct,
citations 100%, 0 of 2 injections followed; isolation 0 leaks. Abstention 5 of 6: B34 fails
(Q2 not met), named in the report.
4. Demo, architecture, limitations: demonstrated. docs/demo-script.md (failure case and trade-off),
docs/design-pack/, README Limitations.
## Completed and planned
Completed: the four items above. Planned, not done: cloud deployment, French tuning questions,
a fix for B34 with a new held-out set, the MCP extension (docs/reflection.md).

Remarquez l’élément 3. Sam le marque « démontré » parce que la grille exige une évaluation honnête sur des données réservées et des vérifications d’isolation sans fuite. Les deux sont présentes. Le seuil non atteint est signalé, pas caché. Un réviseur peut quand même poser des questions sur B34, et Sam a sa réponse prête.

Livrez votre propre produit, prêt pour un réviseur qui ne l’a jamais vu. Remettez quatre choses :

  1. Le dépôt, avec le README de remise de Remise du dépôt, la liste de vérification du portfolio et le test réussi par une personne qui ne connaît pas le projet, à partir d’un dossier propre.
  2. Le scénario de démo, docs/demo-script.md, répété, avec un cas de défaillance et un compromis, comme dans Le récit de la démo.
  3. Le plan des captures d’écran : une vraie capture du produit en marche pour chaque étape de la démo, avec l’étape correspondante.
  4. Le rapport final : une page, comme celui de Sam. Pour chacun des quatre éléments de la grille, donnez les preuves et votre propre évaluation avec une raison : démontré, partiellement démontré ou pas encore démontré. Présentez ensuite le travail terminé et le travail prévu.

Écrivez aussi docs/reflection.md : trois réponses de rétrospective avec des preuves, et un prolongement proposé avec son cours préalable et sa première preuve.

Comment un réviseur vérifie votre remise (solution détaillée)
  • Le dépôt : le réviseur le clone dans un nouveau dossier et suit le README. Chaque vérification affiche ce que le README annonce. git check-ignore -v .env indique .env. Un échec ici rend l’élément 2 « pas encore démontré », peu importe ce qui fonctionne ailleurs.
  • Le scénario de démo : cinq parties, cinq minutes ou moins. Le cas de défaillance et le compromis sont présents. Chaque question a été répétée (les sorties des répétitions affichent recorded (enregistré) ou live (en direct), jamais mock (simulé)). Sans le cas de défaillance ou le compromis, l’élément 4 est « partiellement démontré ».
  • Le plan des captures d’écran : chaque étape a une vraie capture du produit en marche. Un écran dessiné ou retouché est une affirmation sans preuve.
  • Le rapport final : chaque évaluation correspond aux preuves. « Démontré » avec une fuite dans les vérifications d’isolation est incorrect : un échec du contrôle d’accès rend l’élément 3 « pas encore démontré ». Un seuil de qualité non atteint, signalé honnêtement, ne le rend pas ainsi.
  • La réflexion : chaque ligne nomme des preuves et un changement. Le prolongement nomme un cours à suivre d’abord et une première vérification. Rien n’y est présenté comme terminé.

Vérification de fin de module : expliquez vous-même

Section intitulée « Vérification de fin de module : expliquez vous-même »

La vérification de fin de module prévue au plan : expliquer l’implémentation sans aide et distinguer le travail terminé des prolongements prévus. Répondez à ces questions sans vos notes, puis ouvrez les réponses détaillées.

Réponses détaillées pour l’exemple de projet intégrateur
  • Que se passe-t-il quand Ines pose une question? L’API vérifie sa session, lit son adhésion à Bramble Books dans sa propre table et trouve son rôle. Le pipeline cherche uniquement les passages de Bramble que son rôle peut lire et qui sont en vigueur à cette date. Il combine les résultats obtenus avec les vecteurs et les mots-clés. Il envoie les 5 meilleurs passages et la requête au fournisseur (enregistré par défaut). Il vérifie que chaque citation correspond à l’un de ces passages, stocke la réponse et la retourne.
  • Pourquoi Ines ne peut-elle jamais voir les passages de Larkfield? Chaque requête contient le tenant_id de Bramble; la sécurité au niveau des lignes de PostgreSQL le vérifie de nouveau. La recherche filtre par boutique et niveau d’accès; la recherche d’une citation utilise les mêmes filtres. scripts.isolation teste la recherche, le niveau d’accès, l’API et la base de données : 0 fuite.
  • Qu’est-ce qui est terminé et qu’est-ce qui est prévu? Terminé : un parcours pour deux boutiques, la connexion et les rôles, la sécurité au niveau des lignes, la gestion des défaillances, la suppression, l’évaluation sur des données réservées, la démo locale avec Compose et l’intégration continue, les limites et un retour arrière testé. Prévu, non réalisé : le déploiement dans le nuage (rédigé, non exécuté), des questions de réglage en français, une correction pour B34 et les prolongements.

Répondez ensuite aux trois mêmes questions pour votre produit, à voix haute, devant un ami ou dans un enregistrement. Si vous ne pouvez pas expliquer une partie, relisez ce code jusqu’à pouvoir le faire. La grille classe « la personne ne peut pas expliquer ses propres décisions » comme « pas encore démontré ».

  1. Rédigez la rétrospective, docs/reflection.md : ce qui a bien fonctionné, ce qui a mal fonctionné et ce que vous feriez autrement. Appuyez chaque ligne sur une preuve et proposez un changement concret dans la dernière réponse.
  2. Examinez les défaillances restantes à l’aide de la liste des défaillances de votre évaluation. Écrivez les prochaines étapes et la règle pour le prochain cycle : de nouvelles questions de réglage et de nouvelles données réservées avant de mesurer une correction.
  3. Proposez un prolongement seulement si vos quatre éléments obligatoires sont démontrés. Nommez son apport, le cours à suivre d’abord et sa première preuve. Ne le réalisez pas dans ce cours.
  4. Rédigez le rapport final et expliquez votre implémentation à voix haute, comme dans la vérification de fin de module.

Liste de vérification

  • Chaque ligne de la rétrospective nomme une preuve (un identifiant de question, un nombre, un commit [enregistrement d’une modification]), pas un sentiment.
  • « Ce que je ferais autrement » contient au moins un changement assez petit pour l’essayer dans le prochain projet.
  • Les prochaines étapes ne réutilisent pas les données réservées actuelles pour mesurer une correction.
  • Le prolongement nomme son cours préalable et sa première preuve, et figure comme prévu, non réalisé.
  • Le rapport final attribue à chaque élément de la grille une note et une raison; les notes correspondent aux preuves.
  • Vous pouvez expliquer le parcours d’une question dans votre produit et pourquoi une boutique ne voit jamais les données de l’autre.

Erreur courante

Le prolongement avant les fonctions de base

Symptôme : le projet a un agent ou un serveur MCP, mais le test avec une personne inconnue échoue, ou les vérifications d’isolation n’ont jamais été exécutées.

Cause : le prolongement semblait plus impressionnant que les fonctions de base. Tomás a demandé « un agent d’abord » dans le module 1.

Correction : arrêtez le prolongement et terminez les fonctions de base jusqu’à ce que les quatre éléments de la grille soient démontrés. Un prolongement n’est jamais évalué à la place d’un élément obligatoire.

Conséquence dans le travail en IA : un agent multiplie les faiblesses de ce qu’il appelle. La mauvaise réponse de B34, envoyée par un agent sans approbation, devient une promesse erronée à un client.

Erreur courante

Corriger les défaillances sur les données réservées et présenter le nouveau score

Symptôme : la version suivante annonce 37 ou 38 sur 41 pour les mêmes questions réservées, après une modification ciblant exactement les questions échouées.

Cause : les défaillances ont été examinées et la modification a été ajustée jusqu’à ce que les tests réussissent. Les données réservées ont servi à faire le choix.

Correction : rédigez de nouvelles questions du même type, faites le réglage avec elles, puis réservez de nouvelles données avant de mesurer. Présentez l’ancien score sur les données réservées comme le score de l’ancienne version.

Erreur courante

Une réflexion qui est une liste d'excuses

Symptôme : chaque ligne explique pourquoi ce n’était pas votre faute : le temps, les outils, les données.

Cause : la réflexion vise une note plutôt que l’amélioration du prochain projet.

Correction : pour chaque problème, nommez la cause que vous contrôlez et un changement que vous essaierez. Une bonne réflexion renforce la confiance du lecteur, car elle montre ce que vous avez appris.

Vérifiez votre compréhension

Quelles sont les trois questions d'une rétrospective, et qu'est-ce qui rend une réponse utile?

Afficher la réponse

Qu’est-ce qui a bien fonctionné, et pourquoi? Qu’est-ce qui a mal fonctionné, et quelle en était la cause? Que feriez-vous autrement? Une réponse est utile si elle nomme une preuve (un identifiant de question, un nombre, un commit) et une cause. La dernière réponse doit aussi proposer un changement concret à essayer. « Je dois faire plus attention » n’est pas un changement; « tester chaque corrigé par rapport à sa réponse de référence » en est un.

Vérifiez votre compréhension

Tomás propose un agent qui répond seul aux courriels des clients à l'aide de l'assistant. À partir de B34, expliquez le risque et reformulez la proposition pour qu'elle franchisse la barrière des prolongements.

Afficher la réponse

B34 montre que l’assistant répond à certaines questions sur une autre boutique avec les chiffres de sa propre boutique. Aujourd’hui, le personnel lit chaque réponse avant d’agir. Un agent qui envoie seul transmettrait le montant erroné de 15 $ à un client. Proposition reformulée : seulement après la démonstration des quatre éléments obligatoires, un agent rédige une réponse qu’un membre du personnel approuve; il n’envoie jamais seul. Préalable : le cours Agents d’IA et orchestration des flux de travail (limites d’approbation). Première preuve : un test montrant qu’il n’agit jamais sans approbation et le rapport d’évaluation des brouillons sur des données réservées.

Vérifiez votre compréhension

Prédisez : Sam modifie la requête jusqu'à obtenir une réponse correcte à B34, relance les tests sur les données réservées et obtient 37 sur 41. Pourquoi est-il incorrect d'annoncer « 37 sur 41 sur les questions réservées »?

Afficher la réponse

Les données réservées ont servi à faire le choix : Sam a lu les défaillances et modifié la requête jusqu’à corriger l’une d’elles. Le score est maintenant optimiste, comme un score de réglage, et n’estime plus les résultats sur de nouvelles questions. Sam devrait rédiger de nouvelles questions comme B34, faire le réglage avec elles et réserver de nouvelles données pour mesurer la modification. Le score honnête de la version actuelle sur les données réservées reste de 36 sur 41.

Vérifiez votre compréhension

Vérification de fin de module : pour l'exemple de projet intégrateur, expliquez en trois phrases comment une question devient une réponse. Nommez deux éléments terminés et deux éléments prévus.

Afficher la réponse

L’API vérifie la session et lit le rôle du membre dans sa propre table d’adhésion, jamais dans le jeton. Le pipeline combine vecteurs et mots-clés pour chercher uniquement les passages de la boutique accessibles au rôle et en vigueur à cette date. Il envoie les 5 meilleurs avec la requête au fournisseur, vérifie chaque citation par rapport à ces passages et stocke la réponse. La sécurité au niveau des lignes vérifie de nouveau la boutique dans la base de données. Terminé : par exemple, la sécurité au niveau des lignes avec 0 fuite dans les vérifications d’isolation et l’évaluation sur des données réservées (36 sur 41). Prévu, non réalisé : par exemple, le déploiement dans le nuage (étapes rédigées, non exécutées) et une correction pour B34 avec de nouvelles données réservées.

Récapitulatif

  • Une rétrospective demande ce qui a bien fonctionné, ce qui a mal fonctionné et ce que vous feriez autrement. Chaque réponse comporte des preuves et un changement à essayer.
  • Les défaillances restantes guident les prochaines étapes, mais les données réservées ne peuvent pas mesurer une correction de leurs propres défaillances. Rédigez de nouvelles questions et réservez de nouvelles données.
  • Un prolongement est facultatif et vient seulement après la démonstration des quatre éléments obligatoires. Chaque proposition nomme son apport, le cours à suivre d’abord et sa première preuve.
  • Le livrable du module comprend le dépôt, le scénario de démo, le plan des captures d’écran et un rapport final d’une page. Vous pouvez tout expliquer vous-même.

Récapitulatif du module. Vous avez rendu le projet utilisable sans vous. Un README répond à cinq questions, et une liste de vérification du portfolio relie chaque affirmation à sa preuve. Une démo répétée de cinq minutes montre une défaillance et un compromis. Une réflexion honnête se termine par un prolongement soumis à une barrière.

Récapitulatif du cours. Vous avez délimité un produit pour un utilisateur et réservé des questions avant tout réglage. Vous avez créé un parcours complet et sécurisé le produit pour deux boutiques. Vous l’avez mesuré honnêtement, y compris une modification sans amélioration démontrée et un critère non satisfait. Vous l’avez ensuite livré sous forme de démo reproductible et remis avec ses preuves. Une étude de cas applique ensuite la même méthode à une collection publique de documents.

Leçon suivante : Projet intégrateur sur une collection publique de documents