Lewis Hamilton a petrecut 21,601 secunde pe linia boxelor în turul 8 al Marelui Premiu de la Abu Dhabi din 2025. Monopostul său Ferrari a staționat 2,4 secunde. Ambele valori provin de la aceeași oprire. În foaia de cronometraj, cel mai lung tur din acea parte a cursei sale este însă turul 9.
Poți reconstitui singur secvența. Vei construi Stint Notebook, un agent Quickchat AI care citește date din API-ul OpenF1. Cere câte trei tururi înainte și după prima oprire a lui Hamilton și vei primi timpii celor șapte tururi, detalii despre trecerea de la pneurile moi la cele dure și linkuri către înregistrările pe care se bazează răspunsul.
În acest test local, Quickchat AI a returnat datele pentru șapte tururi și linkuri către înregistrările publice ale opririlor la boxe, ale stinturilor pe același set de pneuri și ale tururilor individuale.
Descarcă kitul Stint Notebook pentru a avea la îndemână configurațiile celor cinci acțiuni, textul pentru Main Prompt, răspunsurile salvate din OpenF1 și un mic script Python pe care îl poți rula. Poți consulta datele OpenF1 fără cont OpenF1 și fără token de acces la API. La pasul 2 te vei conecta la Quickchat AI.
1. La ce sesiune de la Abu Dhabi te uiți?
Începe cu sesiunea de cursă și cu pilotul. Un weekend de Grand Prix cuprinde mai multe sesiuni, iar Hamilton poartă numărul 44 în fiecare dintre ele. Numărul unui tur capătă sens abia după ce ai stabilit atât sesiunea, cât și pilotul.
- Deschide înregistrarea sesiunii în OpenF1. Caută
Race,Yas Marina Circuitși data de 7 decembrie 2025. Păstreazăsession_key=9839în fiecare cerere. - Deschide înregistrarea pilotului cu numărul 44. Vei găsi acolo numele Lewis Hamilton și echipa Ferrari. Lasă fila deschisă cât timp adaugi acțiunile.
Păstrează aceeași sesiune de cursă. Schimbă doar numărul pilotului ca să pui aceeași întrebare despre un alt monopost din cursă.
Încearcă exemplul de pe pagina principală OpenF1. Selectează Shell și apasă pe Run. Exemplul returnează datele din primele trei tururi ale lui Hamilton. Caută driver_number și lap_number în răspunsul JSON.
Exemplul returnează tururile de la 1 la 3. Mai târziu, întrebarea despre oprirea la boxe vizează tururile de la 5 la 11.
OpenF1 oferă date istorice începând din 2023 pentru uz personal. Ghidul de autentificare explică modul de acces la datele în timp real.
2. Cum configurezi primele două acțiuni ale agentului?
- Creează un cont Quickchat AI sau autentifică-te. Alege Add new AI Agent → Set up manually și numește agentul Stint Notebook. Ai nevoie de credite pentru răspunsurile AI și pentru teste.
- Deschide Identity → Main Prompt, lipește instrucțiunile de mai jos și salvează. Ele îi spun agentului ce date să adune înainte de a explica un tur.
- Accesează Actions & MCPs → Custom Actions → Add Action → API Action → Create manually. În API Action Name, introdu
identify_session. Lasă necompletat câmpul What to ask the user first. În API Endpoint, alege GET și introdu adresa URL de mai jos. Lasă câmpurile Headers și Body necompletate. - În API Action Description, introdu descrierea de mai jos. Salvează și activează acțiunea. Repetă pașii pentru
identify_driver. Pentru această acțiune, adaugădriver_numberîn What to ask the user first, alege Number, marchează parametrul ca obligatoriu și inserează-l în adresa URL cu Add AI Data → Parameters.
Sesiunea de cursă este deja inclusă în adresa URL salvată. Căutarea pilotului este prima acțiune care are nevoie de o valoare din conversație.
Copiază textul pentru Main Prompt din 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.
Copiază setările acțiunilor pentru sesiune și pilot
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.
Deschide AI Preview și pune întrebarea Which session is this, and is driver 44 in it? Verifică data cursei și numele lui Hamilton înainte să continui. Dacă aceasta este prima ta acțiune, ghidul pentru construirea unui agent care apelează un API te conduce prin editor.
3. Cum găsești cele șapte tururi relevante?
Stabilește intervalul pornind de la înregistrarea opririi. Hamilton a oprit de două ori în această cursă, în tururile 8 și 31. Alege prima oprire, apoi cere trei tururi înainte și trei după ea. Astfel obții tururile de la 5 la 11, inclusiv. Dacă ai cere mai întâi tururile, agentul ar trebui să ghicească în ce interval să caute.
Rezumatul opririlor la boxe publicat de Formula 1 indică 21,601 secunde. OpenF1 înregistrează atât acest total pentru linia boxelor, cât și cele 2,4 secunde de staționare incluse în el.
- În Custom Actions, adaugă
get_driver_pitsșiget_driver_stints. Ambele folosesc același parametru obligatoriudriver_numberca acțiunea de căutare a pilotului. Folosește endpointul la singular pit pentru opriri și stints pentru intervalele de utilizare a pneurilor. Documentația câmpurilor OpenF1 definește câmpurile de cronometraj, inclusiv denumirea mai vechepit_durationpentru timpul petrecut pe linia boxelor. - Adaugă
get_driver_lapscu trei parametri obligatorii de tip Number. Folosește Add AI Data pentru a inseradriver_number,first_lapșilast_lapîn adresa URL. Păstrează semnele codificate din configurație. Filtrele rezultate înseamnă numărul turului ≥ primul tur și numărul turului ≤ ultimul tur. - În Test Response, introdu 44, 5 și 11. Verifică primul și ultimul element din lista returnată, apoi salvează și activează toate cele trei acțiuni. Limitează această acțiune la cel mult zece tururi per întrebare. Promptul cere respectarea acestei limite, iar adresa URL a API-ului acceptă și intervale mai largi.
Ambele limite trebuie să fie în aceeași cerere GET. Dacă lipsește una, cererea poate returna și restul cursei.
Copiază setările acțiunilor pentru opriri, stinturi și tururi
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. Ce s-a schimbat în tururile 8 și 9?
În AI Preview, trimite Show Hamilton's three laps before and after his first pit stop in the 2025 Abu Dhabi race. Citește răspunsul pornind de la oprire și urmărește ce se întâmplă în tururile din jur. Turul 8 este ultimul pe care OpenF1 îl atribuie stintului pe pneuri moi. Turul 9 este primul pe pneuri dure și singurul rând din acest interval în care is_pit_out_lap are valoarea true.
Află compoziția pneurilor verificând între ce tururi începe și se încheie stintul care include turul căutat. Turul 8 face încă parte din primul stint.
| Numărul turului | Timp pe tur (s) | Compoziția pneurilor | Înregistrare la boxe |
|---|---|---|---|
| 5 | 90,229 | Moi | |
| 6 | 90,254 | Moi | |
| 7 | 90,539 | Moi | |
| 8 | 92,249 | Moi | Intrare la boxe |
| 9 | 108,500 | Dure | Ieșire de la boxe |
| 10 | 88,517 | Dure | |
| 11 | 89,022 | Dure |
Cel mai lung tur din interval, de 108,500 secunde, include revenirea pe circuit. Primul tur complet după acesta a durat 88,517 secunde. Dacă ai compara cele două rânduri ca pe două tururi obișnuite pe aceeași compoziție, ai pierde din vedere faptul că primul include ieșirea de la boxe. Poți verifica fiecare valoare în cele șapte înregistrări ale tururilor și poți consulta intervalele de utilizare a pneurilor.
Oprirea și cel mai mare timp pe tur apar pe rânduri consecutive. Indicatorul de ieșire de la boxe îți arată ce tur să excluzi când compari ritmul.
Încearcă un calcul. Dezarhivează kitul și rulează python3 worksheet.py din directorul lui. Scriptul listează toate tururile incluse și excluse. Dacă excluzi turul intrării la boxe, turul de ieșire și eventualele tururi fără timp înregistrat, rămân cinci tururi cu o mediană de 90,229 secunde. Rezultatul descrie tururile selectate, parcurse pe două compoziții de pneuri. Ca să studiezi ritmul unui singur stint, alege un interval cuprins în acel stint și precizează ce tururi ai exclus.
5. Cum verifici explicația AI despre cursă?
- Deschide conversația în Inbox, extinde lista acțiunilor apelate, apoi deschide View logs pentru acțiunea care preia tururile. În testul nostru, toate cele cinci cereri de citire au returnat HTTP 200. În apelul pentru tururi, verifică dacă sesiunea 9839, pilotul 44 și limitele 5 și 11 corespund celor șapte rânduri returnate.
- Pune întrebarea
Did Hamilton pit because Ferrari wanted an undercut?Stint Notebook a preluat ambele opriri și a explicat că din înregistrări nu reiese de ce a luat Ferrari acea decizie. Pentru timpul de staționare, verificăstop_durationîn înregistrarea originală a opririi. - Deschide Testing → Simulation, alege Create Dataset, apoi Paste messages și lipește întrebările de test din kit. Un rând care conține doar
---separă fiecare întrebare de următoarea. Salvează setul de date și selectează Run. Include un pilot necunoscut și o cerere de actualizări în timp real. În testul nostru, căutarea pilotului cu numărul 999 a primit răspunsul 404 de la furnizor. Cere un număr valid de pilot dacă o căutare nu găsește nicio înregistrare. Dacă lipsește durata din răspunsul OpenF1 sau apare o eroare temporară, lasă valoarea ca indisponibilă.
În jurnalul apelului poți compara cererea efectivă cu oprirea descrisă în răspuns.
Folosește aceleași întrebări după ce modifici descrierea unei acțiuni. Verifică atât răspunsul, cât și datele pe care le-a preluat acțiunea.
Opririle arată când l-a chemat Ferrari pe Hamilton la boxe. Fluxul de cronometraj nu are niciun câmp pentru intenția echipei.
O modificare pe care merită s-o testezi. Am simulat un răspuns HTTP 429 la cererea pentru tururi, în timp ce celelalte patru cereri de citire au reușit. Agentul a încercat de două ori să preia tururile. Am adăugat în descrierea acțiunii pentru tururi instrucțiunea de a se opri dacă este atinsă limita de cereri și am rulat din nou aceeași întrebare. De data aceasta, agentul a făcut o singură încercare, a raportat oprirea verificată și a lăsat timpii pe tur ca indisponibili. Când îți testezi propria formulare, poți număra încercările în View logs.
Dacă gestionezi deja Quickchat AI din ChatGPT sau Claude, îi poți da asistentului actions.json și main-prompt.txt din kit și îi poți cere să pregătească cele cinci acțiuni GET pentru sesiunea 9839. Verifică adresele URL înainte de a activa acțiunile. Rularea unui test consumă credite Quickchat AI.
Folosește Stint Notebook și pentru a doua oprire. Întreabă când a schimbat din nou Hamilton pneurile. De data aceasta, înregistrarea opririi ar trebui să te ducă la turul 31, iar primul tur al stintului pe pneuri medii ar trebui să fie 32. Acum ai două repere cu care poți verifica răspunsul înainte să citești explicația.
Întrebări frecvente
Ce înseamnă un stint pe pneuri în Formula 1?
Un stint este seria de tururi pe care un pilot le parcurge pe același set de pneuri. OpenF1 indică pentru fiecare stint numărul său, compoziția pneurilor și tururile de început și de sfârșit. În cursa de la Abu Dhabi din 2025, primul stint al lui Hamilton cuprinde tururile 1–8, pe pneuri moi.
Am nevoie de o cheie API pentru datele istorice OpenF1?
Nu. OpenF1 oferă acces fără cheie, pentru uz personal, la datele istorice ale sesiunilor începând din 2023. Quickchat AI consumă credite pentru conversații și teste. Accesul la date în timp real are condiții separate.
Cât a durat prima oprire la boxe a lui Hamilton la Abu Dhabi în 2025?
În turul 8, OpenF1 înregistrează 21,601 secunde pe linia boxelor, dintre care 2,4 secunde de staționare. În endpointul pit, aceste câmpuri se numesc lane_duration și stop_duration. Timpul de staționare este deja inclus în totalul petrecut pe linia boxelor.
Cum obțin timpii pe tur și compozițiile pneurilor din Formula 1 prin API-ul OpenF1?
Preia datele din laps și stints pentru aceleași valori session_key și driver_number. Pentru fiecare lap_number, folosește compoziția pneurilor din stintul al cărui interval, de la lap_start la lap_end, include turul respectiv. Endpointul laps furnizează lap_duration în secunde.
Pot afla din aceste tururi de ce l-a chemat Ferrari pe Hamilton la boxe?
Înregistrările arată când a oprit Hamilton, cât a staționat și pe ce pneuri a continuat. Motivele deciziei echipei rămân necunoscute. Ca să stabilești dacă a fost vorba de o strategie precum un undercut, ai nevoie de dovezi privind un rival și intenția echipei.
Pot folosi cele șapte tururi ca să estimez ritmul unui stint?
Poți descrie ritmul din acest interval dacă precizezi ce tururi ai inclus. Scriptul Python exclude turul în care pilotul intră la boxe, tururile de ieșire de la boxe și tururile fără timp înregistrat, apoi afișează numărul de tururi rămase și mediana. Un interval care cuprinde două compoziții de pneuri nu poate stabili un ritm reprezentativ pentru niciunul dintre cele două stinturi.