Lag en fotballchatbot for terminliste, form og ligatabell

Piotr Grudzień
Publisert 9 min lesetid
Arsenals kampoversikt på tre linjer i Quickchat AI ved siden av Account Settings på football-data.org, der abonnementet er Free

Du planlegger lørdagen rundt Arsenals tur til Newcastle. En venn i New York trenger avsparkstiden. Så spør noen i gruppechatten hvordan Arsenal gjorde det på sin siste bortetur. Det første svaret ligger i en terminliste. For det andre må du vite hvem sitt mål 1-tallet i «Liverpool 0, Arsenal 1» tilhører.

Du skal bygge Matchday Notebook, en fotball-chatbot som slår opp de tre neste Premier League-kampene, leser av Arsenals fem siste ligaresultater og finner plasseringen deres på tabellen. Eksemplet er låst til 18. november 2026. Bortekampen mot Newcastle var satt til lørdag 21. november kl. 17:30 UTC, eller kl. 12:30 i New York.

Newcastle-kampen i Native Stats og det tilsvarende kampdagssvaret i Quickchat AI Leverandørens kampside og den private agenten er enige om avsparket. Quickchat AI-samtalen kjørte mot en datert avspilling av offentlige data, som du kan gjenskape nedenfor.

Sjekk Newcastle-kampen eller last ned Matchday Notebook-pakken. Pakk den ut og kjør python3 replay.py for å se de tre kampene, fem resultatene og tabellraden uten en konto. Den samme pakken inkluderer Action-innstillingene og Main Prompt for å koble til din egen feed.

1. Hvilken klubb og turnering skal chatboten følge?

Lås klubben og ligaen først. Arsenals ligaform kan endre seg avhengig av om du teller med en tirsdagskveld i Europa. I denne notatboken betyr Arsenal lag 57 og liga betyr Premier League 2021, også kjent under koden PL.

  1. Åpne registreringsskjemaet til football-data.org. Skriv inn fornavn og e-postadresse, godta vilkårene og velg Create account. Sjekk ligaen din på dekningslisten. Gratisplanen inkluderer Premier League, med forsinkede terminlister og resultater.

Registreringsskjemaet til football-data.org med felter for fornavn og e-post, knappen Create account og detaljer om Free Tier Bruk en e-postadresse du har tilgang til. football-data.org sender API-nøkkelen dit etter registrering. Gratisplanen har en øvre grense for antall forespørsler per minutt på 10.

Hvis du allerede har en konto, kan du logge inn med e-postadressen og API-tokenet ditt. Hvis du trenger en ny kopi av tokenet, kan du be om det på e-post med adressen du registrerte. Ta vare på tokenet til den beskyttede headeren i trinn 2.

Account Settings på football-data.org med abonnementet Free og et utdrag fra listen Available competitions Under Subscription ser du hvilket abonnement du har. Se etter ligaen din under Available competitions. Utsnittet viser UEFA Champions League (CL) og Bundesliga (BL1).

  1. For å følge en annen klubb, slå den opp i turneringens lagliste, for eksempel GET /v4/competitions/PL/teams. Bruk den returnerte lag-ID-en og turnerings-ID-en i kampforespørslene nedenfor. v4 hurtigstarten har begge oppslagene.
  2. Opprett en Quickchat AI-agent, gi den navnet Matchday Notebook, og hold den privat mens du tester. Du trenger tilgjengelige kreditter for samtaler og simuleringer. Åpne Identity → AI Persona → Main Prompt og lim inn instruksjonene nedenfor. Skjermbildene og de kopierbare innstillingene bruker engelsk.

Arsenals klubbside i Native Stats og Matchday Notebooks Identity-innstillinger i Quickchat AI Behold den samme klubben begge steder. I produktet ligger Agentens instruksjoner under Identity.

Kopier 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. Hvordan får du neste Arsenal-kamp?

