Készíts focis chatbotot a meccsek, az eredmények és a tabella követésére

Piotr Grudzień
Megjelent 9 perc olvasás
Az Arsenal háromsoros meccsnapi tájékoztatója a Quickchat AI felületén, mellette a football-data.org Account Settings oldala, amely egy Free előfizetést mutat

A szombati programodat az Arsenal Newcastle elleni idegenbeli meccse köré szervezed. Egy New York-i barátodnak szüksége van a kezdési időpontra. Aztán valaki a csoportos csevegésben megkérdezi, hogyan szerepelt az Arsenal az utolsó idegenbeli meccsén. Az első válasz ott van egy meccsnaptárban. A másodikhoz tudnod kell, kié az 1-es a „Liverpool 0, Arsenal 1” eredményben.

Elkészíted a Matchday Notebook-t, egy foci chatbotot, amely megkeresi a következő három Premier League-mérkőzést, beolvassa az Arsenal utolsó öt bajnoki eredményét, és megkeresi a helyét a tabellán. A példa 2026. november 18-ra van rögzítve. A Newcastle elleni idegenbeli mérkőzés november 21-én, szombaton 17:30 UTC-kor, vagy New York-i idő szerint 12:30-kor lett volna.

A Newcastle elleni mérkőzés a Native Stats-ban és a megfelelő meccsnapi válasz a Quickchat AI-ben A szolgáltató meccs oldala és a privát Agent egyetértenek a kezdési időpontban. A Quickchat AI beszélgetés nyilvános adatok egy dátumozott visszajátszásán futott, amit alább reprodukálhatsz.

Ellenőrizd a Newcastle elleni mérkőzést vagy töltsd le a Matchday Notebook készletet. Csomagold ki, és futtasd a python3 replay.py parancsot, hogy fiók nélkül lásd a három mérkőzést, öt eredményt és a tabella sorát. Ugyanez a készlet tartalmazza az Action beállításait és a Main Prompt-t a saját adatfolyamod csatlakoztatásához.

1. Melyik klubot és bajnokságot fogja követni a chatbot?

Először rögzítsd a klubot és a bajnokságot. Az Arsenal bajnoki formája változhat attól függően, hogy beleszámítod-e az európai kedd estét. Ebben a jegyzetfüzetben az Arsenal az 57 csapatot jelenti, a bajnokság pedig a Premier League 2021-et, amely PL kódnéven is ismert.

  1. Nyisd meg a football-data.org regisztrációs űrlapot. Add meg a keresztnevedet és az e-mail címedet, fogadd el a feltételeket, majd válaszd a Create account gombot. Ellenőrizd a bajnokságodat a lefedettségi listán. Az ingyenes csomag tartalmazza a Premier League-et, késleltetett meccsnaptárakkal és eredményekkel.

A football-data.org regisztrációs űrlap a keresztnév és e-mail mezőkkel, a Create account gombbal és a Free Tier részleteivel Olyan e-mail címet használj, amelyet ellenőrizni tudsz. A football-data.org a regisztráció után oda küldi az API-kulcsot. Az ingyenes csomag percenként 10 kérést engedélyez.

Ha már van fiókod, jelentkezz be az e-mail címeddel és az API-tokeneddel. Ha szükséged van a token egy újabb másolatára, kérd el e-mailben a regisztrált címed használatával. Tartsd meg a tokent a 2. lépésben szereplő védett fejléc számára.

A football-data.org Account Settings oldala, amely a Free előfizetést és a Available competitions lista egy részét mutatja Ellenőrizd a csomagodat a Subscription alatt, és keresd meg a bajnokságodat az Available competitions alatt. Ez a kivonat az UEFA Bajnokok Ligáját (CL) és a Bundesligát (BL1) mutatja.

  1. Egy másik klub követéséhez keresd meg a bajnokság csapatlistájában, például GET /v4/competitions/PL/teams. Használd a visszaadott csapatazonosítót és bajnokságazonosítót az alábbi mérkőzéskérésekben. A v4 gyorsindító mindkét keresést tartalmazza.
  2. Hozz létre egy Quickchat AI Agentet, nevezd el Matchday Notebook-nek, és tartsd privátban, amíg teszteled. Szükséged van elérhető kreditekre a beszélgetésekhez és szimulációkhoz. Nyisd meg az Identity → AI Persona → Main Prompt menüpontot, és illeszd be az alábbi utasításokat. A képernyőképek és a másolható beállítások angol nyelvűek.

