Aller au contenu
English

Problème et public

  • Leçon 2
  • 60 min
  • Module 1 : Choisir et délimiter le projet

Où nous en sommes

Dans la leçon précédente, nous avons préparé le projet de départ et choisi une voie. Maintenant, le projet a besoin d'un but. Mais une idée vague comme « un assistant d'IA pour les boutiques » ne peut pas être testée, car aucune question n'a une seule bonne réponse. Dans cette leçon, nous choisissons un utilisateur, une décision, un petit ensemble de documents et ce que le produit ne fera pas, comme un camion de cuisine de rue avec un menu court.

Lue depuis YouTube. Rien ne se charge depuis YouTube avant que vous appuyiez sur lecture. Confidentialité

Ce que vous saurez faire

Décidez à qui votre produit s’adresse, quelle décision il facilite, quels documents il lit et ce qu’il ne fera pas. Un projet avec un utilisateur et une décision est assez petit pour être terminé et assez précis pour être testé.

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

  • Le dossier du projet doc-assistant de la dernière leçon, avec son premier commit (enregistrement des modifications). S’il manque, copiez de nouveau l’instantané start, comme dans Préparer le projet de départ.
  • Aucun nouveau paquet. Cette leçon porte sur des décisions; vous écrivez un seul fichier.

Deux amies ouvrent une entreprise de restauration le même mois.

La première ouvre un restaurant « pour tout le monde » : 80 plats de 12 pays, trois repas par jour, livraison et service traiteur. Après un mois, l’équipe en cuisine est épuisée et beaucoup de plats sont mauvais. Elle ne sait pas lesquels font perdre de l’argent. Quand un client se plaint, elle ne sait pas par où commencer.

La deuxième stationne un camion de cuisine de rue près d’un groupe de bureaux. Elle sert un seul type de client : les employés de bureau qui ont une pause-repas de 30 minutes. Elle remplit une seule fonction : servir un repas chaud en moins de cinq minutes. Son menu compte cinq plats. Sur le côté du camion, une affiche indique : « Aucun service aux tables. Aucune livraison. Paiement par carte seulement. » Après un mois, elle sait exactement comment son entreprise se porte. Elle compte les repas servis en moins de cinq minutes et sait quel plat se vend.

L’affiche est aussi importante que le menu. Chaque « non » correspond à une décision prise une seule fois, pour éviter d’en débattre chaque jour.

À la première réunion, Tomás, un ingénieur en IA, décrit le produit qu’il veut que Sam construise :

« Un assistant d’IA pour les boutiques. Il discute avec les clients, répond à toute question à partir de n’importe quel document et envoie seul des courriels de remboursement. Il parle toutes les langues et fonctionne dans le nuage. Ajoutons d’abord un agent : c’est ce que les gens veulent voir. »

Cela semble impressionnant. Sam essaie un test simple : écrire la première question de test et sa bonne réponse. Sam écrit « Est-ce que je peux retourner cet article? », puis bloque aussitôt :

  • Qui pose la question? Un client a besoin d’une réponse courte et polie. Un membre du personnel a besoin de la règle et de ses exceptions, par exemple la limite d’approbation d’un remboursement.
  • Quelle boutique? Larkfield vend des outils de jardinage; Bramble Books vend des livres. Leurs règles de retour sont différentes.
  • À quelle date? Larkfield a fait passer son délai de retour de 30 à 45 jours. La bonne réponse dépend de la date de livraison.
  • À partir de quel document? « N’importe quel document » ne désigne aucune collection. Personne ne peut donc vérifier que la réponse vient du bon document.

Sam n’arrive même pas à écrire une question de test qui a une seule bonne réponse. Personne ne pourrait donc dire si le produit fonctionne. C’est le vrai coût d’une idée vague : elle est non seulement vaste, mais impossible à tester. Et la liste de Tomás contient cinq grandes fonctionnalités. Un projet intégrateur de cinq semaines avec cinq fonctionnalités à moitié construites n’a rien à montrer à la fin. Aucun parcours ne fonctionne du début à la fin.

