Dùng API OpenF1 dựng lại lần dừng pit của Hamilton ở Abu Dhabi

Piotr Grudzień
Ngày đăng Thời gian đọc: 10 phút
Hình minh họa xe Công thức 1 màu đỏ bên cạnh số liệu về thời gian Hamilton ở trong đường pit và thời gian xe đứng yên ở vòng 8

Lewis Hamilton ở trong đường pit 21,601 giây ở vòng 8 của Grand Prix Abu Dhabi 2025. Chiếc Ferrari của anh đứng yên 2,4 giây. Cả hai số liệu đều thuộc cùng một lần dừng pit. Trên bảng thời gian, vòng lâu nhất trong đoạn này thực ra là vòng 9.

Bạn có thể tự dựng lại diễn biến đó. Bạn sẽ tạo Stint Notebook, một AI Agent trong Quickchat AI đọc dữ liệu từ API OpenF1. Hãy hỏi về ba vòng trước và ba vòng sau lần dừng pit đầu tiên của Hamilton. Bạn sẽ nhận được thời gian của bảy vòng, thông tin về lần chuyển từ lốp mềm sang lốp cứng và các liên kết đến bản ghi làm căn cứ cho câu trả lời.

Câu trả lời của Quickchat AI về bảy vòng chạy của Hamilton nằm dưới hai số liệu thời gian OpenF1 ghi nhận cho lần dừng pit ở vòng 8 Trong lần chạy trên máy cục bộ này, Quickchat AI trả về dữ liệu của bảy vòng cùng liên kết đến hồ sơ công khai về các lần dừng pit, từng chặng chạy với cùng một bộ lốp và từng vòng chạy.

Tải bộ tài liệu Stint Notebook để lấy cấu hình cho năm Action, Main Prompt, các phản hồi OpenF1 đã lưu và một đoạn mã Python ngắn có thể chạy trực tiếp. Bạn có thể xem dữ liệu OpenF1 mà không cần tài khoản OpenF1 hay mã truy cập API. Ở bước 2, bạn sẽ đăng nhập vào Quickchat AI.

1. Bạn đang xem phiên nào tại Abu Dhabi?

Bắt đầu từ cuộc đua và tay đua. Một cuối tuần Grand Prix có nhiều phiên và Hamilton mang số 44 trong tất cả các phiên đó. Một số vòng chỉ có ý nghĩa khi bạn đã xác định cả phiên lẫn tay đua.

  1. Mở bản ghi phiên trên OpenF1. Tìm Race, Yas Marina Circuit và ngày 7 tháng 12 năm 2025. Giữ nguyên session_key=9839 trong mọi yêu cầu.
  2. Mở bản ghi tay đua mang số 44. Bản ghi trả về Lewis Hamilton và Ferrari. Giữ tab đó mở trong lúc thêm các Action.

Phiên đua 9839 trên OpenF1 và số xe 44 của Hamilton liên kết các bản ghi dừng pit, chặng lốp và vòng chạy Giữ nguyên cuộc đua. Chỉ cần đổi số xe là bạn có thể hỏi cùng một câu về một chiếc xe khác trong cuộc đua đó.

Hãy thử ví dụ trên trang chủ OpenF1. Chọn Shell rồi nhấn Run. Ví dụ trả về dữ liệu ba vòng đầu tiên của Hamilton. Tìm driver_number và lap_number trong phản hồi JSON.

Ví dụ Shell trên OpenF1, nút Run và dữ liệu vòng đua trả về cho tay đua mang số 44 Ví dụ này trả về dữ liệu từ vòng 1 đến vòng 3. Ở phần sau, câu hỏi về lần dừng pit sẽ yêu cầu dữ liệu từ vòng 5 đến vòng 11.

OpenF1 cung cấp dữ liệu lịch sử từ năm 2023 cho mục đích cá nhân. Hướng dẫn xác thực giải thích cách truy cập dữ liệu trực tiếp.

