Kaip sukurti futbolo pokalbių robotą tvarkaraščiui, rezultatams ir turnyro lentelei sekti

Piotr Grudzień
Paskelbta 8 min. skaitymo
„Arsenal“ trijų eilučių rungtynių dienos apžvalga Quickchat AI programoje kartu su „football-data.org“ Account Settings, rodančiais Free prenumeratą

Šeštadienio planus derinate prie „Arsenal“ išvykos rungtynių su „Newcastle“. Draugui Niujorke reikia sužinoti rungtynių pradžios laiką. Tada kažkas grupės pokalbyje paklausia, kaip „Arsenal“ sekėsi per paskutines išvykos rungtynes. Atsakymą į pirmą klausimą galima rasti rungtynių tvarkaraštyje. Norint atsakyti į antrąjį, reikia žinoti, kieno įvartis yra tas vienintelis rezultate „Liverpool 0, Arsenal 1“.

Jūs sukursite Matchday Notebook – futbolo pokalbių robotą, kuris suranda artimiausias trejas „Premier“ lygos rungtynes, pateikia pastarųjų penkerių „Arsenal“ lygos rungtynių rezultatus ir komandos vietą turnyro lentelėje. Pavyzdys pritaikytas 2026 m. lapkričio 18 d. Išvykos rungtynės su „Newcastle“ turėjo vykti šeštadienį, lapkričio 21 d., 17:30 UTC, arba 12:30 val. Niujorke.

„Newcastle“ rungtynės Native Stats ir atitinkamas rungtynių dienos atsakymas Quickchat AI Duomenų tiekėjo rungtynių puslapis ir privatus agentas sutaria dėl rungtynių pradžios laiko. Quickchat AI pokalbis vyko naudojant datuotą viešų įrašų duomenų pavyzdį, kurį galite atkurti žemiau.

Patikrinkite „Newcastle“ rungtynes arba atsisiųskite Matchday Notebook rinkinį. Išskleiskite archyvą ir paleiskite python3 replay.py, kad pamatytumėte trejas rungtynes, penkis rezultatus ir lentelės eilutę be paskyros. Tame pačiame rinkinyje yra veiksmo (Action) nustatymai ir Main Prompt, skirti prijungti jūsų pačių duomenų srautą.

1. Kurį klubą ir varžybas stebės pokalbių robotas?

Pirmiausia pasirinkite klubą ir lygą. „Arsenal“ sportinė forma lygoje gali skirtis priklausomai nuo to, ar įskaičiuojate antradienio vakaro rungtynes Europoje. Šiame projekte „Arsenal“ reiškia komandą 57, o lyga – „Premier“ lygą 2021, dar žinomą kodu PL.

  1. Atverkite „football-data.org“ registracijos formą. Įveskite savo vardą ir el. pašto adresą, sutikite su sąlygomis ir pasirinkite Create account. Patikrinkite savo lygą palaikomų lygų sąraše. Nemokamas planas apima „Premier“ lygą, tačiau rungtynių tvarkaraščiai ir rezultatai pateikiami su vėlavimu.

football-data.org registracijos forma su vardo ir el. pašto laukais, mygtuku Create account ir Free Tier informacija Naudokite el. pašto adresą, kurį galite pasitikrinti. „football-data.org“ po registracijos ten išsiųs API raktą. Nemokamas planas leidžia atlikti 10 užklausų per minutę.

Jei jau turite paskyrą, prisijunkite naudodami savo el. pašto adresą ir API prieigos raktą. Jei jums reikia dar vienos rakto kopijos, paprašykite jos el. paštu naudodami adresą, kuriuo registravotės. Išsaugokite raktą apsaugotai antraštei 2 veiksme.

„football-data.org“ Account Settings, rodantys Free prenumeratą ir dalį Available competitions sąrašo Patikrinkite savo planą skiltyje Subscription ir ieškokite savo lygos skiltyje Available competitions. Šioje ištraukoje parodyta UEFA Čempionų lyga (CL) ir „Bundesliga“ (BL1).

  1. Norėdami sekti kitą klubą, susiraskite jį lygos komandų sąraše, pavyzdžiui, GET /v4/competitions/PL/teams. Grąžintą komandos ID ir lygos ID naudokite žemiau pateiktose rungtynių užklausose. Abi paieškas rasite v4 greitos pradžios vadove.
  2. Sukurkite Quickchat AI agentą, pavadinkite jį Matchday Notebook ir, kol testuojate, laikykite jį privatų. Pokalbiams ir simuliacijoms jums reikės turimų kreditų. Atidarykite Identity → AI Persona → Main Prompt ir įklijuokite žemiau pateiktas instrukcijas. Ekrano nuotraukos ir kopijuojami nustatymai yra anglų kalba.

