Aller au contenu
English

Préparer le dossier de conception

  • Leçon 1
  • 40 min
  • Module 1 : Commencer par les besoins

Où nous en sommes

Vous connaissez déjà l'assistant documentaire du cours RAG : créer une IA qui utilise vos données, et la séparation des données de chaque boutique du cours Authentification, autorisations et applications multilocataires. Une deuxième boutique veut maintenant le même assistant, et Omar demande : « Combien coûtera-t-il par boutique? » Une réponse comme « environ un cent par question » ne peut pas être vérifiée. Dans cette leçon, nous préparons le dossier de conception, où chaque nombre indique d'où il vient, comme le devis d'un entrepreneur sur une page.

Ce que vous saurez faire

Copiez le projet du cours, le dossier de conception, sur votre ordinateur. Exécutez son calculateur de coûts pour la première fois. Découvrez ensuite la règle suivie dans tout le cours : chaque nombre est une mesure, un prix ou une hypothèse. Il indique toujours sa catégorie.

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

Ce que vous devez savoir

Ce qu’il vous faut sur votre ordinateur

  • Python 3.12 ou une version plus récente, VS Code (ou tout autre éditeur de texte) et un terminal.
  • Environ 40 Mo d’espace disque libre pour l’environnement virtuel.
  • Aucun compte, aucune clé et aucune dépense. Le calculateur ne fait aucun appel réseau.

Testé avec Python 3.12 sur macOS (Apple silicon). Les commandes Windows (PowerShell) et Linux sont fournies, mais non testées.

Imaginez deux entrepreneurs qui vous proposent un devis pour un nouveau plancher de cuisine. Le premier dit : « Environ 5 000 dollars. » Le deuxième vous remet une page :

  • « Le plancher mesure 4,2 m sur 3,5 m : je l’ai mesuré. Cela donne 14,7 mètres carrés. »
  • « Les carreaux coûtent 38 dollars par mètre carré dans le catalogue du magasin. »
  • « Je prévois deux jours de travail, trois si l’ancien plancher est endommagé. »

Le premier devis est plus court. Mais vous ne pouvez ni le vérifier ni le modifier. Si vous choisissez des carreaux moins chers, quel sera le nouveau prix? Si l’ancien plancher est endommagé, combien coûtera le supplément? Seul l’entrepreneur le sait.

Le deuxième devis vous permet de répondre à ces questions. Chaque nombre indique sa provenance. Certains nombres sont mesurés (la pièce). Certains sont un prix publié (les carreaux). Certains sont une hypothèse (deux jours de travail). L’entrepreneur le précise et donne une plage de valeurs. Vous pouvez modifier un nombre et refaire le calcul vous-même.

Le problème : un nombre que personne ne peut vérifier

Section intitulée « Le problème : un nombre que personne ne peut vérifier »

Le service de soutien de Larkfield dispose d’un assistant documentaire. Il répond aux questions à partir des documents de Larkfield, avec des citations. Bramble Books, une petite librairie sur la plateforme de soutien de Larkfield, veut le même assistant. Omar, le gestionnaire de produit, espère qu’un troisième et un quatrième commerce se joindront à la plateforme l’an prochain. Omar pose donc une question : « Combien cela coûtera-t-il par commerce? »

Tomás, un ingénieur en IA, répond aussitôt : « Environ un cent par question. » Cela semble utile, alors vérifiez cette réponse. Omar ne sait pas combien de questions il y aura. Si les commerces posent 400 questions par jour, à un cent chacune, cela fait 120 dollars par mois. S’ils en posent 5 000 par jour, cela fait 1 500 dollars par mois. D’où vient ce cent? Comprend-il seulement le modèle, ou aussi la base de données et les serveurs? Change-t-il si l’utilisation double?

Le nombre de Tomás a le même problème que le devis du premier entrepreneur. Il n’a aucun volume (combien de questions), aucune source (d’où vient le cent) et aucune hypothèse vérifiable. Personne ne peut dire s’il est juste. Personne ne peut modifier une donnée d’entrée et voir le nouveau résultat. Et quand la facture arrive, personne ne peut dire quelle partie était erronée.