L’idée : un utilisateur, une décision, une collection limitée et des exclusions

Section intitulée « L’idée : un utilisateur, une décision, une collection limitée et des exclusions »

La solution consiste à répondre à quatre questions avant de construire quoi que ce soit. Ensemble, les réponses définissent la portée du projet : les limites de ce qu’il fait.

  1. Un utilisateur. Un seul type de personne avec un rôle, par exemple « le personnel de soutien d’une petite boutique ». Pas « tout le monde ».
  2. Une décision. Ce que cette personne doit décider ou faire, et que le produit améliore ou accélère. Par exemple : « quoi dire à un client qui pose une question sur une politique ». Nous parlons de décision, car la valeur du produit réside dans un choix qu’une personne fait avec son aide.
  3. Une collection limitée de documents. Les documents exacts que le produit lit : leur nature, leur nombre, leurs formats, leur propriétaire et votre droit de les utiliser.
  4. Des exclusions. Les choses que le produit ne fera pas, notées volontairement. Une exclusion n’est pas une faiblesse. Comme l’affiche sur le camion, c’est une décision qui protège votre temps et montre au réviseur que vous avez choisi.

Voici un test rapide pour savoir si la portée est « assez limitée ». Pouvez-vous écrire dix vraies questions de cet utilisateur en environ 30 minutes, avec leurs bonnes réponses et les documents correspondants? Si oui, la portée est assez limitée pour être testée. Sinon, l’utilisateur, la décision ou la collection reste trop vague.

Un petit exemple : passer d’une idée à cinq lignes

Section intitulée « Un petit exemple : passer d’une idée à cinq lignes »

Voici un petit exemple inventé pour le cours. Ana veut « une IA pour mon club de soccer ». Elle répond aux quatre questions :

Question Première réponse d’Ana Réponse d’Ana après le test
Qui l’utilise? « Le club » Les entraîneurs bénévoles des équipes juniors
Quelle décision? « Tout ce qui concerne le club » Décider si un match a lieu par mauvais temps et quoi dire aux parents
Quels documents? « Tous nos fichiers » La politique du club sur la météo et les terrains, ses règles de protection des jeunes pour les messages aux parents et les règles de la ligue sur les matchs reportés : 4 documents, tous publics sur le site du club
Que ne fera-t-il pas? (rien) Aucun message envoyé aux parents de façon autonome, aucune planification de matchs, aucun conseil médical
Une question de test « Le match a-t-il lieu? » « Le terrain des moins de 10 ans est gelé samedi à 8 h. Le match de 10 h peut-il avoir lieu? » Bonne réponse : non, un terrain gelé impose un report; la source est la section 2 de la politique sur la météo

Regardez la dernière ligne. La première question de test n’a pas de bonne réponse. « Le match » et « a lieu » dépendent de faits que la question ne donne pas. La deuxième question a une seule bonne réponse et une seule source. La portée plus limitée d’Ana a rendu le produit testable. Elle l’a aussi rendu plus petit : Ana peut le terminer.

Sam ne choisit pas l’utilisateur sans consulter les autres. Sam rencontre Grace, responsable du soutien chez Larkfield, et Ines, propriétaire de Bramble Books. Leurs boutiques sont les deux organisations du cours sur l’authentification. Sam leur demande comment leur personnel travaille aujourd’hui et examine les quatre questions avec elles. Le diagramme montre le résultat.

