Lewis Hamilton a passé 21,601 secondes dans la voie des stands au 8e tour du Grand Prix d’Abou Dhabi 2025. Sa Ferrari est restée immobile pendant 2,4 secondes. Les deux mesures concernent le même arrêt. Sur la feuille des temps, c’est le 9e tour qui est le plus long de cette phase de sa course.
Vous pouvez reconstituer vous-même la séquence. Vous allez créer Stint Notebook, un agent Quickchat AI qui interroge l’API OpenF1. Demandez les trois tours qui précèdent le premier arrêt de Hamilton et les trois qui le suivent. Vous obtiendrez les chronos des sept tours, le passage des pneus tendres aux pneus durs et les liens vers les données qui étayent la réponse.
Lors de ce test local, Quickchat AI a fourni les données de sept tours et des liens vers les relevés publics des arrêts au stand, des relais et des tours.
Téléchargez le kit Stint Notebook pour retrouver les cinq configurations d’action, le Main Prompt, les réponses OpenF1 enregistrées et un petit script Python prêt à exécuter. Vous pouvez consulter les données d’OpenF1 sans compte OpenF1 ni jeton d’accès à l’API. Vous vous connecterez à Quickchat AI à l’étape 2.
1. Quelle session d’Abou Dhabi consultez-vous ?
Commencez par la course et le pilote. Un week-end de Grand Prix comprend plusieurs sessions, et Hamilton porte le numéro 44 dans chacune d’elles. Un numéro de tour ne prend son sens qu’une fois la session et le pilote identifiés.
- Ouvrez la fiche de la session dans OpenF1. Repérez
Race,Yas Marina Circuitet la date du 7 décembre 2025. Conservezsession_key=9839dans chaque requête. - Ouvrez la fiche du pilote numéro 44. Elle indique Lewis Hamilton et Ferrari. Gardez cet onglet ouvert pendant que vous ajoutez les actions.
Gardez la même course. En changeant uniquement le numéro du pilote, vous pouvez poser la même question à propos d’une autre voiture engagée dans cette course.
Essayez l’exemple sur la page d’accueil d’OpenF1. Sélectionnez Shell, puis cliquez sur Run. L’exemple renvoie les trois premiers tours de Hamilton. Repérez driver_number et lap_number dans la réponse JSON.
Cet exemple renvoie les tours 1 à 3. Plus loin, la question sur l’arrêt au stand porte sur les tours 5 à 11.
OpenF1 propose des données historiques depuis 2023 pour un usage personnel. Son guide d’authentification explique comment accéder aux données en direct.
2. Comment ajouter les deux premières actions à l’agent ?
- Créez un compte Quickchat AI ou connectez-vous. Choisissez Add new AI Agent → Set up manually et nommez l’agent Stint Notebook. Vous aurez besoin de crédits pour les réponses de l’IA et les tests.
- Ouvrez Identity → Main Prompt, collez les instructions ci-dessous, puis enregistrez. Elles indiquent à l’agent quelles données recueillir avant d’expliquer un tour.
- Accédez à Actions & MCPs → Custom Actions → Add Action → API Action → Create manually. Dans API Action Name, saisissez
identify_session. Laissez What to ask the user first vide. Dans API Endpoint, choisissez GET et saisissez l’URL ci-dessous. Laissez Headers et Body vides. - Dans API Action Description, saisissez la description ci-dessous. Enregistrez l’action et activez-la. Procédez de même avec
identify_driver. Pour cette action, ajoutezdriver_numberdans What to ask the user first, choisissez Number, rendez le paramètre obligatoire, puis insérez-le dans l’URL via Add AI Data → Parameters.
La course est déjà définie dans l’URL enregistrée. La recherche du pilote est la première action qui a besoin d’une valeur fournie dans la conversation.
Copier le Main Prompt de Stint Notebook
You are Stint Notebook. Help a race viewer inspect the completed 2025 Abu Dhabi Grand Prix, OpenF1 session 9839. Confirm the Race session and driver with Actions before reporting race facts. For Hamilton use driver 44 and verify his name. If a driver cannot be found, ask for a valid number. Run Actions one at a time. For a stop, fetch the driver's pit events and stints, then fetch at most ten laps around the selected stop. Three laps on either side means seven rows including the pit lap.
Start with the pit lap, lane_duration in seconds and stop_duration in seconds. Join each lap to its inclusive stint interval. For a lap window, show a compact Markdown table with Lap, Time (s), Tyre and Note. Use three decimal places for lap times. Note the recorded pit lap and the is_pit_out_lap flag; leave the other notes blank. Cite the exact OpenF1 pit, stint and bounded lap queries as short Markdown links.
Use only returned fields. Distinguish time in the pit lane from stationary time. A missing duration is unavailable. If a request fails, say which data you could not retrieve. Timing alone cannot establish team intent. For an aggregate, give the source rows and tell the reader to use the worksheet. Only answer historical questions on demand.
Copier les réglages des actions pour la session et le pilote
identify_session
GET https://api.openf1.org/v1/sessions?session_key=9839
Identify the configured session. Check that session_name is Race, then report its date, circuit and session key.
identify_driver
GET https://api.openf1.org/v1/drivers?session_key=9839&driver_number={{driver_number}}
Resolve the driver by number within this race. Use full_name and driver_number from the response. If no record is found, ask for a valid number.
driver_number (Number, required): Confirmed driver number in this session, such as 44 for Lewis Hamilton.
Ouvrez AI Preview et posez la question Which session is this, and is driver 44 in it? Vérifiez la date de la course et le nom de Hamilton avant de poursuivre. Si c’est votre première action, le guide de création d’un agent qui appelle une API vous accompagne dans l’éditeur.
3. Comment trouver les sept tours à examiner ?
Partez du relevé des arrêts pour délimiter l’intervalle. Hamilton s’est arrêté deux fois pendant cette course, aux 8e et 31e tours. Prenez le premier arrêt, puis demandez les trois tours précédents et les trois suivants. Vous obtenez ainsi les tours 5 à 11 inclus. En demandant d’abord les chronos, vous laisseriez l’agent deviner où chercher.
Le récapitulatif des arrêts aux stands de la Formule 1 affiche 21,601 secondes. OpenF1 consigne à la fois cette durée totale dans la voie des stands et les 2,4 secondes d’immobilisation qu’elle comprend.
- Dans Custom Actions, ajoutez
get_driver_pitsetget_driver_stints. Les deux actions utilisent le même paramètre obligatoiredriver_numberque la recherche du pilote. Utilisez le point de terminaison au singulier pit pour les arrêts et stints pour les relais de pneus. La documentation des champs OpenF1 définit les champs de chronométrage, dont l’ancien aliaspit_durationpour le temps passé dans la voie des stands. - Ajoutez
get_driver_lapsavec trois paramètres obligatoires de type Number. Utilisez Add AI Data pour insérerdriver_number,first_lapetlast_lapdans l’URL. Conservez les signes encodés dans la configuration. Les filtres obtenus correspondent à numéro de tour ≥ premier tour et numéro de tour ≤ dernier tour. - Dans Test Response, saisissez 44, 5 et 11. Vérifiez la première et la dernière ligne du tableau renvoyé, puis enregistrez et activez les trois actions. Avec cette action, limitez chaque question à dix tours au maximum. Cette limite est demandée dans le prompt. L’URL de l’API accepte des intervalles plus larges.
Placez les deux bornes dans la même requête GET. S’il en manque une, la requête peut renvoyer le reste de la course.
Copier les réglages des actions pour les arrêts, les relais et les tours
get_driver_pits
GET https://api.openf1.org/v1/pit?session_key=9839&driver_number={{driver_number}}
Retrieve recorded pit events for the confirmed driver. Identify the requested pit lap. lane_duration is total time in the pit lane, stop_duration is stationary time; both are seconds. Preserve missing values.
driver_number (Number, required): Confirmed driver number in this session, such as 44 for Lewis Hamilton.
get_driver_stints
GET https://api.openf1.org/v1/stints?session_key=9839&driver_number={{driver_number}}
Retrieve tyre compounds and inclusive lap_start and lap_end boundaries for this driver. Use these intervals to label the pit and surrounding laps.
driver_number (Number, required): Confirmed driver number in this session, such as 44 for Lewis Hamilton.
get_driver_laps
GET https://api.openf1.org/v1/laps?session_key=9839&driver_number={{driver_number}}&lap_number%3E={{first_lap}}&lap_number%3C={{last_lap}}
Retrieve an inclusive interval of at most ten laps after selecting the pit event. Use lap_number, lap_duration in seconds and is_pit_out_lap. Preserve null durations. If OpenF1 returns HTTP 429, stop and ask the reader to try later. Do not repeat the lap request in the same turn.
driver_number (Number, required): Confirmed driver number in this session, such as 44 for Lewis Hamilton.
first_lap (Number, required): First lap number of the inclusive interval around the selected pit event.
last_lap (Number, required): Last lap number of the inclusive interval, at most nine above first_lap.
4. Que s’est-il passé aux 8e et 9e tours ?
Dans AI Preview, envoyez Show Hamilton's three laps before and after his first pit stop in the 2025 Abu Dhabi race. Lisez la réponse en partant de l’arrêt. Le 8e tour est le dernier qu’OpenF1 attribue au relais en pneus tendres. Le 9e est le premier en pneus durs et la seule ligne de l’intervalle où is_pit_out_lap vaut true.
Pour connaître la gomme utilisée, repérez le relais dont les bornes englobent le tour. Le 8e tour fait encore partie du premier relais.
| Numéro du tour | Temps au tour (s) | Type de gomme | Passage aux stands |
|---|---|---|---|
| 5 | 90,229 | Tendres | |
| 6 | 90,254 | Tendres | |
| 7 | 90,539 | Tendres | |
| 8 | 92,249 | Tendres | Entrée aux stands |
| 9 | 108,500 | Durs | Sortie des stands |
| 10 | 88,517 | Durs | |
| 11 | 89,022 | Durs |
Le tour le plus long de l’intervalle, en 108,500 secondes, comprend la sortie des stands et le retour en piste. Le premier tour complet qui suit a pris 88,517 secondes. Comparer ces deux lignes comme s’il s’agissait de deux tours ordinaires avec la même gomme masquerait l’effet de la sortie des stands. Vous pouvez examiner chaque valeur dans les relevés des sept tours et vérifier les intervalles des relais de pneus.
L’arrêt et le chrono le plus élevé figurent sur deux lignes consécutives. L’indicateur de sortie des stands vous dit quel tour écarter pour comparer les rythmes.
Faites un premier calcul. Décompressez le kit et exécutez python3 worksheet.py dans le dossier obtenu. Le script indique tous les tours retenus et écartés. En retirant le tour de l’arrêt, le tour de sortie des stands et les tours sans chrono, il reste cinq tours, avec une médiane de 90,229 secondes. Ce chiffre décrit les tours retenus sur deux types de gomme. Pour étudier le rythme d’un relais, choisissez un intervalle entièrement compris dans ce relais et précisez quels tours vous écartez.
5. Comment vérifier l’explication de la course donnée par l’IA ?
- Ouvrez la conversation dans Inbox, développez la liste des actions appelées, puis ouvrez View logs pour l’action de récupération des chronos. Lors de notre essai, les cinq requêtes ont renvoyé le statut HTTP 200. Pour l’appel qui récupère les tours, vérifiez que la session 9839, le pilote 44 et les bornes 5 et 11 correspondent bien aux sept lignes renvoyées.
- Posez la question
Did Hamilton pit because Ferrari wanted an undercut?Stint Notebook a retrouvé les deux arrêts et expliqué que les relevés ne permettent pas de déterminer les raisons de Ferrari. Pour vérifier la durée d’immobilisation, consultezstop_durationdans le relevé d’origine de l’arrêt. - Ouvrez Testing → Simulation, sélectionnez Create Dataset, puis Paste messages, et collez les questions de test du kit. Une ligne contenant uniquement
---sépare les questions. Enregistrez le jeu de données, puis sélectionnez Run. Incluez un pilote inconnu et une demande de données en direct. Pour le pilote 999, la requête au fournisseur a renvoyé 404 lors de notre essai. Si une recherche ne trouve aucune fiche, demandez un numéro de pilote valide. Si OpenF1 renvoie une durée manquante ou une erreur temporaire, laissez la valeur indisponible.
Le journal des appels permet de comparer la requête réellement envoyée avec l’arrêt décrit dans la réponse.
Reprenez les mêmes questions après avoir modifié la description d’une action. Vérifiez à la fois la réponse et les données récupérées par l’action.
Les relevés d’arrêts établissent quand Ferrari a rappelé Hamilton aux stands. Le flux de chronométrage ne comporte aucun champ sur l’intention de l’équipe.
Un réglage à tester. Nous avons simulé une réponse HTTP 429 sur la requête des chronos, alors que les quatre autres requêtes ont abouti. L’agent a tenté deux fois de récupérer les chronos. Nous avons ajouté à la description de l’action une consigne lui demandant de s’arrêter si la limite de requêtes était atteinte, puis nous avons relancé la même question. Cette fois, l’agent a fait une seule tentative, a indiqué l’arrêt au stand vérifié et a laissé les chronos indisponibles. Vous pouvez compter les tentatives dans View logs lorsque vous testez votre propre formulation.
Si vous gérez déjà Quickchat AI depuis ChatGPT ou Claude, vous pouvez transmettre à cet assistant actions.json et main-prompt.txt du kit et lui demander de préparer les cinq actions GET pour la session 9839. Vérifiez leurs URL avant d’activer les actions. L’exécution d’un test utilise vos crédits Quickchat AI.
Poursuivez avec le deuxième arrêt. Demandez quand Hamilton a changé de pneus la fois suivante. Le relevé des arrêts devrait cette fois vous renvoyer au 31e tour, et le relais en pneus médiums devrait commencer au 32e tour. Vous avez ainsi deux points à vérifier avant même de lire l’explication.
Questions fréquentes
Qu’est-ce qu’un relais de pneus en Formule 1 ?
Un relais est la série de tours qu’un pilote effectue avec le même train de pneus. OpenF1 indique pour chaque relais son numéro, la gomme utilisée, le premier tour et le dernier tour. Lors de la course d’Abou Dhabi 2025, Hamilton a effectué son premier relais en pneus tendres, du 1er au 8e tour.
Faut-il une clé API pour consulter les données historiques d’OpenF1 ?
Non. OpenF1 donne accès sans clé, pour un usage personnel, aux données historiques des sessions depuis 2023. Quickchat AI utilise des crédits pour les conversations et les tests. L’accès aux données en direct est soumis à des conditions distinctes.
Combien de temps a duré le premier arrêt de Hamilton à Abou Dhabi en 2025 ?
Au 8e tour, OpenF1 relève 21,601 secondes dans la voie des stands, dont 2,4 secondes d’immobilisation. Dans le point de terminaison pit, ces durées figurent respectivement dans les champs lane_duration et stop_duration. La durée d’immobilisation est déjà comprise dans le temps total passé dans la voie des stands.
Comment récupérer les temps au tour et les types de gomme en F1 avec l’API OpenF1 ?
Récupérez les données de laps et de stints avec les mêmes valeurs de session_key et de driver_number. Pour chaque lap_number, prenez la gomme du relais qui couvre ce tour, bornes lap_start et lap_end comprises. Le point de terminaison laps fournit lap_duration en secondes.
Ces tours permettent-ils de savoir pourquoi Ferrari a rappelé Hamilton aux stands ?
Les données indiquent quand Hamilton s’est arrêté, combien de temps sa voiture est restée immobile et quels pneus ont été montés ensuite. La décision de l’équipe n’y figure pas. Pour établir qu’il s’agissait d’un undercut, par exemple, il faut des éléments sur un rival et sur l’intention de l’équipe.
Puis-je utiliser ces sept tours pour estimer le rythme d’un relais ?
Vous pouvez décrire le rythme sur cet intervalle en précisant quels tours vous retenez. Le script Python écarte le tour de l’arrêt, les tours de sortie des stands et les tours sans chrono, puis indique le nombre de tours retenus et la médiane. Un intervalle à cheval sur deux types de gomme ne permet pas d’établir un rythme représentatif de l’un ou l’autre relais.