2. Làm sao để thêm hai Action đầu tiên cho Agent?

  1. Tạo tài khoản hoặc đăng nhập vào Quickchat AI. Chọn Add new AI Agent → Set up manually và đặt tên là Stint Notebook. Bạn cần tín dụng để nhận phản hồi AI và chạy kiểm thử.
  2. Mở Identity → Main Prompt, dán hướng dẫn bên dưới rồi lưu. Hướng dẫn này cho Agent biết cần thu thập dữ liệu nào trước khi giải thích một vòng chạy.
  3. Vào Actions & MCPs → Custom Actions → Add Action → API Action → Create manually. Trong API Action Name, nhập identify_session. Để trống What to ask the user first. Trong API Endpoint, chọn GET và nhập URL bên dưới. Để trống Headers và Body.
  4. Trong API Action Description, nhập phần mô tả bên dưới. Lưu và bật Action. Làm tương tự với identify_driver. Với Action này, thêm driver_number vào What to ask the user first, chọn Number, đặt tham số là bắt buộc và chèn vào URL bằng Add AI Data → Parameters.

Trình chỉnh sửa API Action trong Quickchat AI với phiên đua được cố định trong URL và endpoint dùng GET Phiên đua đã được ghi trong URL lưu sẵn. Tra cứu tay đua là Action đầu tiên cần một giá trị lấy từ cuộc trò chuyện.

Sao chép Main Prompt của 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.
Sao chép cấu hình Action tra cứu phiên và tay đua
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.

Mở AI Preview và hỏi Which session is this, and is driver 44 in it? Kiểm tra ngày đua và tên Hamilton trước khi tiếp tục. Nếu đây là Action đầu tiên của bạn, hướng dẫn tạo Agent gọi API sẽ chỉ bạn cách dùng trình chỉnh sửa.

3. Làm sao để xác định đúng bảy vòng cần xem?

Hãy dùng bản ghi dừng pit để xác định khoảng vòng. Hamilton dừng hai lần trong cuộc đua này, ở vòng 8 và vòng 31. Chọn lần đầu tiên, rồi yêu cầu ba vòng trước và ba vòng sau lần dừng đó. Bạn sẽ có các vòng từ 5 đến 11, tính cả hai đầu. Nếu hỏi về các vòng trước khi tra lần dừng pit, Agent sẽ phải đoán nên tìm ở đâu.

Bản tổng hợp lần dừng pit ở vòng 8 của Formula 1 bên cạnh các trường OpenF1 ghi 21,601 giây trong đường pit và 2,4 giây xe đứng yên Bản tổng hợp các lần dừng pit của Formula 1 ghi 21,601 giây. OpenF1 ghi cả tổng thời gian ở đường pit lẫn 2,4 giây xe đứng yên đã được tính trong tổng đó.

  1. Trong Custom Actions, thêm get_driver_pits và get_driver_stints. Cả hai đều dùng tham số bắt buộc driver_number giống Action tra cứu tay đua. Dùng endpoint số ít pit cho các lần dừng pit và stints cho các khoảng sử dụng từng bộ lốp. Tài liệu tham chiếu các trường của OpenF1 định nghĩa các trường thời gian, kể cả tên cũ pit_duration của trường ghi thời gian trong đường pit.
  2. Thêm get_driver_laps với ba tham số bắt buộc kiểu Number. Dùng Add AI Data để chèn driver_number, first_lap và last_lap vào URL. Giữ nguyên các dấu đã mã hóa trong cấu hình mẫu. Hai bộ lọc tương ứng là số vòng ≥ vòng đầu và số vòng ≤ vòng cuối.
  3. Trong Test Response, nhập 44, 5 và 11. Kiểm tra hai đầu của mảng trả về, rồi lưu và bật cả ba Action. Với Action tra cứu vòng, chỉ yêu cầu tối đa mười vòng mỗi câu hỏi. Giới hạn này nằm trong prompt, còn URL API chấp nhận khoảng rộng hơn.

Action tra cứu vòng trong Quickchat AI với các tham số số xe, vòng đầu và vòng cuối Hai mốc phải nằm trong cùng một yêu cầu GET. Thiếu một mốc có thể khiến yêu cầu trả về cả phần còn lại của cuộc đua.

Sao chép cấu hình Action tra cứu lần dừng pit, chặng lốp và vòng chạy
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. Điều gì thay đổi ở vòng 8 và vòng 9?

Trong AI Preview, gửi Show Hamilton's three laps before and after his first pit stop in the 2025 Abu Dhabi race. Khi đọc câu trả lời, hãy bắt đầu từ lần dừng pit rồi xem các vòng xung quanh. Vòng 8 là vòng cuối mà OpenF1 xếp vào chặng lốp mềm. Vòng 9 là vòng đầu trên lốp cứng và là dòng duy nhất trong khoảng này có is_pit_out_lap mang giá trị true.