Kwame, l’architecte de solutions, est responsable de la proposition pour l’assistant partagé. Il veut une proposition comme la page du deuxième entrepreneur. C’est ce que vous construirez dans ce cours, un module à la fois.

L’idée : un dossier de conception avec trois catégories de nombres

Section intitulée « L’idée : un dossier de conception avec trois catégories de nombres »

Un dossier de conception contient la conception d’un système et tout ce qu’il faut pour la vérifier. Le dossier de Kwame contient les exigences, les diagrammes, les décisions et un petit calculateur de coûts. Le calculateur lit ses nombres dans des fichiers texte. Il ne cache aucun nombre dans son code.

Chaque nombre du dossier appartient à l’une de ces trois catégories :

  • Mesure. Une exécution de code enregistré dans le dépôt l’a produit, et le dossier indique cette exécution. Par exemple : le petit modèle conversationnel a répondu en 1,52 seconde (médiane) sur 67 questions, en deux passages. Les questions étaient posées une à la fois. Toute personne ayant le code et les données peut refaire l’exécution.
  • Prix. Un prix courant publié, et le dossier indique la page de prix. Par exemple : le petit modèle conversationnel coûte 0,10 $ US par million de jetons d’entrée. Les prix changent. Consultez donc la page actuelle avant une vraie décision.
  • Hypothèse. Une valeur que vous avez choisie, car personne ne peut encore la mesurer. Le dossier l’indique comme une plage de trois valeurs (basse, de base et haute) et en donne la raison. Par exemple : 800 clients de Larkfield posent une question chaque jour, entre 300 et 1 600.

Le diagramme montre comment déterminer la catégorie d’un nombre.

Un flux de décision. Un nombre dans la proposition. Première question : une exécution de code enregistré dans le dépôt l'a-t-elle produit? Oui mène à mesure : indiquez l'exécution, l'objet de la mesure, le nombre de répétitions et la machine. Non mène à la deuxième question : figure-t-il sur une page de prix publiée? Oui mène à prix : indiquez la page; les prix changent, alors vérifiez-la de nouveau. Non mène à hypothèse : donnez une plage de valeurs basse, de base et haute, ainsi que la raison.
Deux questions classent chaque nombre dans l'une des trois catégories. Chaque catégorie a sa règle : indiquer l'exécution, indiquer la page, ou donner une plage et une raison.
Description textuelle du diagramme

Le flux commence par un nombre de la proposition. Première question : une exécution de code enregistré dans le dépôt l’a-t-elle produit? Si oui, le nombre est une mesure, et vous indiquez l’exécution. Précisez ce qui a été mesuré, combien de fois et sur quelle machine. Sinon, la deuxième question est : figure-t-il sur une page de prix publiée? Si oui, le nombre est un prix, et vous indiquez la page. Vérifiez-la de nouveau avant une décision, car les prix changent. Sinon, le nombre est une hypothèse. Vous lui donnez une plage de trois valeurs, basse, de base et haute, et vous écrivez la raison.

Pourquoi la catégorie compte-t-elle? Parce que chaque catégorie peut poser un problème différent. Un nombre mesuré peut provenir d’une autre machine ou d’un autre jour. Les durées changent, mais la tendance du résultat reste. Un prix peut être périmé. Une hypothèse peut être fausse, et rien dans le dossier ne le montre avant le début de l’utilisation réelle. Le dossier sépare donc les trois catégories, et la proposition indique quelles hypothèses vérifier en premier.

Une hypothèse n’est pas une erreur. Une hypothèse cachée en est une. « Un cent par question » cache au moins trois hypothèses. Le dossier de Kwame les rend visibles.

Un petit exemple : le coût du modèle pour une réponse

Section intitulée « Un petit exemple : le coût du modèle pour une réponse »

Voici un calcul du dossier, avec toutes les valeurs visibles. Pour répondre à une question, l’assistant envoie la question et cinq passages des documents du commerce au petit modèle conversationnel. Le modèle lit les jetons d’entrée et écrit les jetons de sortie. Un jeton (token) est un morceau de mot; le fournisseur facture par million de jetons.

