Tự làm chatbot bóng đá để tra lịch thi đấu, phong độ và bảng xếp hạng

Piotr Grudzień
Ngày đăng Thời gian đọc: 12 phút
Tóm tắt ngày thi đấu ba dòng của Arsenal trong Quickchat AI bên cạnh trang Account Settings của football-data.org hiển thị gói đăng ký Free

Bạn đang sắp xếp ngày thứ Bảy của mình xoay quanh chuyến làm khách của Arsenal tới sân của Newcastle. Một người bạn ở New York cần biết giờ bóng lăn. Rồi có người trong nhóm chat hỏi Arsenal đá thế nào ở trận sân khách gần nhất. Câu trả lời đầu tiên có trong danh sách lịch thi đấu. Đối với câu thứ hai, bạn cần biết ai đã ghi bàn trong tỉ số “Liverpool 0, Arsenal 1”.

Bạn sẽ tạo Matchday Notebook, một chatbot bóng đá có thể tra cứu ba trận đấu tiếp theo tại Premier League, xem năm kết quả gần nhất của Arsenal tại giải đấu và tìm vị trí của họ trên bảng xếp hạng. Ví dụ này được lấy vào ngày 18 tháng 11 năm 2026. Trận làm khách trên sân Newcastle dự kiến diễn ra vào Thứ Bảy, ngày 21 tháng 11 lúc 17:30 UTC, tức 12:30 chiều ở New York.

Lịch thi đấu Newcastle trong Native Stats và câu trả lời ngày thi đấu tương ứng trong Quickchat AI Trang trận đấu của nhà cung cấp và Agent riêng đều thống nhất về giờ bóng lăn. Cuộc trò chuyện trên Quickchat AI được chạy dựa trên một bản mô phỏng dữ liệu công khai cũ mà bạn có thể tái hiện bên dưới.

Kiểm tra trận đấu với Newcastle hoặc tải xuống bộ công cụ Matchday Notebook. Giải nén tệp và chạy python3 replay.py để xem ba trận đấu sắp tới, năm kết quả vừa qua và một dòng trên bảng xếp hạng mà không cần tài khoản. Bộ công cụ này cũng bao gồm các cài đặt Action và Main Prompt để bạn kết nối với nguồn dữ liệu của riêng mình.

1. Chatbot sẽ theo dõi câu lạc bộ và giải đấu nào?

Trước tiên, hãy xác định câu lạc bộ và giải đấu. Phong độ của Arsenal ở giải vô địch quốc gia có thể thay đổi tùy thuộc vào việc bạn có tính cả một trận đấu ở cúp châu Âu vào tối thứ Ba hay không. Trong sổ tay này, Arsenal là đội 57 và giải đấu là Premier League 2021, còn được biết đến với mã PL.

  1. Mở biểu mẫu đăng ký của football-data.org. Nhập tên và địa chỉ email của bạn, chấp nhận các điều khoản và chọn Create account. Kiểm tra giải đấu của bạn trên danh sách các giải được hỗ trợ. Gói miễn phí bao gồm Premier League, với lịch thi đấu và tỉ số có độ trễ.

Biểu mẫu đăng ký của football-data.org với các trường nhập tên và email, nút Create account và thông tin chi tiết về Free Tier Sử dụng một địa chỉ email mà bạn có thể kiểm tra. football-data.org sẽ gửi khóa API đến đó sau khi đăng ký. Gói miễn phí cho phép 10 yêu cầu mỗi phút.

Nếu bạn đã có tài khoản, hãy đăng nhập bằng email và token API của bạn. Nếu bạn cần một bản sao khác của token, hãy yêu cầu qua email bằng địa chỉ bạn đã đăng ký. Giữ lại token cho header được bảo vệ ở Bước 2.