Un flux sur deux rangées, à lire de gauche à droite. L'idée de départ : un assistant d'IA pour les boutiques. Question : qui l'utilise? Réponse : le personnel de soutien de deux boutiques. Question : quelle décision facilite-t-il? Réponse : répondre correctement à une question d'un client sur une politique, pendant que le client attend. Question : à partir de quels documents? Réponse : les politiques propres à chaque boutique, 36 pour Larkfield, 15 pour Bramble Books. Question : que ne fera-t-il pas? Réponse : cinq exclusions, aucune réponse aux clients, aucun historique de conversation, aucun agent, aucune autre langue, aucun nuage dans le produit de base. Résultat : un projet que vous pouvez terminer, tester et présenter.
Quatre questions transforment l'idée de départ en une portée. Chaque réponse élimine des options, et ce qui reste peut être terminé et testé.
Description textuelle du diagramme

Le flux commence par « un assistant d’IA pour les boutiques » et pose quatre questions à tour de rôle. Qui l’utilise? Le personnel de soutien de deux boutiques. Quelle décision? Répondre correctement à une question d’un client sur une politique, pendant que le client attend. À partir de quels documents? Les politiques propres à chaque boutique : 36 pour Larkfield, 15 pour Bramble Books. Que ne fera-t-il pas? Cinq exclusions : aucune réponse aux clients, aucun historique de conversation, aucun agent, aucune autre langue, aucun nuage dans le produit de base. Le résultat est un projet que Sam peut terminer, tester et présenter.

Sam écrit les réponses dans docs/project-brief.md. Voici la première partie :

docs/project-brief.md (part)
## User and decision
- Who uses the product: the help-desk staff of two small shops, Larkfield (home and garden) and Bramble Books (an independent bookshop).
- The decision it helps with: answer a customer's policy question correctly, from the shop's own documents, while the customer waits.
- How they do it today, and what goes wrong: staff search a shared folder and read several documents. Last month a Larkfield agent quoted the old 30-day return window to a customer whose delivery fell under the new 45-day policy, and a Bramble Books volunteer quoted the FAQ's "5 business days" for a special order that took 9.

La dernière ligne est la plus utile. Elle nomme deux erreurs réelles que le produit doit prévenir : une ancienne version d’une politique et deux documents qui se contredisent. Ces deux erreurs deviennent des questions de test dans ce module et des difficultés dans l’ensemble de données du module 2. « Le personnel a besoin de réponses plus rapides » ne vous donnerait rien à tester.

La partie suivante précise les documents et explique pourquoi Sam peut les utiliser :

docs/project-brief.md (part)
## Documents
- Which documents the product reads: each shop's own policies, staff procedures, help articles and supplier notes. Larkfield: 36 documents (Markdown, HTML and PDF). Bramble Books: 15 documents.
- Who owns them, and why we may use them: every document is synthetic, written for this course; no real company wrote them. Licence CC0.

Les 36 documents de Larkfield forment la collection du cours sur le RAG, sans changement. Les 15 documents de Bramble Books ont été écrits pour ce cours, avec les mêmes types de difficultés. Les deux collections sont synthétiques : elles sont inventées et ne contiennent donc aucun vrai client ni aucune règle d’une vraie entreprise. CC0 signifie que tout le monde peut les utiliser à toutes fins.

Viennent ensuite la réussite et les exclusions :

docs/project-brief.md (part)
## What success looks like
- A member of a shop asks a question in plain words and gets, in a few seconds, a short answer with a citation for every claim, or a clear "the documents do not answer this".
- A shop never sees the other shop's documents, passages or answers.
## Non-goals
- No answers sent to customers directly: staff read the answer and decide.
- No chat history and no follow-up questions: one question, one answer.
- No agent that takes actions (refunds, emails). Tomás asked for one; it is a possible extension after the core works.
- No other languages than the documents' (English, and French for Larkfield's two Quebec documents).
- No cloud deployment in the core: a reproducible local demonstration.

Chaque exclusion a une courte justification. « Le personnel lit la réponse et décide » est aussi une décision de sécurité. Une personne vérifie chaque réponse avant qu’un client l’entende. Le diagramme place la portée et les exclusions côte à côte.