Valeur Nombre Catégorie Provenance
Jetons d’entrée par réponse 946,5 mesure l’exécution de l’équipe du cours : 67 questions, 2 passages, moyenne
Jetons de sortie par réponse 152,75 mesure la même exécution
Prix des jetons d’entrée 0,10 $ US par million prix la page de prix du fournisseur
Prix des jetons de sortie 0,50 $ US par million prix la même page

Le calcul, une étape à la fois :

  • Entrée : 946,5 jetons × 0,10 $ US ÷ 1 000 000 = 0,0000947 $ US.
  • Sortie : 152,75 jetons × 0,50 $ US ÷ 1 000 000 = 0,0000764 $ US.
  • Une réponse : 0,0000947 $ US + 0,0000764 $ US = 0,000171 $ US.

Cela représente moins de deux centièmes de cent pour la part du modèle dans une réponse. Ajoutez maintenant une hypothèse. Supposons que les commerces posent 1 000 questions par jour. Ce nombre est inventé uniquement pour cet exemple. Le modèle coûte alors 1 000 × 0,000171 $ US = 0,171 $ US par jour. Cela donne environ 5,13 $ US pour un mois de 30 jours.

Observez ce qui a changé. Les trois premières étapes utilisaient seulement des mesures et des prix. Seule la dernière étape nécessitait une hypothèse, et vous pouvez la voir. Si Omar dit « plutôt 2 000 par jour », vous modifiez un nombre. Vous voyez aussi ce que ce calcul exclut : la base de données, les serveurs, les journaux (logs). Le « un cent » de Tomás ne vous donnait aucune de ces informations. Le module 3 ajoute les autres parties, un facteur de coût à la fois.

Kwame ne travaille pas seul. Omar apporte les objectifs d’affaires et la taille des commerces. Amira, la développeuse, sait ce que le code fait aujourd’hui et ce que coûte une modification. Mei, l’ingénieure de données, est responsable du stockage, des sauvegardes et des restaurations. Priya, la scientifique des données, est responsable de l’évaluation de la qualité. Grace dirige l’équipe de soutien de Larkfield, et Ines est propriétaire de Bramble Books. Grace et Ines définissent « bon » et « assez rapide » pour les personnes qui utilisent l’assistant.

La proposition se construit un module à la fois, et chaque module enrichit le dossier :

Module Ce qu’il ajoute au dossier
Commencer par les besoins requirements.md (utilisateurs, parcours, cibles de qualité), demand.toml (demande sous forme de plages)
Concevoir l’architecture de bout en bout architecture/ : le diagramme de conteneurs, le flux des requêtes, la séquence d’ingestion
Estimer les ressources et le coût design.toml, le calcul de la charge de travail, le coût par facteur, le coût par commerce
Optimiser avec des compromis mesurés le routage entre modèles, le cache et le traitement par lots, construire ou acheter
Concevoir pour les défaillances et la croissance les modes de défaillance, les cibles de reprise et un plan de croissance
Présenter la proposition les fiches de décision, une feuille de route et une présentation de dix minutes
Un flux de gauche à droite. Trois fichiers d'entrée, un par catégorie de nombres : prices.toml contient 35 prix courants, chacun indiquant sa page de prix; measured.toml contient 39 valeurs, chacune indiquant son exécution; demand.toml du module 1 et design.toml du module 3 contiennent les hypothèses, chacune avec une plage et une raison. Les trois alimentent python -m costmodel, le calculateur, qui utilise seulement la bibliothèque standard. Les tests vérifient le calculateur, comme l'indique une flèche pointillée. Le calculateur écrit des tableaux dans le terminal et dans costs.csv. Ceux-ci alimentent la proposition de Kwame : requirements.md, diagrammes et décisions.
Le dossier de conception. Le calculateur n'a aucun nombre propre : il les lit dans trois catégories de fichiers d'entrée. Les tests le vérifient.
Description textuelle du diagramme