Az Arsenal kluboldala a Native Stats-ban és a Matchday Notebook Identity beállításai a Quickchat AI-ban Tartsd ugyanazt a klubot mindkét helyen. A termékben az ügynök utasításai a Identity alatt találhatók.

Másold a Matchday Notebook Main Prompt-t
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. Hogyan kapod meg az Arsenal következő mérkőzését?

Kezdd azzal az Actionnel, amelyik válaszol a csoportos csevegés kezdési időpontra vonatkozó kérdésére. Egy kérés visszaadja mindkét klubot, a tervezett időpontot és a mérkőzés állapotát. Itt hagyd nyitva az állapotszűrőt, hogy egy esetleges halasztás is megjelenhessen. Egy TIMED rekordnak van kezdési időpontja. A SCHEDULED esetében jelezd az olvasónak, hogy az időpont még megerősítésre vár.

  1. Nyisd meg az Actions & MCPs → Add Action → API Action → Create manually menüpontot. Állítsd be az API Action Name-t get_club_fixtures-re és az When to run-t AI decides-re. Az What to ask the user first alatt add hozzá a szükséges Text bemeneteket, date_from és date_to, mindkettőt No default-vel. A leírásuk: „Első UTC dátum (beleértve), YYYY-MM-DD” és „Első UTC dátum (kizárva), YYYY-MM-DD”.
  2. Az API Endpoint-hoz válaszd a GET-t, és add meg az alábbi URL-t. Nyisd meg a Query Params-t, és állítsd be a competitions-at a literális 2021-re. Add hozzá a dateFrom és dateTo paramétereket. Mindegyik értékhez használd az Add AI Data → Parameters opciót a megfelelő dátum bemenet beszúrásához. Hagyd üresen a Body-t.
  3. Illessze be az alábbi leírást az API Action Description alá, majd mentse az Actiont. Az Headers alatt a hitelesítő adat egy csak írható X-Auth-Token sorba kerül. Ezt az első kérés előtt állítsa be. Adjon hozzá egy második, szokásos fejlécet Accept kulccsal és application/json értékkel. Ugyanezt a két fejlécet használja mindhárom Actionhöz.
https://api.football-data.org/v4/teams/57/matches

A football-data.org Team matches útvonal és a Quickchat AI GET végpont Query Params-mal a 2021-es bajnoksághoz és két dátumhoz Kövesd a szolgáltató referenciájából a csapatmérkőzések útvonalát a műveletbe. Az Arsenal rögzítve van az URL-ben, a bajnokság a Query Params alatt, a két dátum pedig a beszélgetésből származik.

Másold a mérkőzés Action leírását
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.

A szolgáltató kérésmintái az API-kulcsot az X-Auth-Token fejlécbe teszik. Ugyanezt a fejlécnevet használd a Headers alatt a get_club_fixtures műveletben.

A nyilvános football-data.org Sign in űrlap, a v4 X-Auth-Token példa és a Headers fül a Quickchat AI-ban A bejelentkezési űrlap az e-mail címedet és az API-tokenedet kéri. A Quickchat AI rendszerében csak a token kerül a védett X-Auth-Token sorba.

Add meg a tokent privát módon. A vezérlőpult felülírhat egy mentett titkos kulcsot. Ahhoz, hogy ez a fejléc eleve csak írható legyen, műveletenként egyszer használd a fiókkapcsolatot. Csatlakoztasd a fiókodat a Quickchat AI beállítási útmutató segítségével a ChatGPT vagy a Claude felületén. Kérd meg a csatlakoztatott asszisztenst, hogy az alábbi utasítás alapján készítse elő a fejlécet egy ártalmatlan jelölővel. Ezután nyisd meg a művelet Headers fülét, cseréld ki az értéket ugyanabban a sorban a nyers football-data.org tokenedre, és válaszd a Save changes lehetőséget. Nyisd meg újra a szerkesztőt, és ellenőrizd, hogy a [redacted] felirat jelenik-e meg. A tokent a vezérlőpulton tárold, ne a beszélgetésben.

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 a mérkőzés Actionben, ami X-Auth-Token-et mutat, szerkesztett értékkel Ez a mentett fejléc. A szolgáltató a tokent önmagában várja, Bearer előtag nélkül.

