Buat chatbot sepak bola untuk jadwal, hasil laga, dan klasemen

Piotr Grudzień
Diterbitkan Waktu baca 9 menit
Ringkasan tiga baris hari pertandingan Arsenal di Quickchat AI bersama Pengaturan Akun football-data.org Account Settings yang menampilkan langganan Free

Anda mengatur hari Sabtu untuk menonton laga tandang Arsenal ke Newcastle. Seorang teman di New York menanyakan waktu sepak mulanya. Lalu seseorang di grup chat bertanya bagaimana hasil laga tandang terakhir Arsenal. Jawaban pertama ada di daftar jadwal pertandingan. Untuk yang kedua, Anda perlu tahu siapa pencetak gol di skor “Liverpool 0, Arsenal 1”.

Anda akan membuat Matchday Notebook, sebuah chatbot sepak bola yang mencari tiga jadwal pertandingan Liga Primer berikutnya, membaca lima hasil laga terakhir Arsenal di liga, dan menemukan posisi mereka di klasemen. Contoh ini dipatok pada 18 November 2026. Laga tandang melawan Newcastle dijadwalkan pada Sabtu, 21 November pukul 17:30 UTC, atau pukul 12:30 sore di New York.

Jadwal pertandingan Newcastle di Native Stats dan jawaban hari pertandingan yang sesuai di Quickchat AI Halaman pertandingan dari penyedia dan Agen pribadi menyetujui waktu sepak mula. Percakapan Quickchat AI dijalankan menggunakan data replay publik bertanggal, yang dapat Anda coba lagi di bawah ini.

Periksa jadwal pertandingan Newcastle atau unduh kit Matchday Notebook. Ekstrak file zip dan jalankan python3 replay.py untuk melihat tiga jadwal pertandingan, lima hasil, dan baris klasemen tanpa perlu akun. Kit yang sama mencakup pengaturan Action dan Main Prompt untuk menghubungkan feed Anda sendiri.

1. Klub dan kompetisi mana yang akan diikuti chatbot?

Tentukan klub dan liga terlebih dahulu. Performa Arsenal di liga bisa berubah tergantung apakah Anda menghitung laga Selasa malam di Eropa. Dalam buku catatan ini, Arsenal berarti tim 57 dan liga berarti Liga Primer 2021, yang juga dikenal dengan kode PL.

  1. Buka formulir pendaftaran football-data.org. Masukkan nama depan dan alamat email Anda, setujui persyaratannya, lalu pilih Create account. Periksa liga Anda di daftar cakupan. Paket gratis mencakup Liga Primer, dengan jadwal dan skor yang ditayangkan tunda.

Formulir pendaftaran football-data.org dengan kolom nama depan dan email, tombol Create account, dan detail Free Tier Gunakan alamat email yang dapat Anda periksa. football-data.org akan mengirimkan kunci API ke sana setelah pendaftaran. Paket gratis mengizinkan 10 permintaan per menit.

Jika Anda sudah memiliki akun, masuk dengan email dan token API Anda. Jika Anda memerlukan salinan token lainnya, minta melalui email menggunakan alamat yang Anda daftarkan. Simpan token tersebut untuk header yang dilindungi di Langkah 2.

Pengaturan Akun football-data.org Account Settings menampilkan langganan Free dan sebagian daftar Available competitions Periksa paket Anda di bawah Subscription dan cari liga Anda di bawah Available competitions. Kutipan ini menunjukkan Liga Champions UEFA (CL) dan Bundesliga (BL1).

  1. Untuk mengikuti klub lain, cari di daftar tim kompetisi, misalnya GET /v4/competitions/PL/teams. Gunakan ID tim dan ID kompetisi yang dikembalikan dalam permintaan pertandingan di bawah ini. Panduan cepat v4 memiliki kedua pencarian.
  2. Buat Agen Quickchat AI, beri nama Matchday Notebook, dan rahasiakan saat Anda menguji. Anda memerlukan kredit yang tersedia untuk percakapan dan simulasi. Buka Identity → AI Persona → Main Prompt dan tempel instruksi di bawah ini. Tangkapan layar dan pengaturan yang dapat disalin menggunakan bahasa Inggris.