58 vòng đua của Hamilton được chia thành ba chặng, dùng lốp mềm ở các vòng 1–8, lốp cứng ở các vòng 9–31 và lốp trung bình ở các vòng 32–58 Để xác định loại lốp, hãy tìm chặng có mốc bắt đầu và kết thúc bao gồm vòng đang xét. Vòng 8 vẫn thuộc chặng đầu tiên.

Số vòngThời gian vòng (giây)Loại lốpGhi nhận vào/ra pit
590,229Lốp mềm
690,254Lốp mềm
790,539Lốp mềm
892,249Lốp mềmVào đường pit
9108,500Lốp cứngRời đường pit
1088,517Lốp cứng
1189,022Lốp cứng

Vòng lâu nhất trong khoảng này, 108,500 giây, bao gồm đoạn xe từ đường pit trở lại đường đua. Vòng trọn vẹn đầu tiên sau đó mất 88,517 giây. Nếu so hai dòng như thể cả hai đều là vòng chạy bình thường trên cùng loại lốp, bạn sẽ bỏ qua đoạn rời pit tạo nên khác biệt. Bạn có thể đối chiếu từng con số trong bảy bản ghi vòng chạy và kiểm tra các khoảng sử dụng từng bộ lốp.

Thời gian từng vòng của Hamilton từ vòng 5 đến vòng 11, có đánh dấu vòng rời pit kéo dài 108,500 giây Lần dừng pit và vòng có thời gian cao nhất nằm ở hai dòng liền nhau. Cờ đánh dấu vòng rời pit cho biết cần loại vòng nào khi so sánh tốc độ.

Thử tính một lần. Giải nén bộ tài liệu và chạy python3 worksheet.py trong thư mục vừa giải nén. Đoạn mã liệt kê từng vòng được tính và từng vòng bị loại. Sau khi bỏ vòng vào pit, vòng rời pit và các vòng thiếu thời gian, còn năm vòng có trung vị 90,229 giây. Con số này mô tả các vòng đã chọn trên hai loại lốp. Để xem tốc độ của một chặng, hãy chọn khoảng nằm trọn trong chặng đó và nêu rõ những vòng bạn loại ra.

5. Làm sao để kiểm chứng lời giải thích của AI về cuộc đua?

  1. Mở cuộc trò chuyện trong Inbox, mở rộng danh sách Action đã gọi rồi chọn View logs ở Action tra cứu vòng. Trong lần chạy của chúng tôi, cả năm yêu cầu truy xuất đều trả về HTTP 200. Ở lượt gọi lấy dữ liệu vòng, hãy đối chiếu phiên 9839, tay đua 44 và hai mốc 5 và 11 với bảy dòng trả về.
  2. Hãy hỏi Did Hamilton pit because Ferrari wanted an undercut? Stint Notebook truy xuất cả hai lần dừng pit và giải thích rằng dữ liệu chưa đủ để kết luận vì sao Ferrari quyết định như vậy. Để xác minh thời gian xe đứng yên, hãy xem stop_duration trong bản ghi dừng pit gốc.
  3. Mở Testing → Simulation, chọn Create Dataset, rồi chọn Paste messages và dán các câu hỏi kiểm thử trong bộ tài liệu. Dùng một dòng chỉ chứa --- để ngăn cách các câu hỏi. Lưu bộ dữ liệu rồi chọn Run. Hãy đưa vào một số xe không xác định và một yêu cầu cập nhật trực tiếp. Khi tra số xe 999, dịch vụ cung cấp dữ liệu trả về 404. Nếu tra cứu không có bản ghi, hãy yêu cầu người dùng cung cấp số xe hợp lệ. Nếu OpenF1 trả về dữ liệu thiếu thời gian vòng hoặc gặp lỗi tạm thời, hãy để giá trị đó ở trạng thái không có dữ liệu.

Nhật ký gọi API lấy dữ liệu vòng trong Quickchat AI hiển thị số xe, hai mốc vòng và phản hồi trả về Nhật ký cho phép bạn đối chiếu yêu cầu thực tế với lần dừng pit được mô tả trong câu trả lời.

Màn hình Testing trong Quickchat AI với các câu hỏi của Stint Notebook về cuộc đua và giới hạn của dữ liệu tính giờ Dùng lại cùng bộ câu hỏi sau khi sửa phần mô tả Action. Kiểm tra cả câu trả lời lẫn dữ liệu mà Action truy xuất.