Próbáld ki az első lekérdezést. A Test Response → Test the API menüpontban adj meg egy kezdő dátumot és az utolsó kívánt dátum utáni napot. Ezután engedélyezd a műveletet, és az AI Preview felületen kérd le a következő három bajnoki mérkőzést az adott időszakban. Éles használathoz válassz közelgő dátumokat. Az archív példa a 2026-11-18 és 2026-12-03 dátumokat használta, így december 2. estéje is beleszámított. Ellenőrizd a legközelebbi mérkőzést a forráslink megnyitásával. A v4 dátumszűrő dokumentációja magyarázza el, hogy a záró dátum miért exkluzív.

Három mérkőzés időpontja a november 18-i (inkluzív) kezdő és a december 3-i (exkluzív) záró dátum között A szimulációban a Newcastle elleni idegenbeli meccs november 21-re, a Manchester City elleni hazai november 29-re, a Brentford elleni idegenbeli pedig december 2-ra esett. Ha a lekérdezés záró dátuma december 2. lett volna, a Brentford kimaradt volna.

3. Hogyan olvasd ki az utolsó öt eredményt az Arsenal szemszögéből?

A legbeszédesebb mérkőzés ebben a példában Liverpool 0, Arsenal 1 eredménnyel zárult. Ha a chatbot minden alkalommal az első számot tekinti az Arsenal eredményének, akkor egy idegenbeli győzelmet vereséggé változtat. Tartsd meg minden eredményt hazai-idegenbeli sorrendben, és használd a csapatazonosítót annak eldöntésére, hogy az Arsenal hogyan szerepelt.

  1. Hozz létre egy második API Action műveletet get_recent_results néven. Használd ugyanazt a GET végpontot, dátum bemeneteket, dátum jelölőket és bajnokságszűrőt. Add hozzá a status lekérdezési sort a FINISHED literális értékkel.
  2. Állítsd be az alábbi leírást. Ismételd meg a csak írható fejléc beállítását a get_recent_results művelethez, ellenőrizd a maszkolást, és engedélyezd a műveletet.
  3. Kérd le az öt legutóbbi bajnoki mérkőzést egy megadott időszakban. A példához használd a 2026. október 1. és november 17. közötti időszakot. Mielőtt kiválasztanád az ötöt, rendezd őket utcDate szerint. Ha az időszak csak három találatot ad, mutasd meg azt a hármat, és ajánld fel a további keresést.
Az eredmények művelet leírásának másolása
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 a forrásoldalon, kiemelve az Arsenal idegenbeli gólját Először keresd meg az Arsenalt az idegenbeli csapatok között, majd olvasd le az idegenben lőtt gólt. A Liverpool nullája a lehozott kapott gól nélküli meccs.

A legújabb eredményeket olvasd először. Az Arsenal 1–0-ra verte a Hullt, 1–0-ra nyert a Liverpool otthonában, 2–0-ra verte az Evertont, 1–0-ra nyert a Nottingham Forest otthonában és 2–1-re verte a Leedset. Ez öt győzelem, hét lőtt és egy kapott gól. A Liverpool elleni meccs adatlapja jó teszt, mert a győztes csapat a második helyen szerepel.

A mentett tesztadatokban a visszaadott lista szándékosan a Leeds-mérkőzéssel kezdődik és a Hull-mérkőzéssel végződik. A kezdési időpont szerinti rendezés után a Hull kerül a válasz elejére. Nyissa meg az Action-választ a csevegés mellett, és hasonlítsa össze az első és az utolsó mérkőzést mindkét listában.