Halaman klub Arsenal di Native Stats dan pengaturan Identity Matchday Notebook di Quickchat AI Pertahankan klub yang sama di kedua tempat. Dalam produk, instruksi Agen berada di bawah Identity.

Salin Main Prompt Matchday Notebook
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. Bagaimana cara mendapatkan jadwal pertandingan Arsenal berikutnya?

Mulai dengan Action yang menjawab pertanyaan waktu sepak mula dari grup chat. Satu permintaan akan mengembalikan kedua klub, waktu yang dijadwalkan, dan status pertandingan. Biarkan filter status tetap terbuka agar penundaan laga tetap bisa ditampilkan. Catatan berstatus TIMED memiliki waktu sepak mula. Untuk SCHEDULED, beri tahu pengguna bahwa jamnya masih akan dikonfirmasi.

  1. Buka Actions & MCPs → Add Action → API Action → Create manually. Atur API Action Name ke get_club_fixtures dan When to run ke AI decides. Di bawah What to ask the user first, tambahkan input Text yang wajib diisi, yaitu date_from dan date_to, keduanya dengan No default. Deskripsinya adalah “Tanggal mulai dalam UTC, format YYYY-MM-DD” dan “Tanggal akhir dalam UTC, format YYYY-MM-DD”.
  2. Untuk API Endpoint, pilih GET dan masukkan URL di bawah ini. Buka Query Params dan atur competitions ke literal 2021. Tambahkan dateFrom dan dateTo. Untuk setiap nilai, gunakan Add AI Data → Parameters untuk menyisipkan input tanggal yang cocok. Biarkan Body kosong.
  3. Tempel deskripsi di bawah API Action Description dan simpan Action tersebut. Di bawah Headers, kredensial akan masuk ke baris X-Auth-Token yang hanya bisa ditulis. Siapkan itu sebelum permintaan pertama Anda. Tambahkan header kedua, biasa, dengan Accept sebagai kunci dan application/json sebagai nilai. Gunakan dua header yang sama pada ketiga Action.
https://api.football-data.org/v4/teams/57/matches

Rute Team matches football-data.org dan titik akhir GET Quickchat AI dengan Query Params untuk kompetisi 2021 dan dua tanggal Ikuti rute pertandingan tim dari referensi penyedia ke dalam Action. Arsenal ditetapkan di URL, liga di Query Params, dan kedua tanggal berasal dari percakapan.

Salin deskripsi Action jadwal pertandingan
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.

Contoh permintaan dari penyedia menempatkan kunci API di X-Auth-Token. Gunakan nama header yang sama di Headers pada get_club_fixtures.

Formulir Sign in football-data.org publik, contoh X-Auth-Token v4, dan tab Headers di Quickchat AI Formulir masuk memerlukan email dan token API Anda. Di Quickchat AI, hanya token yang dimasukkan ke baris X-Auth-Token yang dilindungi.

Masukkan token secara pribadi. Dasbor dapat mengganti rahasia yang disimpan. Untuk membuat header hanya-tulis sejak awal, gunakan koneksi akun sekali per Action. Hubungkan akun Anda menggunakan panduan pengaturan Quickchat AI di ChatGPT atau Claude. Minta asisten yang terhubung untuk menyiapkan header dengan penanda yang tidak berbahaya menggunakan instruksi di bawah ini. Kemudian buka tab Headers Action sendiri, ganti nilai di baris yang sama dengan token football-data.org mentah Anda, dan pilih Save changes. Buka kembali editor dan periksa apakah itu menampilkan [redacted]. Simpan token di dasbor dan jauhkan dari percakapan.

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.