Deux groupes côte à côte. Dans la portée, le produit de base : une question, une réponse; chaque affirmation cite les documents de la boutique; une indication claire, « les documents ne répondent pas à cette question »; téléverser et supprimer les documents de la boutique; deux boutiques, jamais mélangées; une démonstration locale que tout le monde peut exécuter. Hors de la portée, les exclusions, dessinées avec des bordures en tirets : réponses envoyées directement aux clients; historique de conversation et questions de suivi; agent qui effectue des actions comme des remboursements et des envois de courriels; langues absentes des documents; déploiement dans le nuage du produit de base. Une flèche pointillée relie les exclusions à Réflexion et prolongements, au module 7, avec cette étiquette : l'agent, un prolongement possible une fois que le produit de base fonctionne.
La portée de Sam. Tout ce qui est à l'intérieur est construit et testé; tout ce qui est à l'extérieur est une exclusion écrite. L'agent n'est pas refusé pour toujours : il attend que le produit de base fonctionne.
Description textuelle du diagramme

Le groupe de gauche, dans la portée, contient six éléments. Une question reçoit une réponse, et chaque affirmation cite les documents de la boutique. Il comprend une indication claire d’absence de réponse, le téléversement et la suppression, deux boutiques jamais mélangées et une démonstration locale. Le groupe de droite, avec des bordures en tirets, contient les cinq exclusions de la fiche de projet. Une flèche pointillée mène des exclusions aux prolongements du module 7 : l’agent devient possible une fois que le produit de base fonctionne.

Tomás n’abandonne pas facilement. « Tout le monde veut des agents. Sans agent, la démo paraît petite. »

Sam répond avec la fiche de projet : « Le personnel de Grace a besoin d’une bonne réponse pendant que le client attend. Un agent qui envoie des courriels de remboursement résout un autre problème et exige ses propres vérifications de sécurité. Si le produit de base fonctionne, c’est le premier prolongement que je propose au module 7. » Les besoins d’un agent, ses outils, ses limites et ses étapes d’approbation occupent un cours entier : Agents d’IA et orchestration des flux de travail.

C’est l’erreur la plus fréquente dans les projets intégrateurs : trop de fonctionnalités avant qu’un seul flux fonctionne. Un petit produit qui fonctionne du début à la fin, avec des preuves, impressionne davantage un réviseur que cinq éléments impressionnants sans liens.

La dernière partie de la fiche de projet est le plan. Un jalon est une étape du projet avec un résultat observable. C’est une condition de réussite que tout le monde peut vérifier, pas seulement une date. « Travailler sur le backend » n’est pas un jalon. « Grace téléverse un document, le voit indexé, pose une question et obtient une réponse avec des citations » en est un. Le jour prévu, c’est vrai ou non.

Jalon Terminé quand Semaine
Dossier de conception l’architecture et la revue des menaces et des coûts sont écrites et révisées par Kwame 1
Un parcours Grace téléverse un document, le voit indexé, pose une question et obtient une réponse avec des citations 2
Sûr et fiable les tests de mauvaise boutique, de source manquante, de fichier invalide et de délai d’attente du fournisseur dépassé réussissent 3
Évalué le rapport sur les données réservées est écrit et Priya l’a révisé 4
Livré un ordinateur vierge exécute la démo à partir du README; Omar a vu la démo 5

L’ordre compte. « Un parcours » vient avant « Sûr et fiable » : d’abord un flux complet, puis les cas difficiles. Un jalon qui nomme une personne, comme Kwame ou Priya, indique aussi qui doit confirmer qu’il est terminé.

Limitez la portée lorsque vous devez terminer et prouver quelque chose dans un délai fixe. Cela peut être un projet intégrateur, un projet pilote ou une première version pour un client. Un utilisateur et une décision vous donnent des questions de test avec une seule bonne réponse. Ces questions sont la base de tout le travail des modules 3 à 5.