Trang Account Settings của football-data.org hiển thị gói đăng ký Free và một phần danh sách Available competitions Kiểm tra gói của bạn trong Subscription và tìm giải đấu của bạn trong Available competitions. Đoạn trích này cho thấy UEFA Champions League (CL) và Bundesliga (BL1).

  1. Để theo dõi một câu lạc bộ khác, hãy tra cứu trong danh sách các đội của giải đấu, ví dụ GET /v4/competitions/PL/teams. Sử dụng ID đội và ID giải đấu được trả về trong các yêu cầu trận đấu bên dưới. Hướng dẫn nhanh v4 có cả hai cách tra cứu này.
  2. Tạo một Agent trên Quickchat AI, đặt tên là Matchday Notebook, và giữ ở chế độ riêng tư trong khi bạn thử nghiệm. Bạn cần có đủ credit cho các cuộc trò chuyện và mô phỏng. Mở Identity → AI Persona → Main Prompt và dán phần hướng dẫn bên dưới. Các ảnh chụp màn hình và cài đặt có thể sao chép đều dùng tiếng Anh.

Trang câu lạc bộ của Arsenal trong Native Stats và cài đặt Identity của Matchday Notebook trong Quickchat AI Giữ cùng một câu lạc bộ ở cả hai nơi. Trong sản phẩm, hướng dẫn của Agent nằm dưới Identity.

Sao chép Matchday Notebook Main Prompt
You are Matchday Notebook, an Arsenal Premier League companion. Use get_club_fixtures for the schedule, get_recent_results for form and get_league_standings for the league table. For match reads, use an inclusive UTC start date and an exclusive end date. Ask for dates when the window is unclear.

List up to the requested number of TIMED or SCHEDULED fixtures in kickoff order. Give the date, time and timezone; say when the hour is unconfirmed. Flag postponed or cancelled games separately. For form, sort FINISHED matches newest first, take up to five and read full-time scores home first. Judge wins, draws and losses from Arsenal's side. For standings, find Arsenal (team 57) in the TOTAL table. Give the season, position, games played and points.

Keep answers short. Link a match to https://native-stats.org/match/ID using its returned ID, and the Premier League table to https://native-stats.org/competition/PL/. Attribute football-data.org, give the relevant date and identify any snapshot as a snapshot. Quote a retrieval time only if supplied. Keep null scores unknown. Report empty windows, missing scores and failed reads accurately. Stop after a rate limit. Do not predict scores.

2. Làm cách nào để lấy thông tin trận đấu tiếp theo của Arsenal?

Bắt đầu với Action trả lời câu hỏi về giờ bóng lăn của nhóm chat. Một yêu cầu sẽ trả về thông tin cả hai câu lạc bộ, thời gian dự kiến và trạng thái trận đấu. Hãy để mở bộ lọc trạng thái ở đây để trường hợp trận đấu bị hoãn vẫn có thể được hiển thị. Một bản ghi TIMED sẽ có giờ bóng lăn. Đối với SCHEDULED, hãy cho người đọc biết rằng giờ đấu vẫn chưa được xác nhận.

  1. Mở Actions & MCPs → Add Action → API Action → Create manually. Đặt API Action Name thành get_club_fixtures và When to run thành AI decides. Dưới mục What to ask the user first, thêm các đầu vào Text bắt buộc là date_from và date_to, cả hai đều chọn No default. Mô tả của chúng là “Ngày UTC bắt đầu, định dạng YYYY-MM-DD” và “Ngày UTC kết thúc, định dạng YYYY-MM-DD”.
  2. Đối với API Endpoint, chọn GET và nhập URL bên dưới. Mở Query Params và đặt competitions thành giá trị cố định 2021. Thêm dateFrom và dateTo. Với mỗi giá trị, sử dụng Add AI Data → Parameters để chèn tham số ngày tương ứng. Để trống mục Body.
  3. Dán mô tả bên dưới vào mục API Action Description và lưu Action. Trong mục Headers, thông tin xác thực sẽ nằm trong một hàng X-Auth-Token chỉ ghi. Thiết lập điều đó trước yêu cầu đầu tiên của bạn. Thêm một tiêu đề thông thường thứ hai với Accept làm khóa và application/json làm giá trị. Sử dụng cùng hai tiêu đề này trên cả ba Action.