„Arsenal“ klubo puslapis Native Stats ir Matchday Notebook Identity nustatymai Quickchat AI Abiejose vietose nurodykite tą patį klubą. Produkte agento instrukcijos yra skiltyje Identity.

Nukopijuokite 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. Kaip gauti artimiausias „Arsenal“ rungtynes?

Pradėkite nuo veiksmo (Action), kuris atsako į grupės pokalbio klausimą apie rungtynių pradžią. Viena užklausa grąžina abu klubus, numatytą laiką ir rungtynių būseną. Palikite būsenos filtrą atvirą, kad sistema galėtų pranešti ir apie atidėtas rungtynes. TIMED įraše yra nurodytas rungtynių pradžios laikas. Jei būsena yra SCHEDULED, praneškite vartotojui, kad laikas dar bus patvirtintas.

  1. Atidarykite Actions & MCPs → Add Action → API Action → Create manually. Nustatykite API Action Name į get_club_fixtures, o When to run – į AI decides. Skiltyje What to ask the user first pridėkite privalomus Text tipo laukus date_from ir date_to, abu su nuostata No default. Jų aprašymai: „Pradžios data (imtinai), UTC formatu, YYYY-MM-DD“ ir „Pabaigos data (neimtinai), UTC formatu, YYYY-MM-DD“.
  2. Skiltyje API Endpoint pasirinkite GET ir įveskite žemiau esantį URL. Atidarykite Query Params ir nustatykite competitions reikšmę į 2021. Pridėkite dateFrom ir dateTo. Kiekvienai reikšmei per Add AI Data → Parameters įterpkite atitinkamą datos lauką. Palikite Body tuščią.
  3. Įklijuokite toliau pateiktą aprašymą po API Action Description ir išsaugokite veiksmą. Po Headers kredencialai bus įrašomi tik į X-Auth-Token eilutę. Nustatykite tai prieš pirmąjį užklausą. Pridėkite antrą, įprastą antraštę su Accept kaip raktu ir application/json kaip reikšme. Naudokite tas pačias dvi antraštes visuose trijuose veiksmuose.
https://api.football-data.org/v4/teams/57/matches

„football-data.org“ Team matches maršrutas ir „Quickchat AI“ GET galinis punktas su Query Params 2021 m. varžyboms ir dviem datomis Vadovaukitės komandos rungtynių maršrutu iš paslaugos teikėjo informacinio šaltinio į veiksmą. „Arsenal“ yra fiksuotas URL adrese, lyga – skiltyje Query Params, o dvi datos paimamos iš pokalbio.

Nukopijuokite rungtynių veiksmo aprašymą
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.

Tiekėjo užklausų pavyzdžiuose API raktas įdedamas į X-Auth-Token. Tą patį antraštės pavadinimą naudokite Headers laukelyje, esančiame get_club_fixtures.

Vieša „football-data.org“ Sign in forma, „v4“ X-Auth-Token pavyzdys ir „Headers“ skirtukas „Quickchat AI“ programoje Prisijungimo forma prašo jūsų el. pašto adreso ir API prieigos rakto. „Quickchat AI“ programoje tik raktas įrašomas į apsaugotą X-Auth-Token eilutę.

Įveskite prieigos raktą privačiai. Valdymo skydelyje galima pakeisti išsaugotą slaptąją informaciją. Kad ši antraštė iš pat pradžių būtų skirta tik įrašymui, kiekvienam veiksmui vieną kartą naudokite paskyros susiejimą. Susiekite savo paskyrą naudodami Quickchat AI sąrankos vadovą ChatGPT arba Claude. Paprašykite prijungto asistento paruošti antraštę su nekenksminga žyme, vadovaudamiesi tolesne instrukcija. Tada patys atidarykite veiksmo skirtuką Headers, pakeiskite reikšmę toje pačioje eilutėje savo grynuoju football-data.org prieigos raktu ir pasirinkite Save changes. Iš naujo atidarykite rengyklę ir patikrinkite, ar joje rodoma [redacted]. Laikykite prieigos raktą valdymo skydelyje, o ne pokalbyje.

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.