Öt befejezett Arsenal-mérkőzés dátum szerinti sorrendben, hazai és idegenbeli eredményekkel Öt győzelem fontos részleteket rejthet. Ezek közül kettő idegenben volt, így a győztes szám a jobb oldalon van.

4. Honnan származik a bajnoki helyezés és a pontszám?

Öt győzelem megmutatja, hogyan alakult az elmúlt néhány hét. A bajnoki helyezés azonban az összes korábbi mérkőzéstől és mindenki más eredményétől is függ. Adj az ügynöknek egy külön műveletet a tabellához.

  1. Nevezd el get_league_standings-nek. Válaszd a GET metódust, illeszd be az alábbi végpontot, és hagyd üresen a bemeneteket, a lekérdezési paramétereket és a törzset. Használd az AI decides beállítást, add hozzá az alábbi leírást, és ismételd meg a csak írható fejléc beállítását ehhez a művelethez.
  2. A Test Response felületen keresd meg a standings listában azt a bejegyzést, amelynek type értéke TOTAL. Annak table részén belül keresd meg azt, ahol az team.id értéke 57. Engedélyezd a műveletet, és tedd fel a kérdést „Hol áll az Arsenal a Premier League tabelláján?”
  3. Hasonlítsd össze a position, playedGames és points értékeket az azonos szezonra és dátumra vonatkozó forrással. November 18-án a Premier League tabella a Native Stats oldalán ezeket az adatokat mutatta az Arsenalról 1. hely, 10 lejátszott meccs, 27 pont. Az aktuális tabella változni fog, ahogy más klubok is játszanak.
https://api.football-data.org/v4/competitions/PL/standings
A tabella művelet leírásának másolása
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.

Az Arsenal első helyét jelző sor a Premier League tabelláján és a jegyzetfüzet által használt mezők Olvass el egyetlen sort a TOTAL-ban. A 27 pont a pillanatfelvétel összes tíz bajnoki mérkőzését lefedi.

5. Vissza tudod követni a meccsnapi összefoglalót a forrásaihoz?

Kezdj egy új beszélgetést az AI Preview felületen. Kérdezd le a következő három meccset, majd folytasd azzal, hogy „Hogy teljesítettünk az utolsó öt bajnoki meccsünkön?”, add meg az időszakot, majd tedd fel a kérdést „Ez alapján hol állunk a tabellán?” Az Inbox nézetben nyisd meg az egyes válaszokhoz tartozó művelethívás-jelölőt. A művelet View logs funkciója lehetővé teszi, hogy összehasonlítsd a paramétereket és a választ azzal, amit a szurkoló látott. Az API Action készítéséről szóló útmutató megmutatja, hol találod ezeket a vezérlőket.

A cikk elején látható összesített meccsnapi összefoglaló elkészítéséhez tegye fel az alábbi kérdést a mentett példa dátumaival. Naprakész összefoglalóért használjon közelgő dátumokat a meccsnaptárhoz és korábbi dátumokat az eredményekhez.

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

A meccsnaptár művelet hívása a Quickchat AI felületén, a kéréssel és a visszaadott meccs adatlappal Vizsgáld meg a dátumokat és a meccsazonosítót a hívásban. A helyi szimulációban az 560651 a Newcastle elleni mérkőzés.

Az ismételhető ellenőrzéshez nyisd meg a Conversations → Testing menüpontot, hozz létre egy adatkészletet, és mentsd el a három kérdést. Add hozzá az alább látható két peremfeltételt vizsgáló kérdést. Futtasd le az adatkészletet egy művelet leírásának módosítása után, és vizsgáld meg a hívásokat a válaszokkal együtt. Használj egy vezérelt választ egy ritka állapot vagy hiba tesztelésére. Egy hipotetikus kérdés önmagában csak a válasz megfogalmazását teszteli.

A Matchday Notebook adatkészlet a Quickchat AI felületén, amely meccsnaptárra, formára, tabellára és peremfeltételekre vonatkozó kérdéseket tartalmaz Használd ugyanazokat a kérdéseket minden szerkesztés után. Az idegenbeli eredmény elkap egy pontozási hibát, amelyet egy csak hazai teszt kihagyna.