https://api.football-data.org/v4/teams/57/matches

Lộ trình Team matches của football-data.org và điểm cuối GET của Quickchat AI với Query Params cho giải đấu 2021 và hai ngày Làm theo đường dẫn các trận đấu của đội từ tài liệu tham khảo của nhà cung cấp vào Action. Arsenal được cố định trong URL, giải đấu trong Query Params, và hai ngày được lấy từ cuộc trò chuyện.

Sao chép mô tả Action lấy lịch thi đấu
Use for Arsenal's upcoming Premier League fixtures in the requested date window. Sort by utcDate ascending. Show TIMED or SCHEDULED matches and flag postponements or cancellations separately. State the window if fewer fixtures are returned.

Các ví dụ về yêu cầu của nhà cung cấp đặt khóa API trong X-Auth-Token. Sử dụng cùng tên header đó trong Headers trên get_club_fixtures.

Biểu mẫu Sign in của football-data.org, ví dụ về X-Auth-Token v4 và tab Headers trong Quickchat AI Biểu mẫu đăng nhập yêu cầu email và token API của bạn. Trong Quickchat AI, chỉ có token được nhập vào hàng X-Auth-Token được bảo vệ.

Nhập mã token một cách bảo mật. Bảng điều khiển có thể thay thế một giá trị bí mật đã lưu. Để đặt tiêu đề ở chế độ chỉ ghi ngay từ đầu, hãy sử dụng kết nối tài khoản một lần cho mỗi Action. Kết nối tài khoản của bạn bằng hướng dẫn thiết lập Quickchat AI trong ChatGPT hoặc Claude. Yêu cầu trợ lý đã kết nối chuẩn bị tiêu đề với một giá trị giữ chỗ bằng hướng dẫn bên dưới. Sau đó, tự mở tab Headers của Action, thay thế giá trị trong cùng hàng đó bằng mã token football-data.org thô của bạn và chọn Save changes. Mở lại trình chỉnh sửa và kiểm tra xem nó có hiển thị [redacted] không. Giữ mã token trong bảng điều khiển và không đưa vào cuộc trò chuyện.

On Matchday Notebook, set the X-Auth-Token header of get_club_fixtures to the literal value REPLACE_IN_DASHBOARD with is_secret=true. Preserve the rest of the settings. Read the Action back and confirm that the header is secret and the value is [redacted]. Stop before testing.

Tab Headers trong Action lịch thi đấu hiển thị X-Auth-Token với giá trị đã được che đi Đây là tiêu đề đã lưu. Nhà cung cấp yêu cầu chỉ có mã token, không có tiền tố Bearer.

Thử lần đọc đầu tiên. Trong Test Response → Test the API, hãy cung cấp ngày bắt đầu và ngày sau ngày cuối cùng bạn muốn. Sau đó, bật Action và hỏi trong AI Preview về ba trận đấu tiếp theo của giải trong khoảng thời gian đó. Đối với bản dựng trực tiếp, hãy chọn các ngày sắp tới. Ví dụ lưu trữ đã sử dụng 2026-11-18 và 2026-12-03, vì vậy tối ngày 2 tháng 12 đã được tính. Kiểm tra trận đấu gần nhất bằng cách mở liên kết nguồn của nó. Tài liệu tham khảo về bộ lọc ngày v4 giải thích về ngày kết thúc không bao gồm.

Ba ngày thi đấu trong khoảng thời gian từ ngày bắt đầu 18 tháng 11 (bao gồm) đến ngày kết thúc 3 tháng 12 (không bao gồm) Trong dữ liệu ví dụ, trận làm khách của Newcastle diễn ra vào ngày 21 tháng 11, trận tiếp Manchester City trên sân nhà vào ngày 29 tháng 11 và trận làm khách của Brentford vào ngày 2 tháng 12. Nếu kết thúc yêu cầu vào ngày 2 tháng 12 thì sẽ bỏ lỡ trận đấu với Brentford.

3. Làm cách nào để xem năm kết quả gần nhất của Arsenal?