À gauche se trouvent les fichiers d’entrée, avec une couleur par catégorie de nombres. Le fichier prices.toml contient 35 prix courants, chacun indiquant sa page de prix. measured.toml contient 39 valeurs mesurées, chacune indiquant l’exécution dont elle provient. demand.toml, que vous remplirez dans ce module, et design.toml, du module 3, contiennent les hypothèses. Chaque valeur est une plage accompagnée d’une raison. Les trois fichiers alimentent le calculateur, python -m costmodel, qui utilise seulement la bibliothèque standard de Python. Les tests vérifient le calculateur. Le calculateur affiche des tableaux dans le terminal et peut écrire costs.csv pour un tableur. Ces résultats vont dans la proposition de Kwame, avec les exigences, les diagrammes et les décisions.

Les prix et les valeurs mesurées sont fournis : l’équipe du cours les a recueillis. L’équipe a fait 659 appels réels à un fournisseur de modèles hébergés et consulté sa liste de prix publique. Vous ne refaites pas ces exécutions, et vous n’avez besoin d’aucun compte. Votre travail dans ce cours est la conception : les exigences, les hypothèses, les diagrammes et les décisions.

Copiez l’instantané start (début) du dossier dans un nouveau dossier, créez un environnement virtuel et exécutez les tests. Un instantané est une copie du dossier à un moment du cours. Si votre dossier ne fonctionne plus, copiez l’instantané de votre dernier module terminé et continuez.

  1. Ouvrez un terminal et allez dans votre dossier de projets, par exemple ~/projects. Si vous avez Git, clonez le dépôt des exercices une fois. Si vous l’avez déjà cloné, exécutez plutôt git -C nextia-learning-labs pull.

    Fenêtre de terminal
    cd ~/projects
    git clone https://github.com/Nextia-Intelligence/nextia-learning-labs.git

    Sans Git, téléchargez le fichier ZIP du dépôt, puis décompressez-le dans ~/projects. Son dossier s’appelle alors nextia-learning-labs-main. Utilisez ce nom dans les prochaines étapes.

  2. Copiez l’instantané start dans un nouveau dossier design-pack, puis allez dans ce dossier :

    Fenêtre de terminal
    cp -R nextia-learning-labs/C26/snapshots/start design-pack
    cd design-pack
  3. Ouvrez le dossier design-pack dans VS Code. Toutes les commandes de ce cours s’exécutent dans ce dossier.

  4. Créez l’environnement virtuel, activez-le et installez les deux outils pour les tests : pytest et ruff.

    Fenêtre de terminal
    python3 -m venv .venv
    source .venv/bin/activate
    python -m pip install -r requirements-dev.txt

    L’invite commence maintenant par (.venv). Le calculateur lui-même n’a besoin de rien provenant de pip : il utilise seulement la bibliothèque standard.

  5. Exécutez les tests :

    Fenêtre de terminal
    python -m pytest -q
    ...... [100%]
    6 passed in 0.01s

    Six tests vérifient que chaque prix indique une page, que chaque mesure indique une exécution et que les entrées incorrectes sont refusées. Votre durée peut être différente.

  6. Exécutez le calculateur sans commande. Il indique ce qu’il peut calculer maintenant :

    Fenêtre de terminal
    python -m costmodel
    Prices: 35 (each with its source page)
    Measured values: 39 (each with the run it comes from)
    Demand values: 0 (fill in demand.toml in Module 1)
    Next: describe the users and fill in demand.toml (Module 1).

Vous avez maintenant un dossier fonctionnel. Il contient 35 prix et 39 valeurs mesurées, mais aucune hypothèse sur la demande. Le calculateur ne peut encore rien dire sur le coût. Personne n’a précisé qui utilise l’assistant ni à quelle fréquence. C’est le rôle de ce module.

Essayez une commande d’une leçon ultérieure, par exemple python -m costmodel demand. Le calculateur ne plante pas. Il indique quand la commande sera disponible :