Limiter la portée a un coût. Certaines personnes ne reçoivent rien, par exemple les clients des boutiques. La démo paraît plus petite que l’idée de Tomás. Et une fiche de projet limitée est plus difficile à écrire qu’une fiche large. Chaque ligne est un choix que quelqu’un peut remettre en question. Une portée large peut convenir à une courte expérience qui explore seulement des idées. Elle ne convient pas à un projet de portfolio, où un réviseur demande avant tout : « Est-ce que ça fonctionne, et comment le savez-vous? »

Chaque fonctionnalité doit répondre à un besoin énoncé dans la fiche de projet. Voici sept fonctionnalités demandées. Pour chacune, trouvez la ligne de la fiche de Sam à laquelle elle répond, ou indiquez qu’il s’agit d’une exclusion. Ouvrez ensuite la réponse.

  1. Chaque affirmation d’une réponse cite un passage des documents de la boutique.
  2. Un historique de conversation, pour que le personnel puisse poser des questions de suivi.
  3. Le personnel téléverse une politique en PDF et voit quand elle est prête.
  4. L’assistant envoie la réponse au client par courriel.
  5. Un mode sombre pour la page.
  6. Des réponses en français aux questions en français sur les deux documents québécois de Larkfield.
  7. Le personnel supprime un document périmé.
Afficher la réponse
  1. Répond à un besoin : « une réponse courte avec une citation pour chaque affirmation ». Cela facilite aussi la décision : le personnel peut vérifier la réponse avant de parler.
  2. Exclusion : « Aucun historique de conversation ni aucune question de suivi : une question, une réponse. »
  3. Répond à un besoin : les « politiques propres à chaque boutique » ne peuvent être lues que si le personnel peut les ajouter. L’état compte, car le personnel doit savoir quand une nouvelle politique est utilisée.
  4. Exclusion : « Aucune réponse envoyée directement aux clients : le personnel lit la réponse et décide. »
  5. Aucun besoin énoncé. Rien dans la fiche de projet ne le demande. Ce n’est pas interdit, mais cela attend que tous les jalons soient terminés. Si le personnel de Grace travaille dans une pièce sombre et le demande, la fiche de projet doit d’abord changer.
  6. Répond à un besoin, dans certaines limites : l’exclusion dit « Aucune autre langue que celles des documents ». Deux documents de Larkfield sont en français; une question en français à leur sujet entre donc dans la portée.
  7. Répond à un besoin : une politique périmée cause précisément l’erreur de la fiche de projet, soit l’ancien délai de retour de 30 jours. La supprimer pour qu’aucune réponse future ne l’utilise facilite la décision.

Une fonctionnalité sans besoin énoncé, comme la numéro 5, n’est pas « mauvaise ». Elle ne fait pas partie de ce projet tant que la fiche de projet ne lui donne pas de raison d’être.

À vous de jouer : un autre utilisateur, les mêmes documents

Section intitulée « À vous de jouer : un autre utilisateur, les mêmes documents »

Changez une condition : l’utilisateur. Imaginez que Bramble Books veut l’assistant pour ses clients sur son site Web, et non pour son personnel. Les documents restent les mêmes. Avant d’ouvrir la réponse, faites une prédiction : quelles lignes de la fiche de projet changent? Quelles nouvelles exclusions ou règles apparaissent?

Afficher la réponse

Presque toutes les lignes changent, même si les documents sont les mêmes :

  • Utilisateur et décision : un client qui veut savoir, par exemple, s’il peut retourner un cadeau. La décision appartient au client, et aucun membre du personnel ne vérifie d’abord la réponse.
  • Documents : les trois documents de Bramble Books réservés au personnel doivent être exclus : conditions de vente en gros, approbation des remboursements et rabais du personnel. Un client ne doit jamais les voir.
  • Exclusions et règles : la réponse va directement au client; l’exclusion « le personnel lit la réponse et décide » disparaît donc. Le produit exige maintenant des règles plus strictes : formulation polie, aucune procédure interne et un moyen clair de joindre une personne.
  • Réussite : « le personnel obtient une réponse pendant que le client attend » devient « le client obtient une bonne réponse sans appeler la boutique ».