Rungtynių tvarkaraščio veiksmo skiltis Headers, kurioje matyti X-Auth-Token su redaguota reikšme Tai yra išsaugota antraštė. Tiekėjas tikisi gauti tik patį prieigos raktą, be Bearer priešdėlio.

Išbandykite pirmąją užklausą. Skiltyje Test Response → Test the API nurodykite pradžios datą ir dieną po paskutinės norimos datos. Tada įjunkite veiksmą ir per AI Preview paprašykite kito trejų lygos rungtynių tvarkaraščio tame laikotarpyje. Jei kuriate realiu laiku, pasirinkite būsimas datas. Archyvo pavyzdyje buvo naudojamos datos 2026-11-18 ir 2026-12-03, todėl gruodžio 2 d. vakaras buvo įtrauktas. Artimiausias rungtynes patikrinkite atidarę jų šaltinio nuorodą. v4 datos filtro apraše paaiškinta, kodėl pabaigos data neįtraukiama.

Trys rungtynių datos tarp įtraukios pradžios datos lapkričio 18 d. ir neįtraukios pabaigos datos gruodžio 3 d. Duomenų pavyzdyje rungtynės su „Newcastle“ išvykoje vyko lapkričio 21 d., su „Manchester City“ namuose – lapkričio 29 d., o su „Brentford“ išvykoje – gruodžio 2 d. Jei užklausa būtų baigusis gruodžio 2 d., rungtynės su „Brentford“ nebūtų įtrauktos.

3. Kaip sužinoti pastarųjų penkerių „Arsenal“ rungtynių rezultatus?

Iškalbingiausios šio pavyzdžio rungtynės baigėsi rezultatu „Liverpool“ 0, „Arsenal“ 1. Jei pokalbių robotas pirmąjį skaičių visada laikytų „Arsenal“ įvarčiais, pergalę išvykoje jis paverstų pralaimėjimu. Visada išlaikykite rezultatų seką „šeimininkai–svečiai“ ir pagal komandos ID nustatykite, kaip sekėsi „Arsenal“.

  1. Sukurkite antrą API Action, pavadintą get_recent_results. Naudokite tą pačią GET galinę nuorodą, datos laukelius, datos lustus ir varžybų filtrą. Pridėkite užklausos eilutę status su reikšme FINISHED.
  2. Nustatykite toliau pateiktą aprašą. Pakartokite tik įrašymui skirtos antraštės sąranką veiksmui get_recent_results, patikrinkite maskavimą ir įjunkite veiksmą.
  3. Paprašykite penkerių pastarųjų lygos rungtynių nurodytu laikotarpiu. Pavyzdyje naudokite laikotarpį nuo 2026 m. spalio 1 d. iki lapkričio 17 d. Prieš atrinkdami penkerias rungtynes, surūšiuokite rezultatus pagal utcDate. Jei per nurodytą laikotarpį randamos tik trejos rungtynės, parodykite jas ir pasiūlykite paieškoti ankstesnių.
Nukopijuoti rezultatų veiksmo aprašą
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.

Rungtynių šaltinio puslapyje rodomas rezultatas „Liverpool“ 0, „Arsenal“ 1, išskiriant „Arsenal“ įvarčius išvykoje Pirmiausia raskite „Arsenal“ kaip svečių komandą, tada nuskaitykite įvarčių skaičių. „Liverpool“ nulis reiškia, kad komanda nepraleido įvarčių.

Skaitykite rezultatus nuo naujausių. „Arsenal“ 1:0 nugalėjo „Hull“, 1:0 laimėjo išvykoje prieš „Liverpool“, 2:0 įveikė „Everton“, 1:0 nugalėjo išvykoje „Nottingham Forest“ ir 2:1 įveikė „Leeds“. Iš viso – penkios pergalės, septyni įmušti ir vienas praleistas įvartis. Rungtynių su „Liverpool“ įrašas yra geras patikrinimo pavyzdys, nes laimėjusi komanda nurodyta antra.

Išsaugotuose bandomuosiuose duomenyse grąžintas sąrašas sąmoningai pradedamas rungtynėmis su „Leeds“ ir baigiamas rungtynėmis su „Hull“. Surūšiavus pagal rungtynių pradžios laiką, rungtynės su „Hull“ atsiduria atsakymo viršuje. Atidarykite veiksmo atsakymą šalia pokalbio lango ir palyginkite pirmas bei paskutines rungtynes abiejuose sąrašuose.