This command arrives in Module 1. Download the end-of-module-1 snapshot or keep going.
Fichier ou dossier Ce que c’est
prices.toml 35 prix courants. Chacun a un value (valeur), un unit (unité) et un source (source) commençant par price: (prix) ou price page: (page de prix).
measured.toml 39 valeurs mesurées. Chaque source commence par measured: (mesuré) et indique l’exécution.
demand.toml Un modèle à remplir dans Hypothèses de demande.
requirements.md Un modèle à remplir dans les deux prochaines leçons.
costmodel/ Le calculateur. inputs.py lit les fichiers et refuse un nombre qui n’indique pas sa catégorie.
tests/ Les tests du calculateur.
README.md Toutes les commandes et la marche à suivre pour réinitialiser le dossier.

Ouvrez prices.toml dans VS Code. Chaque prix est un petit tableau. Voici le premier :

[chat_small_input]
value = 0.1
unit = "US$ per 1M tokens"
source = "price: https://azure.microsoft.com/pricing/details/cognitive-services/openai-service/ (Azure Retail Prices API (prices.azure.com/api/retail/prices): 6-luna ShortCo Inp Std Gl 1M Tokens)"
note = "chat-small (gpt-6-luna), Global Standard, input tokens"

La ligne source (source) indique la page publique des prix et la ligne de la liste de prix du fournisseur. Le cours utilise Azure Retail Prices API, une liste publique qui ne demande aucun compte. « chat-small » est le nom donné dans le cours au petit modèle de conversation; « chat-strong » désigne le modèle puissant. Les prix changent : vérifiez la page actuelle avant d’utiliser un prix dans une vraie proposition. Les commentaires au début du fichier indiquent quand la liste de prix a été consultée. Faites de même dans vos propositions : notez la date de vérification des prix.

Certains prix ne sont pas des montants par heure ou par gigaoctet. Ce sont des règles sur la page des prix, comme « les 5 premiers Go de journaux chaque mois sont gratuits ». Leur source commence par price page: (page des prix), car la page les décrit en mots.

Ouvrez maintenant measured.toml. Voici une valeur :

[answer_small_p50_s]
value = 1.5165
unit = "seconds (median)"
source = "measured: the course team's run, the RAG course's 67 questions with its best search results, 2 passes, one question at a time, chat-small"

La ligne source indique ce qui a été mesuré, sur quelles questions, combien de fois et comment. Cela suffit pour juger le nombre. Ces durées proviennent d’un après-midi de mesures, un appel à la fois, depuis l’ordinateur de l’équipe du cours. Votre réseau donne d’autres durées, mais la tendance reste la même : le modèle puissant est plus lent que le petit.

Certaines valeurs mesurées proviennent des cours précédents, et la source le précise. La durée du modèle de reclassement (reranker) provient du cours RAG : créer une IA qui utilise vos données; le quota du fournisseur provient du cours Mettre à l’échelle les API et les charges de travail d’IA. Le dossier ne mesure pas de nouveau ce qu’un cours précédent a mesuré.

Classez chaque nombre comme mesure, prix ou hypothèse. Utilisez les deux questions du diagramme. Ouvrez ensuite la réponse.

  1. « Serveur PostgreSQL B1ms : 0,0185 $ US par heure. »
  2. « Le plongement (embedding) de la question a pris 0,34 s (médiane) sur 67 questions. »
  3. « Bramble Books aura 25 documents l’an prochain. »
  4. « Le fournisseur autorise 100 requêtes de conversation par minute sur le compte de l’équipe du cours. »
  5. « Les 100 premiers Go de données envoyées sur Internet chaque mois sont gratuits. »
  6. « Un client pose habituellement une question, puis une question de suivi. »
Afficher la réponse
  1. Prix. pg_b1ms_hour dans prices.toml, provenant de la page des prix de PostgreSQL.
  2. Mesure. question_embed_p50_s dans measured.toml : une exécution de 67 appels.
  3. Hypothèse. Ines le prévoit, mais personne ne peut mesurer l’an prochain. Cela devient une plage dans demand.toml.
  4. Mesure. provider_quota_requests_per_minute : le cours sur la mise à l’échelle l’a lu dans les en-têtes de limite de débit du fournisseur. Ce quota vaut pour ce compte; un autre compte peut avoir un autre quota.
  5. Prix. Une règle sur la page des prix (egress_free_gb_month, source price page:).
  6. Hypothèse. Il n’y a pas encore de données. Dans demand.toml, cela devient customer_questions_per_day = [1.0, 1.5, 3.0].