Headers di Action jadwal pertandingan menunjukkan X-Auth-Token dengan nilai yang disunting Ini adalah header yang disimpan. Penyedia mengharapkan token itu sendiri, tanpa awalan Bearer.

Coba baca pertama. Di Test Response → Test the API, berikan tanggal mulai dan hari setelah tanggal terakhir yang Anda inginkan. Kemudian aktifkan Action dan tanyakan di AI Preview untuk tiga jadwal pertandingan liga berikutnya dalam rentang waktu tersebut. Untuk build langsung, pilih tanggal yang akan datang. Contoh arsip menggunakan 2026-11-18 dan 2026-12-03, jadi malam 2 Desember dihitung. Periksa pertandingan terdekat dengan membuka tautan sumbernya. Referensi filter tanggal v4 menjelaskan tanggal akhir eksklusif.

Tiga tanggal jadwal pertandingan antara awal inklusif pada 18 November dan akhir eksklusif pada 3 Desember Dalam contoh data ini, laga tandang melawan Newcastle jatuh pada 21 November, laga kandang melawan Manchester City pada 29 November, dan laga tandang melawan Brentford pada 2 Desember. Jika tanggal akhir permintaan adalah 2 Desember, laga melawan Brentford tidak akan masuk.

3. Bagaimana cara membaca hasil lima laga terakhir dari sisi Arsenal?

Pertandingan paling menarik dalam contoh ini berakhir Liverpool 0, Arsenal 1. Jika chatbot memperlakukan angka pertama sebagai skor Arsenal setiap saat, itu mengubah kemenangan tandang menjadi kekalahan. Pertahankan setiap skor dalam urutan kandang-tandang dan gunakan ID tim untuk memutuskan bagaimana hasil Arsenal.

  1. Buat API Action kedua bernama get_recent_results. Gunakan endpoint GET yang sama, input tanggal, chip tanggal, dan filter kompetisi. Tambahkan baris kueri status dengan nilai literal FINISHED.
  2. Atur deskripsi di bawah ini. Ulangi pengaturan header hanya-tulis untuk get_recent_results, periksa mask, dan aktifkan Action.
  3. Minta lima pertandingan liga terbaru dalam rentang waktu yang ditentukan. Untuk contoh, gunakan 1 Oktober hingga 17 November 2026. Urutkan berdasarkan utcDate sebelum mengambil lima. Jika jendela hanya mengembalikan tiga, tunjukkan ketiga itu dan tawarkan untuk mencari lebih jauh ke belakang.
Salin deskripsi Action untuk hasil pertandingan
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 di halaman pertandingan sumber dengan skor tandang Arsenal yang dipilih Pertama, cari Arsenal di sisi tandang, lalu baca gol tandang. Angka nol untuk Liverpool berarti clean sheet.

Baca dari laga terbaru. Arsenal mengalahkan Hull 1–0, menang 1–0 di kandang Liverpool, mengalahkan Everton 2–0, menang 1–0 di kandang Nottingham Forest, dan mengalahkan Leeds 2–1. Hasilnya adalah lima kemenangan, tujuh gol tercipta, dan satu kali kebobolan. Catatan pertandingan Liverpool menjadi bahan uji yang bagus karena tim pemenang muncul di urutan kedua.

Dalam data uji coba yang disimpan, daftar yang ditampilkan sengaja dimulai dengan pertandingan Leeds dan diakhiri dengan pertandingan Hull. Pengurutan berdasarkan waktu sepak mula akan memindahkan Hull ke urutan teratas dalam jawaban. Buka respons Action di samping percakapan dan bandingkan pertandingan pertama dan terakhir di kedua daftar tersebut.

Lima pertandingan Arsenal yang sudah selesai ditampilkan berdasarkan tanggal dengan skor kandang dan tandang Lima kemenangan bisa menyembunyikan detail penting. Dua di antaranya adalah pertandingan tandang, jadi angka kemenangan ada di sebelah kanan.