Start med den Action som svarer på gruppechattens spørsmål om avspark. Én forespørsel returnerer begge klubbene, planlagt tidspunkt og kampstatus. La statusfilteret være åpent her, slik at en eventuell utsettelse fortsatt kan dukke opp. En TIMED-post har et avsparkstidspunkt. For SCHEDULED, fortell leseren at klokkeslettet ennå ikke er bekreftet.

  1. Åpne Actions & MCPs → Add Action → API Action → Create manually. Sett API Action Name til get_club_fixtures og When to run til AI decides. Under What to ask the user first, legg til de nødvendige Text-inndataene date_from og date_to, begge med No default. Beskrivelsene deres er «Første UTC-dato som skal inkluderes, YYYY-MM-DD» og «Første UTC-dato som skal ekskluderes, YYYY-MM-DD».
  2. For API Endpoint, velg GET og skriv inn URL-en nedenfor. Åpne Query Params og sett competitions til den bokstavelige 2021. Legg til dateFrom og dateTo. For hver verdi, bruk Add AI Data → Parameters for å sette inn den matchende datainndataen. La Body stå tom.
  3. Lim inn beskrivelsen nedenfor under API Action Description og lagre handlingen. Under Headers vil legitimasjonen legges inn i en skrivebeskyttet X-Auth-Token-rad. Sett dette opp før din første forespørsel. Legg til en andre, vanlig header med Accept som nøkkel og application/json som verdi. Bruk de samme to headere på alle tre handlingene.
https://api.football-data.org/v4/teams/57/matches

Ruten Team matches for football-data.org og GET-endepunktet i Quickchat AI med Query Params for turnering 2021 og to datoer Følg ruten for lagkamper fra leverandørreferansen inn i Action. Arsenal er fastsatt i URL-en, ligaen i Query Params, og de to datoene hentes fra samtalen.

Kopier beskrivelsen for kamp-Action.
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.

Leverandørens forespørselseksempler legger API-nøkkelen i X-Auth-Token. Bruk det samme headernavnet i Headers på get_club_fixtures.

Skjemaet Sign in for football-data.org, eksempelet på X-Auth-Token v4 og fanen Headers i Quickchat AI Innloggingsskjemaet ber om e-postadressen og API-tokenet ditt. I Quickchat AI er det bare tokenet som skal legges inn på den beskyttede X-Auth-Token-raden.

Skriv inn tokenet privat. Dashbordet kan erstatte en lagret hemmelighet. For å gjøre den headeren skrivebeskyttet i utgangspunktet, bruk kontotilkoblingen én gang per Action. Koble til kontoen din ved å bruke Quickchat AI-oppsettsguiden i ChatGPT eller Claude. Be den tilkoblede assistenten om å forberede headeren med en ufarlig markør ved å bruke instruksjonen nedenfor. Åpne deretter Actionens Headers-fane selv, erstatt verdien i samme rad med selve football-data.org-tokenet ditt, og velg Save changes. Åpne redigeringsprogrammet på nytt og sjekk at det viser [redacted]. Behold tokenet i dashbordet og utenfor samtalen.

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 i kamp-handlinga som viser X-Auth-Token med en sladdet verdi Dette er den lagrede headeren. Leverandøren forventer tokenet alene, uten et Bearer-prefiks.

Prøv det første datauthentinga. I Test Response → Test the API, oppgi en startdato og dagen etter den siste ønskede datoen. Aktiver deretter handlinga og spør i AI Preview etter de neste tre ligakampene i det tidsrommet. For et reelt oppsett, velg kommende datoer. Arkiveksempelet brukte 2026-11-18 og 2026-12-03, så kvelden 2. desember ble inkludert. Sjekk den nærmeste kampen ved å åpne kildelenken. V4-referansen for datofilter forklarer den eksklusive sluttdatoen.

Tre kampdatoer mellom den inkluderende starten 18. november og den eksklusive slutten 3. desember I dataeksempelet falt bortekampen mot Newcastle på 21. november, hjemmekampen mot Manchester City på 29. november og bortekampen mot Brentford på 2. desember. Hvis forespørselen hadde sluttet 2. desember, ville Brentford-kampen blitt utelatt.

3. Hvordan henter du ut de fem siste resultatene for Arsenal?