Le numéro 4 est le plus difficile. Il ressemble à un fait sur le fournisseur, mais c’est une mesure pour un compte. Si votre compte a un autre quota, mesurez-le de nouveau.

Utilisez-en un dès qu’une décision dépend de nombres auxquels d’autres personnes doivent faire confiance : coût par client, taille de serveur, choix entre deux services. Notez chaque nombre avec son type et sa source, et gardez le calcul dans un fichier, pas dans votre tête. Chacun peut alors le vérifier, changer une hypothèse et obtenir le nouveau résultat en une seconde.

Ne créez pas de calculateur pour une décision qu’une simple somme sur papier peut résoudre. Si la question se résume à « est-ce 5 $ US ou 500 $ US par mois? », une ligne avec trois nombres suffit. Le dossier devient utile quand il y a plusieurs éléments, plusieurs personnes et plusieurs scénarios.

Il a un coût. Chaque nombre a besoin d’une source, et quelqu’un doit revérifier les prix et les hypothèses avant la décision. Kwame accepte ce coût, car Omar utilisera le résultat pour fixer un prix pour les boutiques.

Erreur courante

Un prix sans source

Symptôme : vous ajoutez ou modifiez un prix et oubliez sa ligne source. Le calculateur s’arrête immédiatement :

Input problem: prices.toml: price 'chat_small_output' has no source

Les tests échouent aussi : 1 failed, 5 passed (1 échec, 5 réussites), dans test_the_pack_prices_all_have_a_source.

Cause : le calculateur refuse un nombre qui ne précise pas ce qu’il est. C’est volontaire. Un prix sans page est une supposition qui ressemble à un fait.

Solution : ajoutez la ligne source, en commençant par price: (prix), puis la page. Si vous ne trouvez pas de page, le nombre n’est pas un prix. C’est une hypothèse; placez-la dans demand.toml ou design.toml, avec une plage.

Erreur courante

No module named pytest, ou No module named costmodel

Symptôme : une commande affiche l’une de ces lignes et s’arrête. Les chemins sont raccourcis ici; les vôtres montrent vos propres dossiers.

…/bin/python3.12: No module named pytest
…/design-pack/.venv/bin/python: No module named costmodel

Cause : « No module named pytest » (aucun module nommé pytest) signifie que l’environnement virtuel n’est pas actif. Python ne trouve donc pas les outils que vous avez installés. « No module named costmodel » (aucun module nommé costmodel) signifie que le terminal n’est pas dans le dossier design-pack.

Solution : allez dans le dossier avec cd ~/projects/design-pack. Activez l’environnement : source .venv/bin/activate sur macOS et Linux, .venv\Scripts\Activate.ps1 sur Windows. L’invite commence de nouveau par (.venv).

Réinitialisation. Si votre dossier ne fonctionne plus, renommez-le, recopiez l’instantané start et recréez l’environnement, comme dans les étapes précédentes. Le README des instantanés montre les mêmes étapes pour chaque instantané suivant.

Changez une chose : écrivez un prix sous forme de texte. Dans prices.toml, remplacez la ligne value = 0.1 du premier prix par value = "0.10 US$". Avant toute exécution, faites une prédiction : le calculateur l’accepte-t-il, et sinon, que dit-il? Exécutez ensuite python -m costmodel, puis remettez la ligne d’origine.

Afficher la réponse

Le calculateur le refuse :

Input problem: prices.toml: price 'chat_small_input' must be a number

Un prix est un nombre, avec son unité sur une ligne distincte (unit = "US$ per 1M tokens"). Un texte comme « 0.10 US$ » mélange les deux, et une somme ne peut pas l’utiliser. Le calculateur vérifie cela à la lecture du fichier, avant toute somme. Ainsi, une entrée incorrecte ne devient jamais un coût incorrect. Remettez la ligne à value = 0.1, et python -m pytest -q affiche de nouveau 6 passed (6 réussites).