C’est pourquoi l’utilisateur vient en premier. Les mêmes documents servent un produit très différent lorsque la personne qui lit la réponse change. Sam conserve la version pour le personnel : elle est plus sûre, car une personne vérifie chaque réponse. Elle correspond aussi à ce que Grace et Ines ont demandé.

Erreur courante

Trop de fonctionnalités avant qu'un seul parcours fonctionne

Symptôme : après trois semaines, le projet a une fenêtre de clavardage, un agent à moitié construit, une page de connexion et un script qui lit des fichiers PDF. Aucun de ces éléments ne se connecte aux autres. Personne ne peut téléverser un document et obtenir une réponse avec des sources citées du début à la fin.

Cause : la fiche de projet n’indiquait aucune exclusion, ou personne ne les a lues. Chaque nouvelle idée semblait petite le jour où elle arrivait.

Solution : revenez aux jalons. Terminez « Un parcours » avant de commencer autre chose. Déplacez toutes les autres fonctionnalités vers les exclusions ou les prolongements du module 7. C’est pour cette raison que le module 3 construit exactement un parcours.

Erreur courante

Des documents privés dans une démo publique

Symptôme : dans l’option projet personnel, une personne utilise les documents internes de son employeur « parce qu’ils sont réalistes ». La démo se trouve sur une page publique de portfolio.

Cause : les données réalistes semblaient plus impressionnantes que l’autorisation. Mais les documents appartiennent à quelqu’un d’autre. Ils peuvent contenir des noms, des prix et des procédures qui ne doivent pas être publics.

Solution : utilisez seulement des documents publics sous licence ouverte, des documents avec l’autorisation écrite de leur propriétaire ou des documents synthétiques. Si vous avez utilisé des documents privés, retirez la démo, supprimez les documents du dépôt et de son historique, et avisez le propriétaire. Des documents synthétiques avec les bonnes difficultés font un projet de portfolio tout aussi solide. Le module 2 montre comment les rédiger.

Rédigez votre propre fiche de projet.

  1. Copiez le modèle dans docs/ :

    Fenêtre de terminal
    cp docs/templates/project-brief.md docs/project-brief.md
  2. Ouvrez docs/project-brief.md et remplacez chaque ligne entre chevrons.

  3. Sous « How they do it today » (comment ils font aujourd’hui), nommez au moins une erreur réelle que votre produit doit prévenir.

  4. Rédigez au moins trois exclusions, chacune avec une courte raison.

  5. Faites le test des dix questions. Si vous ne pouvez pas rédiger dix questions avec leurs réponses et leurs sources en environ 30 minutes, réduisez la portée. Ciblez davantage l’utilisateur, la décision ou les documents.

  6. Enregistrez la fiche dans un commit (enregistrement des modifications).

Dans l’option standard, votre utilisateur, votre décision et vos documents ressemblent à ceux de Sam. Rédigez quand même la fiche dans vos propres mots, et choisissez vos propres exclusions et jalons. Dans l’option projet personnel, nommez chaque source de vos documents et sa licence ou son autorisation.

Preuves à conserver : docs/project-brief.md et son commit, ainsi que vos dix questions de test (nécessaires dans Planifier les preuves).

Liste de vérification

  • Un seul type d’utilisateur, nommé par son rôle.
  • Une seule décision, en une phrase.
  • Une collection de documents nommée : contenu, nombre, formats, propriétaire et raison pour laquelle vous pouvez l’utiliser.
  • Au moins une erreur réelle que le produit doit prévenir.
  • Au moins trois exclusions, chacune avec une raison.
  • Des jalons avec une condition observable « terminé quand »; « un parcours » vient avant les cas difficiles.
  • Dix questions de test avec leurs réponses et leurs sources.

