Lewis Hamilton ha trascorso 21,601 secondi in corsia box al giro 8 del Gran Premio di Abu Dhabi 2025. La sua Ferrari è rimasta ferma per 2,4 secondi. Entrambe le misure si riferiscono allo stesso pit stop. Sul foglio dei tempi, il giro più lungo in quella fase della sua gara è il 9.
Puoi ricostruire la sequenza in prima persona. Creerai Stint Notebook, un agente di Quickchat AI che legge i dati dell’API OpenF1. Chiedi i tre giri prima e i tre dopo il primo pit stop di Hamilton. Otterrai sette giri cronometrati, il passaggio dalle gomme morbide alle dure e i link ai dati su cui si basa la risposta.
In questa prova locale, Quickchat AI ha restituito i dati di sette giri e i link ai registri pubblici dei pit stop, degli stint con ciascun treno di gomme e dei singoli giri.
Scarica il kit di Stint Notebook con le configurazioni delle cinque Action, il Main Prompt, le risposte salvate di OpenF1 e un piccolo script Python da eseguire. Puoi consultare i dati di OpenF1 senza un account OpenF1 né un token API. Al passaggio 2 accederai a Quickchat AI.
1. Quale sessione di Abu Dhabi stai consultando?
Parti dalla gara e dal pilota. Un fine settimana di Gran Premio comprende più sessioni e Hamilton corre con il numero 44 in ognuna. Il numero del giro acquista significato solo quando hai identificato sia la sessione sia il pilota.
- Apri il record della sessione su OpenF1. Cerca
Race,Yas Marina Circuite la data 7 dicembre 2025. Mantienisession_key=9839in ogni richiesta. - Apri il record del pilota numero 44. Il record riporta Lewis Hamilton e Ferrari. Tieni aperta la scheda mentre aggiungi le Action.
Usa sempre la stessa gara. Basta cambiare il numero del pilota per fare la stessa domanda su un’altra vettura in quella gara.
Prova l’esempio nella pagina iniziale di OpenF1. Seleziona Shell e fai clic su Run. L’esempio restituisce i primi tre giri di Hamilton. Cerca driver_number e lap_number nella risposta JSON.
L’esempio restituisce i giri da 1 a 3. Più avanti, la domanda sul pit stop riguarda i giri da 5 a 11.
OpenF1 offre dati storici dal 2023 per uso personale. La guida all’autenticazione spiega come accedere ai dati in diretta.
2. Come configuri le prime due Action dell’agente?
- Crea un account Quickchat AI o accedi. Seleziona Add new AI Agent → Set up manually e chiamalo Stint Notebook. Ti serviranno crediti per le risposte dell’IA e per i test.
- Apri Identity → Main Prompt, incolla le istruzioni qui sotto e salva. Indicano all’agente quali dati raccogliere prima di spiegare un giro.
- Vai in Actions & MCPs → Custom Actions → Add Action → API Action → Create manually. In API Action Name, inserisci
identify_session. Lascia vuoto What to ask the user first. In API Endpoint, seleziona GET e inserisci l’URL qui sotto. Lascia vuoti Headers e Body. - In API Action Description, inserisci la descrizione qui sotto. Salva l’Action e attivala. Ripeti con
identify_driver. Per questa Action, aggiungidriver_numberin What to ask the user first, seleziona Number, rendi il parametro obbligatorio e inseriscilo nell’URL tramite Add AI Data → Parameters.
La gara è già specificata nell’URL salvato. La ricerca del pilota è la prima Action che usa un valore ricavato dalla conversazione.
Copia il Main Prompt di 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.
Copia le impostazioni delle Action per la sessione e il pilota
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.
Apri AI Preview e chiedi Which session is this, and is driver 44 in it? Prima di proseguire, verifica che compaiano la data della gara e il nome di Hamilton. Se è la tua prima Action, la guida per creare un agente che interroga un’API ti accompagna nell’uso dell’editor.
3. Come individui i sette giri giusti?
Usa il record del pit stop per definire l’intervallo. Hamilton si è fermato due volte in questa gara, ai giri 8 e 31. Prendi il primo pit stop e richiedi i tre giri precedenti e i tre successivi. Ottieni così i giri dal 5 all’11, estremi inclusi. Chiedendo prima i giri, lasceresti all’agente il compito di indovinare dove cercare.
Il riepilogo dei pit stop della Formula 1 riporta 21,601 secondi. OpenF1 registra sia questo totale in corsia box sia i 2,4 secondi a vettura ferma compresi nel totale.
- In Custom Actions, aggiungi
get_driver_pitseget_driver_stints. Entrambe usano lo stesso parametro obbligatoriodriver_numberdella ricerca del pilota. Usa l’endpoint al singolare pit per i pit stop e stints per gli intervalli di utilizzo delle gomme. La documentazione dei campi OpenF1 definisce i campi di cronometraggio, incluso il vecchio aliaspit_durationper il tempo in corsia box. - Aggiungi
get_driver_lapscon tre parametri obbligatori di tipo Number. Usa Add AI Data per inseriredriver_number,first_lapelast_lapnell’URL. Mantieni i segni codificati come nella configurazione fornita. I filtri risultanti indicano numero del giro ≥ primo giro e numero del giro ≤ ultimo giro. - In Test Response, inserisci 44, 5 e 11. Controlla la prima e l’ultima riga dell’array restituito, salva le Action e attivale tutte e tre. Usa questa Action per un massimo di dieci giri per domanda. Il prompt impone questo limite, mentre l’URL dell’API accetta intervalli più ampi.
Inserisci entrambi gli estremi nella stessa richiesta GET. Se ne manca uno, la richiesta può includere tutti i giri rimanenti della gara.
Copia le impostazioni delle Action per i pit stop, gli stint e i giri
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. Che cosa è cambiato tra il giro 8 e il giro 9?
In AI Preview, invia Show Hamilton's three laps before and after his first pit stop in the 2025 Abu Dhabi race. Leggi la risposta partendo dal pit stop e passando ai giri circostanti. Il giro 8 è l’ultimo che OpenF1 assegna allo stint sulle morbide. Il giro 9 è il primo sulle dure e l’unica riga di questo intervallo in cui is_pit_out_lap vale true.
Per trovare la mescola, verifica in quale intervallo tra il primo e l’ultimo giro di uno stint ricade il giro che stai cercando. Il giro 8 appartiene ancora al primo stint.
| Numero del giro | Tempo sul giro (s) | Mescola | Evento ai box |
|---|---|---|---|
| 5 | 90,229 | Morbide | |
| 6 | 90,254 | Morbide | |
| 7 | 90,539 | Morbide | |
| 8 | 92,249 | Morbide | Ingresso ai box |
| 9 | 108,500 | Dure | Uscita dai box |
| 10 | 88,517 | Dure | |
| 11 | 89,022 | Dure |
Il giro più lungo dell’intervallo, 108,500 secondi, comprende il ritorno in pista. Il primo giro completo successivo è durato 88,517 secondi. Confrontare le due righe come se fossero due giri normali sulla stessa mescola nasconderebbe proprio ciò che le distingue. Puoi controllare ogni tempo nei record dei sette giri e verificare gli intervalli di utilizzo delle mescole.
Il pit stop e il tempo sul giro più alto compaiono su due righe consecutive. Il flag del giro di uscita ti indica quale giro escludere dal confronto del passo.
Prova a fare un calcolo. Estrai il kit ed esegui python3 worksheet.py nella cartella del kit. Lo script elenca tutti i giri inclusi ed esclusi. Togliendo il giro di rientro ai box, quello di uscita e gli eventuali giri senza un tempo registrato, restano cinque giri con una mediana di 90,229 secondi. Il valore descrive i giri selezionati, percorsi su due mescole. Per studiare il passo di uno stint, scegli un intervallo interamente compreso in quello stint e indica quali giri hai escluso.
5. Come verifichi una spiegazione della gara data dall’IA?
- Apri la conversazione in Inbox, espandi le Action eseguite e seleziona View logs per l’Action dei giri. Nella nostra prova tutte e cinque le richieste di lettura hanno restituito HTTP 200. Nella chiamata per i giri, verifica che le sette righe restituite corrispondano alla sessione 9839, al pilota 44 e agli estremi 5 e 11.
- Chiedi
Did Hamilton pit because Ferrari wanted an undercut?Stint Notebook ha recuperato entrambi i pit stop e ha spiegato che i dati non chiariscono le ragioni della scelta di Ferrari. Per il tempo a vettura ferma, controllastop_durationnel record originale del pit stop. - Apri Testing → Simulation, seleziona Create Dataset, poi Paste messages e incolla le domande di prova del kit. Una riga contenente solo
---separa ciascuna domanda dalla successiva. Salva il dataset e seleziona Run. Includi un pilota sconosciuto e una richiesta di aggiornamenti in diretta. Per il pilota 999, la nostra interrogazione al fornitore dei dati ha restituito 404. Se la ricerca non trova alcun record, chiedi un numero di pilota valido. Se manca un tempo nella risposta di OpenF1 o il servizio restituisce un errore temporaneo, lascia il valore come non disponibile.
Nel registro delle chiamate puoi confrontare la richiesta effettiva con il pit stop descritto nella risposta.
Usa le stesse domande dopo aver modificato la descrizione di un’Action. Controlla sia la risposta sia i dati recuperati dall’Action.
I pit stop indicano quando Ferrari ha richiamato Hamilton ai box. Il flusso dei dati di cronometraggio non ha un campo per le intenzioni del team.
Una modifica da provare. Abbiamo simulato un HTTP 429 nella richiesta dei giri, mentre le altre quattro richieste di lettura sono andate a buon fine. L’agente ha tentato due volte la richiesta dei giri. Abbiamo aggiunto alla descrizione dell’Action dei giri l’istruzione di fermarsi quando si raggiunge il limite di richieste, poi abbiamo ripetuto la stessa domanda. Questa volta l’agente ha fatto un solo tentativo, ha riportato il pit stop verificato e ha indicato i tempi sul giro come non disponibili. Quando provi la tua formulazione, puoi contare i tentativi in View logs.
Se gestisci già Quickchat AI da ChatGPT o Claude, puoi fornire all’assistente actions.json e main-prompt.txt del kit e chiedergli di configurare le cinque Action GET per la sessione 9839. Controlla gli URL prima di attivarle. L’esecuzione di un test usa i tuoi crediti Quickchat AI.
Usa Stint Notebook per il secondo pit stop. Chiedi quando Hamilton ha cambiato di nuovo le gomme. Stavolta il record del pit stop dovrebbe rimandarti al giro 31 e il primo giro dello stint sulle medie dovrebbe essere il 32. Ora hai due punti di riscontro per verificare la risposta prima ancora di leggere la spiegazione.
Domande frequenti
Che cos’è uno stint di gomme in Formula 1?
Uno stint è la sequenza di giri che un pilota percorre con lo stesso treno di gomme. OpenF1 indica per ogni stint il numero, la mescola, il primo e l’ultimo giro. Nella gara di Abu Dhabi del 2025, Hamilton ha percorso il primo stint, dal giro 1 al giro 8, con le gomme morbide.
Serve una chiave API per accedere ai dati storici di OpenF1?
No. OpenF1 offre accesso senza chiave ai dati storici delle sessioni dal 2023 in poi, per uso personale. Quickchat AI usa crediti per le conversazioni e i test. L’accesso ai dati in diretta ha requisiti propri.
Quanto è durato il primo pit stop di Hamilton ad Abu Dhabi nel 2025?
Al giro 8 OpenF1 registra 21,601 secondi in corsia box e 2,4 secondi a vettura ferma. Nell’endpoint pit questi campi si chiamano lane_duration e stop_duration. Il tempo a vettura ferma è già compreso nel totale in corsia box.
Come si ottengono i tempi sul giro e le mescole della F1 dall’API OpenF1?
Recupera laps e stints usando gli stessi valori di session_key e driver_number. Per ogni lap_number, usa la mescola dello stint il cui intervallo da lap_start a lap_end comprende quel giro. L’endpoint laps restituisce lap_duration in secondi.
Da questi giri si può capire perché Ferrari ha richiamato Hamilton ai box?
I dati mostrano quando Hamilton si è fermato, per quanto tempo la vettura è rimasta ferma e con quali gomme è ripartito. La decisione del team non è registrata. Per stabilire se ci sia stata una mossa strategica come un undercut servono elementi su un avversario e sulle intenzioni del team.
Posso usare i sette giri per stimare il passo dello stint?
Puoi descrivere questo intervallo indicando quali giri hai incluso. Il piccolo script Python esclude il giro di rientro ai box, i giri di uscita e quelli senza un tempo registrato, poi restituisce il numero di giri inclusi e la mediana. Un intervallo che comprende due mescole non permette di stabilire un passo rappresentativo per nessuno dei due stint.