Vérifiez votre compréhension

Tomás dit que l'assistant coûte « environ un cent par question ». Nommez trois éléments qui manquent à son nombre et expliquez pourquoi chacun compte pour Omar.

Afficher la réponse
  • Le volume. Le nombre de questions par mois. Sans lui, Omar ne peut pas obtenir un coût mensuel. Un cent par question donne 120 dollars par mois à 400 questions par jour, et 1 500 à 5 000.
  • Une source. D’où vient le cent : une exécution mesurée, une page de prix ou une supposition. Sans source, personne ne peut le vérifier ni le mettre à jour quand les prix changent.
  • Les hypothèses et les éléments inclus. Est-ce seulement le modèle, ou aussi les serveurs et la base de données? Que se passe-t-il si l’utilisation double? Sans hypothèses explicites, Omar ne peut pas modifier une entrée et voir le nouveau coût. Et personne ne sait quelle partie était incorrecte quand la facture arrive.

Vérifiez votre compréhension

Faites une prédiction : le fournisseur réduit de moitié le prix des jetons de sortie de chat-small, à 0,25 $ US par million. Utilisez le petit exemple (946,5 jetons d'entrée à 0,10 $ US, 152,75 jetons de sortie) pour calculer le nouveau coût du modèle par réponse. Quel type de nombre avez-vous changé?

Afficher la réponse

Entrée : 946,5 × 0,10 ÷ 1 000 000 = 0,0000947 $ US, sans changement. Sortie : 152,75 × 0,25 ÷ 1 000 000 = 0,0000382 $ US, soit la moitié de 0,0000764 $ US. Une réponse : 0,0000947 $ US + 0,0000382 $ US = environ 0,000133 $ US, au lieu de 0,000171 $ US. C’est environ 22 % de moins, pas 50 %, car les jetons d’entrée coûtent le même prix. Vous avez changé un prix. Les nombres de jetons mesurés restent les mêmes, tout comme les hypothèses sur le volume.

Vérifiez votre compréhension

Vérification pratique : montrez que votre dossier fonctionne. Qu'affichent les tests et le calculateur, et par quoi commence chaque `source` dans les deux fichiers d'entrée?

Afficher la réponse

Les tests affichent 6 passed. Le calculateur affiche Prices: 35 (prix : 35), Measured values: 39 (valeurs mesurées : 39), Demand values: 0 (fill in demand.toml in Module 1) (valeurs de demande : 0; remplissez demand.toml au module 1) et l’étape suivante. Dans prices.toml, chaque source commence par price: ou price page:. La première forme indique une page et une ligne de la liste de prix; la seconde indique une règle décrite en mots sur la page. Dans measured.toml, chaque source commence par measured: (mesuré) et indique l’exécution.

Études de cas de ce cours

À la fin du cours, vous appliquez ce que vous avez appris à un projet réaliste, des données jusqu’à la recommandation. Terminez-en au moins une pour obtenir le certificat; les autres sont facultatives.

Récapitulatif

  • Un nombre sans volume, source ou hypothèses ne peut pas être vérifié ni modifié. « Environ un cent par question » est un tel nombre.
  • Chaque nombre du dossier de conception appartient à l’un de trois types. Mesure : une exécution identifiée de code enregistré dans un commit (enregistrement dans Git). Prix : un prix publié, avec sa page; les prix changent. Hypothèse : une plage avec valeurs basse, de base et haute, accompagnée d’une justification.
  • Le coût du modèle par réponse est de 946,5 jetons × 0,10 $ US par million + 152,75 jetons × 0,50 $ US par million = 0,000171 $ US. Seul le volume demande une hypothèse.
  • Votre dossier fonctionne : python -m pytest -q affiche 6 passed, et python -m costmodel compte 35 prix, 39 valeurs mesurées et 0 valeur de demande.
  • Le calculateur refuse un prix sans source ou un prix sous forme de texte.

Ensuite, avant tout nombre sur la demande, vous décrivez qui utilise l’assistant et ce dont chaque personne a besoin.

Leçon suivante : Utilisateurs et flux de travail