Vérifiez votre compréhension

Nommez les quatre parties de la portée d'un projet dans cette leçon. Dites en une phrase contre quoi chacune vous protège.

Afficher la réponse
  • Un utilisateur : des réponses qui tentent de convenir à tout le monde et ne conviennent à personne. L’utilisateur détermine les mots, les documents et les risques.
  • Une décision : un produit sans tâche claire, où aucune question de test n’a une seule bonne réponse.
  • Une collection de documents restreinte : des réponses que personne ne peut vérifier dans une source nommée, et des documents que vous ne pouvez pas utiliser.
  • Des exclusions : de nouvelles fonctionnalités qui arrivent chaque semaine, jusqu’à ce qu’aucun parcours ne fonctionne. Chaque exclusion est une décision prise une fois.

Vérifiez votre compréhension

Prédisez : Tomás dit : « Rédige la fiche plus tard. Construis d'abord, puis regarde ce que les utilisateurs aiment. » Qu'est-ce qui tourne mal dans ce projet intégrateur si Sam accepte?

Afficher la réponse

Sam ne peut pas rédiger de questions de test avec une seule bonne réponse. Rien ne précise qui pose la question, quel magasin, quelle date ou quel document. Au module 5, il n’y a donc aucune référence fixe pour mesurer les résultats, et on peut justifier chaque résultat. De nouvelles fonctionnalités arrivent sans filtre, et après trois semaines, aucun parcours ne fonctionne. La fiche demande environ une heure maintenant. Sans elle, « regarder ce que les utilisateurs aiment » devient « construire beaucoup de fonctionnalités incomplètes sans en démontrer aucune ».

Vérifiez votre compréhension

Vérification pratique : montrez votre fiche. Quel utilisateur, quelle décision, quels documents, quelles exclusions et quelle question de test montrent que la portée est assez restreinte?

Afficher la réponse

Une bonne réponse nomme un seul type d’utilisateur par son rôle et une seule décision en une phrase. Elle nomme une collection de documents, sa taille, ses formats et son autorisation, ainsi qu’au moins trois exclusions avec leurs raisons. Dans l’option standard, par exemple :

  • Utilisateur : le personnel du service de soutien de Larkfield et de Bramble Books.
  • Décision : répondre correctement à une question sur les politiques pendant que le client attend.
  • Documents : les politiques synthétiques des deux magasins, 36 et 15 documents, CC0.
  • Exclusions : aucune réponse aux clients, aucun historique de clavardage, aucun agent.

Une question de test a une seule bonne réponse et une seule source. Par exemple, « Combien de temps prend la livraison en Ontario? » chez Bramble Books : de 4 à 8 jours, selon la politique de livraison.

Récapitulatif

  • Une idée vague comme « un assistant d’IA pour les magasins » n’est pas seulement vaste : elle est impossible à tester, car aucune question de test n’a une seule bonne réponse.
  • Une portée répond à quatre questions : un utilisateur, une décision, une collection de documents restreinte et des exclusions, ce que le produit ne fera pas.
  • Le test des dix questions : si vous pouvez rédiger dix questions réelles avec leurs réponses et leurs sources en environ 30 minutes, la portée est assez restreinte.
  • La fiche de Sam : le personnel du service de soutien de Larkfield et de Bramble Books répond aux questions des clients sur les politiques à partir de 36 et 15 documents synthétiques, avec cinq exclusions. L’agent attend que les fonctions essentielles fonctionnent.
  • Un jalon a une condition observable « terminé quand ». Un parcours complet vient avant les cas difficiles.
  • Chaque fonctionnalité doit répondre à un besoin indiqué dans la fiche.

Ensuite, vous transformerez « il devrait donner de bonnes réponses » en critères qu’une personne ou un script peut vérifier.

Leçon suivante : Critères d'acceptation