Vue d'ensemble du projet rappels

Cette section se construit autour d’un projet fil rouge : un système de rappels piloté par Claude. L’objectif tient en une phrase — pouvoir dire « Programme un rappel pour mon rendez-vous chez le médecin, c’est jeudi dans une semaine » et obtenir un « OK, je vous rappellerai » qui débouche sur un vrai rappel, programmé à la bonne date. Une demande banale en apparence, et c’est précisément ce qui en fait un excellent terrain d’apprentissage : elle est impossible à satisfaire avec tout ce que nous avons vu jusqu’ici.

Pourquoi c’est plus complexe qu’il n’y paraît

Décortiquez la phrase de l’utilisateur, et trois obstacles apparaissent, chacun touchant une limitation structurelle des modèles de langage :

• Il ne connaît pas toujours l’heure exacte
• Il ne gère pas toujours bien l’arithmétique sur les dates
• Il ne sait pas programmer de rappels

Le premier obstacle vient de la nature même de l’entraînement : les connaissances de Claude s’arrêtent à une date de coupure, et rien dans une requête API ne lui dit quel jour on est. « Jeudi dans une semaine » est indéchiffrable sans point de départ. Le deuxième est plus subtil : même en lui donnant la date du jour, l’arithmétique calendaire — années bissextiles, mois de longueurs inégales, « 379 jours plus tard » — se prête mal à une génération token par token ; le modèle peut se tromper avec un aplomb parfait. Le troisième est le plus fondamental : un modèle de langage produit du texte, rien d’autre. Écrire « je vous rappellerai » ne crée aucun rappel nulle part — il n’a aucun moyen d’agir sur le monde.

Ces trois manques ont un remède commun, et c’est tout le sujet de la section : les outils. Chaque limitation sera comblée par une fonction que notre code met à disposition de Claude.

Trois outils nécessaires

1. Obtenir la date et l’heure actuelles

Le premier outil règle le problème du point de départ : il donne à Claude la date et l’heure courantes, lues sur l’horloge du serveur. Avec cette ancre, « jeudi prochain » ou « dans trois jours » deviennent des expressions calculables.

2. Ajouter une durée à une date

Le deuxième outil prend en charge les calculs d’ajout de temps — jours, semaines, mois — à une date donnée. Plutôt que de compter sur Claude pour calculer correctement « quelle date est dans 379 jours ? », on lui fournit un outil fiable : la bibliothèque de dates de Python fait ce calcul exactement, à chaque fois. C’est un principe de conception qui dépasse ce projet — confier au code ce que le code fait mieux, et garder le modèle pour ce qu’il fait de mieux : comprendre la demande et orchestrer.

3. Programmer un rappel

Le troisième outil fournit le mécanisme d’action : créer effectivement un rappel. Dans notre version pédagogique, il se contentera de simuler l’enregistrement ; dans une application réelle, la même signature brancherait une base de données, un service de notifications ou un calendrier. Pour Claude, cela ne change rien — il voit un outil « programmer un rappel », il l’appelle avec une date et un message.

La démarche

Nous implémenterons ces outils un par un, en commençant par l’outil datetime : c’est le plus simple, et il suffit à dérouler tout le mécanisme — fonction, schéma, appel, résultat. Les leçons suivantes y ajouteront les deux autres et la boucle de conversation qui permet à Claude de les enchaîner. À la fin de la section, la phrase « programme un rappel pour jeudi prochain » traversera le système de bout en bout : compréhension par Claude, calculs par vos fonctions, réponse confirmée à l’utilisateur.

Points clés à retenir

• Le projet fil rouge : un système de rappels en langage naturel, impossible sans outils
• Trois limitations structurelles : pas d’accès à l’heure, arithmétique calendaire peu fiable, aucune capacité d’action
• Chaque limitation est comblée par un outil : date courante, calcul de durée, programmation du rappel
• Principe de conception : le code calcule et agit, le modèle comprend et orchestre
• Construction progressive : un outil pour comprendre le mécanisme, puis les autres et la boucle qui les enchaîne