TesztesetMit kellene a szurkolónak hallania
Egy mérkőzést elhalasztanak, és mindkét gól null. Döntetlen volt?A mérkőzést elhalasztották. Nincs rögzített eredmény.
Egy sikeres keresés üres matches listát ad vissza. Az egész szezon üres?Nem található mérkőzés a megadott időszakban. Add meg a keresett dátumokat.
A szolgáltató 401-et vagy 403-at ad vissza.A lekérdezés sikertelen volt. Ellenőrizd a mentett tokent és a bajnokság lefedettségét.
A szolgáltató 429-et ad vissza.Elérted a kérések engedélyezett számát. Várj egy kicsit, és próbáld újra később.

A Quickchat AI üres ablakban adott válasza, amikor a sikeres kérés nem hozott egyetlen találatot sem Az üres ablak is sikeres kérést jelez. Az asszisztens felajánlhatja a dátumtartomány kibővítését.

Ha egy megváltozott kezdési időpontot ellenőriznél, hasonlítsd össze a liga által közzétett meccsnaptár-módosításokkal. Jegyezd fel a tervezett dátumot, az időzónát és a lekérdezés dátumát is. Az ingyenes adatforrás késhet a közvetítési időpont változásához képest, ami fontos szempont, ha valaki a kapott válasz alapján tervezi a szombatját.

Football data provided by the Football-Data.org API. A bemutatott példa a szolgáltató nyilvános Native Stats oldalait használja. Az aktuális lefedettségről és frissítési gyakoriságról az adatcsomagok és a használati korlátok oldalon tájékozódhatsz.

Gyakran ismételt kérdések

Melyik foci API-t használhatom egy meccsnaptár chatbothoz?

A football-data.org v4 API meccsnaptárakat, eredményeket és tabellákat biztosít a lefedett bajnokságokhoz. Használd a csapat mérkőzéseinek végpontját a meccsnaptárhoz és a friss formához, a bajnokság tabellájának végpontját pedig a bajnoki helyezéshez.

Élőben vannak a football-data.org eredmények az ingyenes csomagban?

Az ingyenes csomag késleltetett eredményeket és meccsnaptárakat, a lefedett bajnokságokhoz tabellákat, valamint percenként 10 API-hívást tartalmaz. Minden válaszhoz add meg a forrást és a dátumot, és ellenőrizd a csomagodat, ha élő eredményekre van szükséged.

Hogyan változtathatom meg az Arsenalt egy másik csapatra?

Keresd meg a klub csapatazonosítóját és bajnokságát a football-data.org-ban. Cseréld le az 57-es csapatot mindkét Actionben, változtasd meg a numerikus bajnokságszűrőt és a tabella URL-jét, majd frissítsd a klub nevét és csapatazonosítóját az utasításokban. Teszteld egy általad is ismert mérkőzéssel.

Hogyan kaphatom meg az utolsó öt mérkőzést a csapat szemszögéből?

Szűrj a befejezett bajnoki mérkőzésekre egy megadott dátumtartományban, rendezd őket kezdési időpont szerint a legújabbtól a legrégebbiig, és vegyél legfeljebb ötöt. Minden eredménynél ellenőrizd, hogy a csapatod otthon vagy idegenben játszott-e, mielőtt győzelmet, döntetlent vagy vereséget rögzítenél. Ha ötnél kevesebbnek felel meg, mutasd meg, hányat találtál.

Mit jelent az üres eredmény egy elhalasztott mérkőzésnél?

Az üres eredmény azt jelenti, hogy a szolgáltató nem adott meg gólszámot az adott oldalra. Tartsd láthatóan a mérkőzés állapotát, és hagyd ismeretlenül az eredményt. Egy gól nélküli döntetlenhez befejezett mérkőzés szükséges, két rögzített nullával.

Hogyan konvertálhatom egy focimeccs kezdési időpontját a saját időzónámra?

Kezdd a mérkőzés UTC kezdési időpontjával, használj egy elnevezett időzónát, például America/New_York, és tartsd meg a dátumot a válaszban. A nyári időszámítás és a naptári nap változása is befolyásolhatja a megjelenített időt.

Quickchat AI Quickchat AI Ask Quickchat AI a question