4. Dari mana data posisi dan poin di klasemen liga berasal?

Lima kemenangan memberi tahu Anda bagaimana beberapa minggu terakhir berjalan. Posisi liga juga bergantung pada semua pertandingan sebelumnya dan hasil pertandingan tim lain. Berikan Agent Action klasemen terpisah.

  1. Beri nama get_league_standings. Pilih GET, tempelkan endpoint di bawah ini dan biarkan input, parameter kueri, serta body kosong. Gunakan AI decides, tambahkan deskripsi di bawah ini dan ulangi pengaturan header hanya-tulis untuk Action ini.
  2. Di Test Response, cari entri di dalam standings yang memiliki type berisi TOTAL. Di dalam table milik entri tersebut, temukan team.id yang sama dengan 57. Aktifkan Action dan tanyakan “Di mana posisi Arsenal di klasemen Premier League?”
  3. Bandingkan position, playedGames, dan points dengan sumber untuk musim dan tanggal yang sama. Pada 18 November, klasemen Premier League di Native Stats menunjukkan posisi ke-1, 10 laga, 27 poin. Klasemen Anda saat ini akan berubah seiring klub lain bermain.
https://api.football-data.org/v4/competitions/PL/standings
Salin deskripsi Action untuk klasemen
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.

Baris posisi pertama Arsenal di klasemen Premier League dan kolom-kolom yang digunakan oleh Matchday Notebook Baca satu baris di dalam TOTAL. Total 27 poin mencakup sepuluh pertandingan liga dalam data cuplikan ini.

5. Bisakah Anda melacak ringkasan hari pertandingan kembali ke sumbernya?

Mulai percakapan baru di AI Preview. Tanyakan tiga jadwal pertandingan berikutnya, lanjutkan dengan “Bagaimana hasil lima laga liga terakhir kita?”, berikan rentang tanggalnya, lalu tanyakan “Di mana posisi kita di klasemen?”. Di Inbox, buka penanda Action yang dipanggil untuk setiap jawaban. View logs dari Action tersebut memungkinkan Anda membandingkan parameter dan respons dengan apa yang dilihat oleh suporter. Panduan untuk membangun API Action menunjukkan di mana menemukan kontrol ini.

Untuk mendapatkan ringkasan hari pertandingan gabungan seperti yang ditampilkan di awal artikel, ajukan pertanyaan di bawah ini menggunakan tanggal dari contoh yang disimpan. Untuk ringkasan terkini, gunakan tanggal mendatang untuk jadwal pertandingan dan tanggal baru-baru ini untuk hasil.

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

Panggilan Action jadwal pertandingan di Quickchat AI dengan permintaan dan catatan pertandingan yang dikembalikan Periksa tanggal dan ID pertandingan dalam panggilan API. Dalam contoh data ini, 560651 adalah jadwal laga melawan Newcastle.

Untuk pemeriksaan yang dapat diulang, buka Conversations → Testing, buat kumpulan data, dan simpan tiga pertanyaan. Tambahkan dua pertanyaan batas yang ditunjukkan di bawah ini. Jalankan kumpulan data setelah mengubah deskripsi Action dan periksa panggilan bersama dengan balasan. Gunakan respons terkontrol untuk melatih status yang jarang atau kesalahan. Pertanyaan hipotetis saja menguji susunan kata dari sebuah jawaban.

Kumpulan data Matchday Notebook di Quickchat AI berisi pertanyaan tentang jadwal pertandingan, performa, klasemen, dan kasus khusus Gunakan pertanyaan yang sama setelah setiap perubahan. Hasil laga tandang dapat menemukan kesalahan pembacaan skor yang mungkin terlewat jika hanya menguji laga kandang.