Den mest avslørende kampen i dette eksemplet endte Liverpool 0, Arsenal 1. Hvis chatboten behandler det første tallet som Arsenals resultat hver gang, forvandler den en borteseier til et tap. Behold hvert resultat i hjemme-borte-rekkefølge og bruk lag-ID-en til å avgjøre hvordan Arsenal gjorde det.

  1. Opprett en ny API Action med navnet get_recent_results. Bruk samme GET-endepunkt, datofelter, datobrikker og konkurransefilter. Legg til spørringsraden status med den bokstavelige verdien FINISHED.
  2. Angi beskrivelsen nedenfor. Gjenta oppsettet for den skrivebeskyttede headeren for get_recent_results, sjekk maskeringen og aktiver handlinga.
  3. Spør etter de fem siste ligakampene i et angitt tidsrom. For eksempelet, bruk 1. oktober til 17. november 2026. Sorter etter utcDate før du velger de fem. Hvis tidsrommet bare returnerer tre kamper, vis disse tre og tilby å søke lenger tilbake.
Kopier beskrivelsen for resultat-handlinga
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 på kildens kampside med Arsenals bortemål uthevet Finn først Arsenal på bortelagssiden, og les deretter av målet for bortelaget. Liverpools null betyr at de holdt nullen.

Les rekken med de nyeste først. Arsenal slo Hull 1–0, vant 1–0 borte mot Liverpool, slo Everton 2–0, vant 1–0 borte mot Nottingham Forest og slo Leeds 2–1. Det gir fem seire, sju scorede mål og ett innsluppet. Kampfakta for Liverpool-kampen er en god test fordi vinnerlaget står oppført som nummer to.

I de lagrede testdataene starter den returnerte listen bevisst med Leeds-kampen og slutter med Hull-kampen. Sortering etter avsparkstidspunkt flytter Hull til toppen av svaret. Åpne handlingssvaret ved siden av samtalen og sammenlign den første og siste kampen i begge listene.

Fem spilte Arsenal-kamper vist i datorekkefølge med resultat for hjemme- og bortelag Fem seire kan skjule en viktig detalj. To av disse var bortekamper, så vinnerresultatet står til høyre.

4. Hvor kommer plassering og poeng på tabellen fra?

Fem seire forteller deg hvordan de siste ukene har gått. Plasseringen på tabellen avhenger også av alle kampene før disse og resultatene til alle de andre lagene. Gi agenten en egen handling for tabellstatus.

  1. Gi den navnet get_league_standings. Velg GET, lim inn endepunktet nedenfor og la inndata, spørringsparametere og body være tomme. Bruk AI decides, legg til beskrivelsen nedenfor og gjenta oppsettet for skrivebeskyttet header for denne handlinga.
  2. I Test Response, se i standings etter oppføringen der type er TOTAL. Innenfor dens table, finn team.id lik 57. Aktiver handlinga og spør «Hvor ligger Arsenal på Premier League-tabellen?»
  3. Sammenlign position, playedGames og points med kilden for samme sesong og dato. Den 18. november viste Premier League-tabellen i Native Stats 1. plass, 10 spilte, 27 poeng. Din nåværende tabell vil endre seg etter hvert som andre klubber spiller.
https://api.football-data.org/v4/competitions/PL/standings
Kopier beskrivelsen for tabell-handlinga
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.

Arsenals førsteplassrad i Premier League-tabellen og feltene som brukes av notatboken Les over en enkelt rad i TOTAL. De 27 poengene dekker alle ti ligakampene i øyeblikksbildet.

5. Kan du spore kampdagsbriefingen tilbake til kildene?

Start en ny AI Preview-samtale. Spør etter de neste tre kampene, følg opp med «Hvordan gjorde vi det i de fem siste ligakampene?», oppgi tidsrommet for resultatene, og spør deretter «Hvor plasserer det oss på tabellen?» I Inbox, åpne markøren for den kalte handlinga for hvert svar. Handlingas View logs lar deg sammenligne parametrene og responsen med det supporteren så. Veiledningen for å bygge en API Action viser hvor du finner disse kontrollene.

For å få den kombinerte kampdagsoppsummeringen som vises i starten av artikkelen, still spørsmålet nedenfor med datoene fra det lagrede eksempelet. For en oppdatert oppsummering, bruk kommende datoer for kamper og nylige datoer for resultater.

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

Kallet til kamp-handlinga i Quickchat AI med forespørselen og returnerte kampfakta Inspiser datoene og kamp-ID-en i kallet. I det lokale dataeksempelet er 560651 kampen mot Newcastle.