Quickchat AI dùng các lần dừng pit đã ghi nhận để trả lời câu hỏi về undercut và giải thích giới hạn của dữ liệu tính giờ Các bản ghi cho biết Ferrari gọi Hamilton vào pit ở những vòng nào. Nguồn dữ liệu tính giờ không có trường nào ghi ý đồ của đội.

Một thay đổi đáng thử. Chúng tôi mô phỏng lỗi HTTP 429 ở lượt tra cứu vòng trong khi bốn lượt truy xuất còn lại thành công. Agent gửi yêu cầu lấy dữ liệu vòng hai lần. Chúng tôi thêm hướng dẫn vào phần mô tả Action tra cứu vòng để Agent dừng khi gặp giới hạn tần suất yêu cầu, rồi chạy lại cùng câu hỏi. Lần này, Agent chỉ thử một lần, báo lần dừng pit đã xác minh và cho biết chưa có dữ liệu thời gian vòng. Khi thử cách diễn đạt của riêng bạn, hãy vào View logs để đếm số lần gửi yêu cầu.

Nếu bạn đã quản lý Quickchat AI từ ChatGPT hoặc Claude, bạn có thể cung cấp actions.json và main-prompt.txt trong bộ tài liệu cho trợ lý đó rồi yêu cầu chuẩn bị năm Action dùng GET cho phiên 9839. Kiểm tra URL của từng Action trước khi bật. Mỗi lượt kiểm thử sẽ dùng tín dụng Quickchat AI của bạn.

Dùng Stint Notebook để xem lần dừng pit thứ hai. Hãy hỏi Hamilton thay lốp lần tiếp theo ở vòng nào. Lần này, bản ghi dừng pit sẽ dẫn bạn tới vòng 31, còn vòng đầu của chặng lốp trung bình sẽ là vòng 32. Bạn đã có hai mốc để kiểm tra câu trả lời ngay cả trước khi đọc phần giải thích.

Câu hỏi thường gặp

Chặng chạy với cùng một bộ lốp trong Công thức 1 là gì?

Đó là chuỗi vòng chạy mà tay đua hoàn thành trên cùng một bộ lốp. OpenF1 ghi số thứ tự, loại lốp, vòng bắt đầu và vòng kết thúc của mỗi chặng. Tại Abu Dhabi năm 2025, Hamilton chạy chặng đầu tiên bằng lốp mềm từ vòng 1 đến vòng 8.

Tôi có cần khóa API để lấy dữ liệu lịch sử từ OpenF1 không?

Không. OpenF1 cho phép truy cập dữ liệu lịch sử của các phiên từ năm 2023 trở đi để sử dụng cá nhân mà không cần khóa API. Quickchat AI dùng tín dụng cho các cuộc trò chuyện và lượt kiểm thử. Quyền truy cập dữ liệu trực tiếp có yêu cầu riêng.

Lần dừng pit đầu tiên của Hamilton tại Abu Dhabi năm 2025 kéo dài bao lâu?

Ở vòng 8, OpenF1 ghi nhận Hamilton ở trong đường pit 21,601 giây, trong đó xe đứng yên 2,4 giây. Hai trường tương ứng trong endpoint pit là lane_duration và stop_duration. Thời gian xe đứng yên đã được tính trong tổng thời gian ở đường pit.

Làm sao để lấy thời gian từng vòng và loại lốp F1 từ API OpenF1?

Lấy dữ liệu từ laps và stints với cùng session_key và driver_number. Với mỗi lap_number, lấy loại lốp của chặng có khoảng từ lap_start đến lap_end bao gồm vòng đó. Endpoint laps trả về lap_duration tính bằng giây.

Các vòng này có cho biết vì sao Ferrari gọi Hamilton vào pit không?

Dữ liệu cho biết Hamilton dừng ở vòng nào, xe đứng yên bao lâu và sau đó dùng lốp gì. Lý do đội đưa ra quyết định không được ghi lại. Để xác định một chiến thuật như undercut, tức vào pit sớm để vượt đối thủ, cần bằng chứng về đối thủ và ý đồ của đội.

Tôi có thể dùng bảy vòng này để ước tính tốc độ của một chặng lốp không?

Bạn có thể mô tả khoảng vòng này nếu nêu rõ những vòng nào được tính. Đoạn mã Python loại vòng vào pit, các vòng rời pit và những vòng thiếu thời gian, rồi báo số vòng còn lại và trung vị. Một khoảng trải qua hai loại lốp không đủ để xác định tốc độ đại diện cho từng chặng.

Quickchat AI Quickchat AI Ask Quickchat AI a question