Trận đấu tiêu biểu nhất trong ví dụ này kết thúc với tỷ số Liverpool 0, Arsenal 1. Nếu chatbot luôn coi con số đầu tiên là bàn thắng của Arsenal, nó sẽ biến một trận thắng trên sân khách thành một trận thua. Hãy giữ nguyên thứ tự tỷ số sân nhà-sân khách và dùng ID đội bóng để xác định kết quả của Arsenal.

  1. Tạo một API Action thứ hai tên là get_recent_results. Sử dụng cùng điểm cuối GET, các trường nhập ngày, chip ngày và bộ lọc giải đấu. Thêm hàng truy vấn status với giá trị cố định là FINISHED.
  2. Đặt mô tả bên dưới. Lặp lại thiết lập tiêu đề chỉ ghi cho get_recent_results, kiểm tra giá trị đã che và bật Action.
  3. Yêu cầu năm trận đấu gần nhất của giải trong một khoảng thời gian nhất định. Ví dụ, sử dụng từ ngày 1 tháng 10 đến ngày 17 tháng 11 năm 2026. Sắp xếp theo utcDate trước khi lấy năm trận. Nếu khoảng thời gian đó chỉ trả về ba trận, hãy hiển thị ba trận đó và đề nghị tìm kiếm lùi lại.
Sao chép mô tả Action kết quả
Use for Arsenal's recent Premier League form in the requested date window. Sort FINISHED matches newest first, then take up to five. Use both full-time goals and the home and away team IDs to judge each result from Arsenal's perspective.

Liverpool 0, Arsenal 1 trên trang trận đấu nguồn với điểm số sân khách của Arsenal được chọn Đầu tiên tìm Arsenal ở cột đội khách, sau đó đọc số bàn thắng của đội khách. Số không của Liverpool có nghĩa là họ đã giữ sạch lưới.

Đọc theo thứ tự từ mới nhất đến cũ nhất. Arsenal thắng Hull 1–0, thắng Liverpool 1–0 trên sân khách, thắng Everton 2–0, thắng Nottingham Forest 1–0 trên sân khách và thắng Leeds 2–1. Như vậy là năm trận thắng, ghi bảy bàn và thủng lưới một bàn. Biên bản trận đấu với Liverpool là một bài kiểm tra tốt vì đội thắng được liệt kê thứ hai.

Trong dữ liệu thử nghiệm đã lưu, danh sách trả về cố ý bắt đầu bằng trận Leeds và kết thúc bằng trận Hull. Việc sắp xếp theo giờ bóng lăn sẽ đưa trận Hull lên đầu câu trả lời. Mở phản hồi Action bên cạnh cuộc trò chuyện và so sánh trận đấu đầu tiên và cuối cùng trong cả hai danh sách.

Năm trận đấu đã kết thúc của Arsenal được hiển thị theo thứ tự ngày với tỷ số sân nhà và sân khách Năm trận thắng có thể che giấu một chi tiết quan trọng. Hai trong số này là trận đấu trên sân khách, vì vậy số bàn thắng của đội thắng nằm ở bên phải.

4. Lấy vị trí trên bảng xếp hạng và điểm số từ đâu?

Năm trận thắng cho bạn biết phong độ trong vài tuần gần đây. Vị trí trên bảng xếp hạng còn phụ thuộc vào tất cả các trận đấu trước đó và kết quả của các đội khác. Hãy cung cấp cho Agent một Action xem bảng xếp hạng riêng.

  1. Đặt tên là get_league_standings. Chọn GET, dán điểm cuối bên dưới và để trống các trường nhập, tham số truy vấn và phần thân. Sử dụng AI decides, thêm mô tả bên dưới và lặp lại thiết lập tiêu đề chỉ ghi cho Action này.
  2. Trong Test Response, hãy tìm trong standings mục có type là TOTAL. Trong table của mục đó, tìm team.id bằng 57. Bật Action và hỏi “Arsenal đang ở đâu trên bảng xếp hạng Premier League?”
  3. So sánh position, playedGames và points với nguồn dữ liệu của cùng mùa giải và ngày. Vào ngày 18 tháng 11, bảng xếp hạng Premier League trong Native Stats cho thấy hạng 1, đã đấu 10 trận, 27 điểm. Bảng xếp hạng hiện tại của bạn sẽ thay đổi khi các câu lạc bộ khác thi đấu.