Penkios sužaistos „Arsenal“ rungtynės, rodomos chronologine tvarka su namų ir išvykos rezultatais Penkios pergalės gali slėpti svarbią detalę. Dvejos iš šių rungtynių vyko išvykoje, todėl laimėjusios komandos įvarčių skaičius yra dešinėje.

4. Iš kur gaunama vieta lygoje ir taškai?

Penkios pergalės parodo, kaip komandai sekėsi pastarąsias kelias savaites. Vieta lygoje priklauso ir nuo visų ankstesnių rungtynių bei kitų komandų rezultatų. Agentui sukurkite atskirą turnyrinės lentelės veiksmą.

  1. Pavadinkite jį get_league_standings. Pasirinkite GET, įklijuokite toliau pateiktą galinę nuorodą, o įvesties, užklausos parametrų ir turinio laukus palikite tuščius. Naudokite AI decides, pridėkite toliau pateiktą aprašą ir šiam veiksmui pakartokite tik įrašymui skirtos antraštės sąranką.
  2. Skiltyje Test Response ieškokite įrašo masyve standings, kurio type yra TOTAL. Jo lentelėje table raskite įrašą, kurio team.id lygus 57. Įjunkite veiksmą ir paklauskite: „Kurią vietą „Arsenal“ užima „Premier“ lygos lentelėje?“
  3. Palyginkite position, playedGames ir points su to paties sezono ir datos šaltiniu. Lapkričio 18 d. „Premier“ lygos lentelė Native Stats rodė: 1 vieta, 10 sužaistų rungtynių, 27 taškai. Jūsų dabartinė lentelė keisis, kai žais kiti klubai.
https://api.football-data.org/v4/competitions/PL/standings
Nukopijuoti turnyrinės lentelės veiksmo aprašą
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.

„Arsenal“ eilutė pirmoje „Premier“ lygos turnyrinės lentelės vietoje ir užrašų knygelėje naudojami laukai Nuskaitykite vieną eilutę iš TOTAL tipo lentelės. 27 taškai apima visas dešimt lygos rungtynių šioje momentinėje išklotinėje.

5. Ar galima atsekti rungtynių dienos apžvalgos šaltinius?

Pradėkite naują pokalbį AI Preview. Paprašykite kito trejų rungtynių tvarkaraščio, tada paklauskite: „Kaip mums sekėsi per pastarąsias penkerias lygos rungtynes?“, nurodykite rezultatų laikotarpį, o tada paklauskite: „Kurią vietą po jų užimame lentelėje?“ Skiltyje Inbox atidarykite kiekvieno atsakymo iškviesto veiksmo žymą. Veiksmo View logs leidžia palyginti parametrus ir atsakymą su tuo, ką matė sirgalius. Vadove, kaip sukurti API Action, parodyta, kur rasti šiuos valdiklius.

Norėdami gauti straipsnio pradžioje parodytą bendrą rungtynių dienos apžvalgą, užduokite toliau pateiktą klausimą naudodami išsaugoto pavyzdžio datas. Jei norite gauti naujausią apžvalgą, tvarkaraščiui naudokite artėjančias datas, o rezultatams – praėjusias.

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

Rungtynių tvarkaraščio veiksmo iškvietimas Quickchat AI su jo užklausa ir gautu rungtynių įrašu Patikrinkite datas ir rungtynių ID iškvietime. Vietiniame duomenų pavyzdyje 560651 yra rungtynių su „Newcastle“ ID.

Norėdami atlikti pakartojamą patikrą, atidarykite Conversations → Testing, sukurkite duomenų rinkinį ir išsaugokite tris klausimus. Pridėkite du toliau parodytus kraštutinių atvejų klausimus. Pakeitę veiksmo aprašą, paleiskite duomenų rinkinį ir patikrinkite iškvietimus bei atsakymus. Naudokite kontroliuojamą atsakymą, kad išbandytumėte retą būseną ar klaidą. Vien hipotetinis klausimas leidžia patikrinti atsakymo formuluotę.

Duomenų rinkinys Matchday Notebook platformoje Quickchat AI, kuriame yra klausimai apie rungtynių tvarkaraštį, komandos formą, turnyrinę lentelę ir kraštutinius atvejus Po kiekvieno redagavimo naudokite tuos pačius klausimus. Išvykos rungtynių rezultatas padeda aptikti skaičiavimo klaidą, kurią praleistų testas, apimantis tik namų rungtynes.