For en repeterbar sjekk, åpne Conversations → Testing, opprett et datasett og lagre de tre spørsmålene. Legg til de to grensespørsmålene vist nedenfor. Kjør datasettet etter å ha endret en handlingsbeskrivelse og inspiser kallene sammen med svarene. Bruk en kontrollert respons for å utøve en sjelden status eller en feil. Et hypotetisk spørsmål alene tester bare ordlyden i et svar.

Matchday Notebook-datasettet i Quickchat AI som inneholder spørsmål om terminliste, form, tabell og grensetilfeller Bruk de samme spørsmålene etter hver redigering. Bortekampresultatet fanger opp en scoringsfeil som en test med bare hjemmekamper ville ha oversett.

TesttilfelleHva supporteren bør høre
En kamp er utsatt og begge målene er null. Ble det uavgjort?Kampen ble utsatt. Det er ikke registrert noe resultat.
Et vellykket søk returnerer en tom matches-liste. Er hele sesongen tom?Ingen kamper ble funnet i det tidsrommet. Oppgi datoene du søkte på.
Leverandøren returnerer 401 eller 403.Oppslaget mislyktes. Sjekk det lagrede tokenet og konkurransedekningen.
Leverandøren returnerer 429.Grensen for antall forespørsler er nådd. Vent og prøv igjen senere.

Svaret fra Quickchat AI når ingen kamper blir funnet, og den vellykkede forespørselen som ikke ga treff. Selv et tomt vindu er resultatet av en vellykket forespørsel. Assistenten kan tilby å utvide datoperioden.

For å dobbeltsjekke et endret avspark kan du sammenligne det med ligaens publiserte kampendringer. Noter deg kampdato, tidssone og datoen du sjekket informasjonen. Gratisfeeder kan ha forsinkelser sammenlignet med kringkasteren, noe som er viktig når noen planlegger lørdagen sin basert på svaret.

Fotballdata levert av Football-Data.org API. Football data provided by the Football-Data.org API. Det daterte eksempelet bruker leverandørens offentlige Native Stats-sider. Se dataplaner og grenser for antall forespørsler for gjeldende dekning og ferskhet.

Ofte stilte spørsmål

Hvilket fotball-API kan jeg bruke for en kamp-chatbot?

API-et football-data.org v4 leverer kamper, resultater og tabeller for dekningsområdene. Bruk endepunktet for lagets kamper for terminliste og nylig form, og endepunktet for turneringens tabell for ligaplassering.

Er football-data.org-resultater live på gratisplanen?

Gratisplanen inkluderer forsinkede resultater og terminlister, ligatabeller for dekningsområdene og en øvre grense på 10 API-kall per minutt. Inkluder kilde og dato i hvert svar, og sjekk planen din hvis du trenger liveresultater.

Hvordan endrer jeg Arsenal til et annet lag?

Finn klubbens lag-ID og turnering i football-data.org. Erstatt lag 57 i begge Actions, endre det numeriske turneringsfilteret og tabell-URL-en, og oppdater deretter klubbnavnet og lag-ID-en i instruksjonene. Test mot en kamp du kjenner igjen.

Hvordan får jeg de fem siste kampene fra lagets synspunkt?

Filtrer for ferdigspilte ligakamper i et angitt datovindu, sorter etter avspark fra nyeste til eldste og hent ut opptil fem. For hvert resultat, sjekk om laget ditt spilte hjemme eller borte før du registrerer seier, uavgjort eller tap. Hvis færre enn fem kamper er tilgjengelige, vis hvor mange du fant.

Hva betyr et blankt resultat for en utsatt kamp?

Et tomt resultat betyr at leverandøren ikke har oppgitt noe målantall for den siden. Hold kampstatusen synlig og la resultatet være ukjent. En målløs uavgjort krever en ferdigspilt kamp med to registrerte nuller.

Hvordan konverterer jeg et fotballavspark til min tidssone?

Start med kampens UTC-avspark, bruk en navngitt tidssone som America/New_York og behold datoen i svaret. Sommertid og et skifte av kalenderdag kan begge påvirke den viste tiden.

Quickchat AI Quickchat AI Ask Quickchat AI a question