https://api.football-data.org/v4/competitions/PL/standings
Sao chép mô tả Action bảng xếp hạng
Use for the current Premier League table. Find team ID 57 in standings where type is TOTAL. Report season, position, playedGames and points. If the row is missing, say the position is unavailable.

Hàng của Arsenal ở vị trí đầu bảng xếp hạng Premier League và các trường được sổ tay sử dụng Đọc trên một hàng duy nhất trong TOTAL. 27 điểm này bao gồm tất cả mười trận đấu của giải tại thời điểm chụp nhanh.

5. Bạn có thể truy vết bản tin ngày thi đấu về nguồn của nó không?

Bắt đầu một cuộc trò chuyện AI Preview mới. Hỏi về ba trận đấu tiếp theo, sau đó hỏi “Chúng ta đá thế nào trong năm trận gần nhất của giải?”, cung cấp khoảng thời gian, rồi hỏi “Vị trí của chúng ta trên bảng xếp hạng là gì?” Trong Inbox, mở dấu hiệu Action đã gọi cho mỗi câu trả lời. View logs của Action cho phép bạn so sánh các tham số và phản hồi với những gì người hâm mộ đã thấy. Hướng dẫn xây dựng một API Action chỉ ra nơi tìm các điều khiển này.

Để lấy bản tóm tắt tổng hợp ngày thi đấu như ở đầu bài viết, hãy đặt câu hỏi dưới đây bằng cách sử dụng ngày tháng trong ví dụ đã lưu. Để có bản tóm tắt cập nhật, hãy sử dụng ngày sắp tới cho lịch thi đấu và ngày gần đây cho kết quả.

Arsenal briefing for 18 Nov 2026: next away kickoff this week (UTC), last five since 1 Oct, and table position. Three short lines.

Lệnh gọi Action lịch thi đấu trong Quickchat AI với yêu cầu và biên bản trận đấu được trả về Kiểm tra ngày và ID trận đấu trong lệnh gọi. Trong dữ liệu ví dụ, 560651 là trận đấu với Newcastle.

Để kiểm tra lặp lại, mở Conversations → Testing, tạo một bộ dữ liệu và lưu ba câu hỏi. Thêm hai câu hỏi về các trường hợp biên được hiển thị bên dưới. Chạy bộ dữ liệu sau khi thay đổi mô tả Action và kiểm tra các lệnh gọi cùng với các câu trả lời. Sử dụng một phản hồi được kiểm soát để thử nghiệm một trạng thái hiếm gặp hoặc một lỗi. Một câu hỏi giả định chỉ dùng để kiểm tra cách diễn đạt của câu trả lời.

Bộ dữ liệu Matchday Notebook trong Quickchat AI chứa các câu hỏi về lịch thi đấu, phong độ, bảng xếp hạng và các trường hợp biên Sử dụng cùng các câu hỏi sau mỗi lần chỉnh sửa. Kết quả trận đấu sân khách giúp phát hiện lỗi ghi bàn mà một bài kiểm tra chỉ toàn các trận sân nhà sẽ bỏ sót.

Trường hợp kiểm thửNgười hâm mộ nên nghe thấy gì
Một trận đấu bị hoãn và cả hai bàn thắng đều là null. Có phải là một trận hòa không?Trận đấu đã bị hoãn. Không có tỷ số được ghi nhận.
Một tìm kiếm thành công trả về một danh sách matches trống. Có phải cả mùa giải đều trống không?Không có trận đấu nào được trả về trong khoảng thời gian đó. Cung cấp các ngày bạn đã tìm kiếm.
Nhà cung cấp trả về 401 hoặc 403.Tra cứu không thành công. Kiểm tra mã token đã lưu và phạm vi phủ sóng của giải đấu.
Nhà cung cấp trả về 429.Đã đạt giới hạn yêu cầu. Vui lòng thử lại sau.