Testavimo atvejisKą turėtų išgirsti sirgalius
Rungtynės atidėtos, o abu įvarčiai yra null. Ar tai buvo lygiosios?Rungtynės buvo atidėtos. Rezultatas neužfiksuotas.
Sėkminga paieška grąžina tuščią matches sąrašą. Ar visas sezonas tuščias?Per nurodytą laikotarpį rungtynių nerasta. Nurodykite datas, kuriomis ieškojote.
Teikėjas grąžina 401 arba 403.Užklausa nepavyko. Patikrinkite išsaugotą prieigos raktą ir varžybų aprėptį.
Teikėjas grąžina 429.Pasiektas užklausų limitas. Palaukite ir bandykite vėliau.

„Quickchat AI“ atsakymas tuščiame lange kartu su sėkminga užklausa, kuri nerado jokių rungtynių Tuščias langas vis tiek reiškia sėkmingą užklausą. Asistentas gali pasiūlyti praplėsti datų intervalą.

Jei norite patikrinti pakeistą rungtynių pradžios laiką, palyginkite jį su lygos paskelbtais tvarkaraščio pakeitimais. Kartu išsaugokite numatytą datą, laiko juostą ir datą, kada ją tikrinote. Nemokamas duomenų srautas gali vėluoti, palyginti su transliacijos pakeitimais, o tai svarbu, kai kas nors planuoja savo šeštadienį pagal gautą atsakymą.

Football data provided by the Football-Data.org API. Pasenusiame pavyzdyje naudojami vieši teikėjo Native Stats puslapiai. Dabartinę aprėptį ir duomenų naujumą rasite duomenų planuose ir užklausų dažnio ribojimuose.

Dažniausiai užduodami klausimai

Kokį futbolo API galiu naudoti rungtynių pokalbių robotui?

football-data.org v4 API teikia rungtynių tvarkaraščius, rezultatus ir turnyrines lenteles palaikomoms lygoms. Komandos rungtynių galinis taškas naudojamas tvarkaraščiui ir pastarųjų rungtynių rezultatams gauti, o lygos turnyrinės lentelės galinis taškas – komandos vietai lentelėje sužinoti.

Ar nemokamas football-data.org planas rodo rezultatus realiu laiku?

Nemokamas planas apima rezultatus ir tvarkaraščius su vėlavimu, palaikomų lygų turnyrines lenteles ir 10 API užklausų per minutę. Prie kiekvieno atsakymo nurodykite šaltinį bei datą ir pasitikrinkite savo plano sąlygas, jei jums reikia rezultatų realiu laiku.

Kaip pakeisti „Arsenal“ į kitą komandą?

Raskite klubo komandos ID ir lygos ID football-data.org sistemoje. Abiejuose rungtynių veiksmuose (Actions) pakeiskite komandos ID 57, pakeiskite skaitinį lygos filtrą ir turnyrinės lentelės URL, tada instrukcijose atnaujinkite klubo pavadinimą ir komandos ID. Išbandykite sistemą su jums žinomomis rungtynėmis.

Kaip gauti paskutines penkias rungtynes iš komandos perspektyvos?

Filtruokite pasibaigusias lygos rungtynes nurodytame datų intervale, surūšiuokite jas pagal rungtynių pradžios laiką nuo naujausių iki seniausių ir paimkite ne daugiau kaip penkerias. Prie kiekvieno rezultato, prieš priskirdami pergalę, lygiąsias ar pralaimėjimą, patikrinkite, ar jūsų komanda žaidė namuose, ar išvykoje. Jei atitinka mažiau nei penkerios rungtynės, nurodykite, kiek jų radote.

Ką reiškia tuščias rezultatas atidėtų rungtynių atveju?

Tuščias rezultatas reiškia, kad duomenų tiekėjas nepateikė įvarčių skaičiaus tai komandai. Palikite rungtynių būseną matomą, o rezultatą – nežinomą. Nulinėms lygiosioms reikalingos pasibaigusios rungtynės su dviem užfiksuotais nuliais.

Kaip konvertuoti futbolo rungtynių pradžios laiką į savo laiko juostą?

Pradėkite nuo rungtynių pradžios laiko UTC formatu, naudokite konkrečią laiko juostą, pavyzdžiui, America/New_York, ir atsakyme palikite datą. Vasaros laikas ir kalendorinės dienos pasikeitimas gali turėti įtakos rodomam laikui.

Quickchat AI Quickchat AI Ask Quickchat AI a question