Kasus ujiApa yang seharusnya didengar oleh suporter
Sebuah pertandingan ditunda dan kedua gol adalah null. Apakah itu seri?Pertandingan ditunda. Tidak ada skor yang tercatat.
Pencarian yang berhasil mengembalikan daftar matches kosong. Apakah seluruh musim kosong?Tidak ada pertandingan yang ditemukan dalam rentang waktu tersebut. Sebutkan tanggal yang Anda cari.
Penyedia mengembalikan 401 atau 403.Pencarian gagal. Periksa token yang disimpan dan cakupan kompetisi.
Penyedia mengembalikan 429.Batas permintaan tercapai. Berhenti dan coba lagi nanti.

Jawaban Quickchat AI untuk rentang waktu tanpa pertandingan, yang ditampilkan bersama permintaan berhasil. Rentang waktu tanpa hasil tetap menunjukkan permintaan yang berhasil. Asisten dapat menawarkan untuk memperlebar rentang tanggal.

Untuk memastikan perubahan waktu sepak mula, bandingkan dengan perubahan jadwal pertandingan yang diterbitkan oleh liga. Catat tanggal pertandingan, zona waktu, dan tanggal Anda memeriksanya. Data gratis bisa jadi terlambat diperbarui setelah ada perubahan siaran, dan ini penting jika seseorang merencanakan akhir pekannya berdasarkan jawaban tersebut.

Football data provided by the Football-Data.org API. Contoh bertanggal ini menggunakan halaman publik Native Stats dari penyedia. Lihat paket data dan batas jumlah permintaan API untuk cakupan dan waktu pembaruan terkini.

Pertanyaan yang sering diajukan

API sepak bola mana yang bisa saya gunakan untuk chatbot jadwal pertandingan?

API v4 football-data.org menyediakan jadwal pertandingan, hasil, dan klasemen untuk kompetisi yang didukung. Gunakan endpoint pertandingan tim untuk jadwal dan hasil terkini, serta endpoint klasemen kompetisi untuk posisi liga.

Apakah skor football-data.org tersedia secara langsung di paket gratis?

Paket gratis mencakup skor dan jadwal yang ditayangkan tunda, klasemen liga untuk kompetisi yang didukung, dan batas 10 permintaan API per menit. Sertakan sumber dan tanggal pada setiap jawaban dan periksa paket Anda jika memerlukan skor langsung.

Bagaimana cara mengubah Arsenal ke tim lain?

Temukan ID tim dan kompetisi klub di football-data.org. Ganti tim 57 di kedua Action pertandingan, ubah filter kompetisi numerik dan URL klasemen, lalu perbarui nama klub dan ID tim di instruksi. Uji dengan jadwal pertandingan yang Anda kenali.

Bagaimana cara mendapatkan hasil lima pertandingan terakhir dari sudut pandang tim?

Filter pertandingan liga yang sudah selesai dalam rentang tanggal tertentu, urutkan berdasarkan waktu sepak mula dari yang terbaru ke yang terlama, dan ambil hingga lima laga. Untuk setiap skor, periksa apakah tim Anda bermain kandang atau tandang sebelum menentukan menang, seri, atau kalah. Jika yang memenuhi syarat kurang dari lima, tampilkan jumlah yang Anda temukan.

Apa arti skor kosong untuk pertandingan yang ditunda?

Skor kosong berarti penyedia belum memberikan total gol untuk tim tersebut. Biarkan status pertandingan terlihat dan biarkan skor tidak diketahui. Hasil imbang tanpa gol membutuhkan pertandingan yang sudah selesai dengan dua angka nol yang tercatat.

Bagaimana cara mengubah waktu sepak mula pertandingan sepak bola ke zona waktu saya?

Mulai dengan waktu sepak mula pertandingan dalam UTC, gunakan nama zona waktu seperti America/New_York, dan sertakan tanggal dalam jawaban. Waktu musim panas dan perubahan hari kalender dapat memengaruhi waktu yang ditampilkan.

Quickchat AI Quickchat AI Ask Quickchat AI a question