Câu trả lời của Quickchat AI khi không có kết quả, tương ứng với một yêu cầu thành công nhưng không tìm thấy trận đấu nào Yêu cầu vẫn được tính là thành công dù không có kết quả. Trợ lý có thể đề xuất mở rộng khoảng thời gian tìm kiếm.

Để kiểm tra lại giờ bóng lăn đã thay đổi, hãy so sánh với thông báo điều chỉnh lịch thi đấu của ban tổ chức giải. Luôn ghi lại ngày thi đấu dự kiến, múi giờ và ngày bạn tra cứu thông tin. Dữ liệu miễn phí có thể cập nhật chậm hơn so với thay đổi từ đài truyền hình, điều này rất quan trọng khi ai đó sắp xếp kế hoạch ngày thứ Bảy của mình dựa vào câu trả lời.

Football data provided by the Football-Data.org API. Ví dụ trong bài viết sử dụng các trang Native Stats công khai của nhà cung cấp. Xem các gói dữ liệu và giới hạn số yêu cầu mỗi phút để biết phạm vi và độ mới của dữ liệu hiện tại.

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

Tôi có thể sử dụng API bóng đá nào cho chatbot lịch thi đấu?

API football-data.org v4 cung cấp lịch thi đấu, kết quả và bảng xếp hạng cho các giải đấu được hỗ trợ. Sử dụng endpoint các trận đấu của đội để xem lịch thi đấu và phong độ gần đây, và endpoint bảng xếp hạng của giải đấu để xem vị trí.

Kết quả football-data.org có trực tiếp trên gói miễn phí không?

Gói miễn phí bao gồm lịch thi đấu và tỉ số có độ trễ, bảng xếp hạng cho các giải đấu được hỗ trợ và giới hạn 10 yêu cầu API mỗi phút. Hãy ghi rõ nguồn và ngày tháng trong mỗi câu trả lời và kiểm tra gói của bạn nếu bạn cần tỉ số trực tiếp.

Làm cách nào để thay đổi Arsenal thành một đội khác?

Tìm ID đội và giải đấu của câu lạc bộ trong football-data.org. Thay thế đội 57 trong cả hai Action trận đấu, thay đổi bộ lọc giải đấu dạng số và URL bảng xếp hạng, sau đó cập nhật tên câu lạc bộ và ID đội trong phần hướng dẫn. Kiểm tra lại với một trận đấu mà bạn biết.

Làm cách nào để lấy năm trận đấu gần nhất từ góc độ của đội?

Lọc các trận đấu đã kết thúc trong một khoảng ngày đã định, sắp xếp theo giờ bóng lăn từ mới nhất đến cũ nhất và lấy tối đa năm trận. Với mỗi tỉ số, hãy kiểm tra xem đội của bạn đá sân nhà hay sân khách trước khi xác định là thắng, hòa hay thua. Nếu có ít hơn năm trận đủ điều kiện, hãy cho biết số trận bạn tìm thấy.

Kết quả trống có ý nghĩa gì đối với một trận đấu bị hoãn?

Kết quả trống có nghĩa là nhà cung cấp chưa cung cấp tổng số bàn thắng cho đội đó. Giữ trạng thái trận đấu hiển thị và để kết quả không xác định. Một trận hòa không bàn thắng cần một trận đấu đã kết thúc với hai số không được ghi nhận.

Làm cách nào để chuyển đổi giờ bóng lăn sang múi giờ của tôi?

Bắt đầu với giờ bóng lăn theo múi giờ UTC của trận đấu, sử dụng một múi giờ có tên như America/New_York và giữ lại ngày tháng trong câu trả lời. Quy ước giờ mùa hè và việc chuyển ngày có thể ảnh hưởng đến thời gian hiển thị.

Quickchat AI Quickchat AI Ask Quickchat AI a question