Du planlægger din lørdag ud fra Arsenals udekamp mod Newcastle. En ven i New York skal bruge tidspunktet for kampstart. Så spørger en i gruppechatten, hvordan det gik Arsenal i deres seneste udekamp. Det første svar findes i et kampprogram. For det andet svar skal du vide, hvem der scorede målet til 1-0 i
Du skal bygge Matchday Notebook, en fodboldchatbot, der slår de næste tre Premier League-kampe op, læser Arsenals seneste fem resultater i ligaen og finder deres placering i tabellen. Eksemplet er låst til 18. november 2026. Udekampen mod Newcastle var sat til lørdag den 21. november kl. 17:30 UTC, eller kl. 12:30 i New York.
Udbyderens kampside og den private Agent er enige om kampstart. Quickchat AI-samtalen kørte mod en dateret data-replay af offentlige data, som du kan genskabe nedenfor.
Tjek Newcastle-kampen, eller download Matchday Notebook-sættet. Pak det ud, og kør python3 replay.py for at se de tre kampe, fem resultater og rækken i tabellen uden en konto. Det samme sæt inkluderer Action-indstillingerne og Main Prompt til at forbinde dit eget feed.
1. Hvilken klub og turnering skal chatbotten følge?
Lås klubben og ligaen fast først. Arsenals form i ligaen kan ændre sig, alt efter om du tæller en tirsdag aften i Europa med. I denne notesbog betyder Arsenal hold 57, og ligaen betyder Premier League 2021, også kendt under koden PL.
- Åbn tilmeldingsformularen hos football-data.org. Indtast dit fornavn og din e-mailadresse, acceptér betingelserne, og vælg Create account. Tjek din liga på dækningslisten. Den gratis plan inkluderer Premier League med forsinkede kampprogrammer og resultater.
Brug en e-mailadresse, du har adgang til. football-data.org sender API-nøglen dertil efter tilmelding. Den gratis plan tillader højst ti API-kald i minuttet.
Hvis du allerede har en konto, kan du logge ind med din e-mail og dit API-token. Hvis du har brug for en ny kopi af dit token, kan du anmode om det via e-mail med den adresse, du brugte til tilmelding. Gem dit token til det beskyttede header-felt i trin 2.
Tjek dit abonnement under Subscription, og find din liga under Available competitions. Dette uddrag viser UEFA Champions League (CL) og Bundesliga (BL1).
- For at følge en anden klub skal du slå den op i turneringens holdliste, f.eks.
GET /v4/competitions/PL/teams. Brug det returnerede hold-ID og turnerings-ID i kampanmodningerne nedenfor. v4 quickstart har begge opslag. - Opret en Quickchat AI Agent, navngiv den Matchday Notebook, og hold den privat, mens du tester. Du skal have tilgængelige kreditter til samtaler og simuleringer. Åbn Identity → AI Persona → Main Prompt, og indsæt instruktionerne nedenfor. Skærmbillederne og de kopierbare indstillinger bruger engelsk.
Behold den samme klub begge steder. I produktet findes Agentens instruktioner under Identity.
Kopiér 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 finder du den næste Arsenal-kamp?
Start med den Action, der besvarer gruppechattens spørgsmål om kampstart. Ét kald returnerer begge klubber, det planlagte tidspunkt og kampens status. Lad statusfilteret være åbent her, så en udsættelse stadig kan dukke op. En TIMED-post har et tidspunkt for kampstart. For SCHEDULED skal du fortælle læseren, at tidspunktet endnu ikke er bekræftet.
- Åbn Actions & MCPs → Add Action → API Action → Create manually. Sæt API Action Name til
get_club_fixturesog When to run til AI decides. Under What to ask the user first skal du tilføje de påkrævede Text-inputdate_fromogdate_to, begge med No default. Deres beskrivelser er “Første UTC-dato, der skal inkluderes, YYYY-MM-DD” og “Første UTC-dato, der skal ekskluderes, YYYY-MM-DD”. - For API Endpoint skal du vælge GET og indtaste URL’en nedenfor. Åbn Query Params og sæt
competitionstil den bogstavelige2021. TilføjdateFromogdateTo. For hver værdi skal du bruge Add AI Data → Parameters til at indsætte det matchende datoinput. Lad Body være tom. - Indsæt beskrivelsen herunder under API Action Description og gem handlingen. Under Headers vil legitimationsoplysningerne komme i en skrivebeskyttet
X-Auth-Token-række. Opsæt dette før din første anmodning. Tilføj en anden, almindelig header medAcceptsom nøgle ogapplication/jsonsom værdi. Brug de samme to headers på alle tre handlinger.
https://api.football-data.org/v4/teams/57/matches
Følg ruten for holdkampe fra udbyderreferencen ind i handlingen. Arsenal er fastsat i URL’en, ligaen i Query Params, og de to datoer kommer fra samtalen.
Kopiér beskrivelsen til kamp-Actionen
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.
I udbyderens anmodningseksempler placeres API-nøglen i X-Auth-Token. Brug det samme header-navn i Headers på get_club_fixtures.
Log ind-formularen bruger din e-mail og dit API-token. I Quickchat AI er det kun dit token, der skal indtastes i den beskyttede X-Auth-Token-række.
Indtast tokenet privat. Dashboardet kan erstatte en gemt hemmelighed. For at gøre den header skrivebeskyttet i første omgang skal du bruge kontoforbindelsen én gang pr. handling. Forbind din konto ved hjælp af Quickchat AI opsætningsguiden i ChatGPT eller Claude. Bed den forbundne assistent om at forberede headeren med en harmløs markør ved hjælp af instruktionen nedenfor. Åbn derefter selv handlingens Headers-fane, erstat værdien i samme række med dit rå football-data.org-token, og vælg Save changes. Genåbn editoren og tjek, at den viser [redacted]. Hold tokenet i dashboardet og ude af 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.
Dette er den gemte header. Udbyderen forventer tokenet alene, uden et Bearer-præfiks.
Prøv den første læsning. I Test Response → Test the API skal du angive en startdato og dagen efter din sidste ønskede dato. Aktivér derefter handlingen og spørg i AI Preview efter de næste tre ligakampe i det vindue. For en live-opbygning skal du vælge kommende datoer. Arkiveksemplet brugte 2026-11-18 og 2026-12-03, så aftenen den 2. december talte med. Tjek den nærmeste kamp ved at åbne dens kildelink. v4 dato-filterreferencen forklarer den eksklusive slutdato.
I dataeksemplet faldt udekampen mod Newcastle den 21. november, hjemmekampen mod Manchester City den 29. november og udekampen mod Brentford den 2. december. Hvis anmodningen var sluttet den 2. december, ville Brentford-kampen ikke være kommet med.
3. Hvordan aflæser du de seneste fem resultater for Arsenal?
Den mest afslørende kamp i dette eksempel endte Liverpool 0, Arsenal 1. Hvis chatrobotten behandler det første tal som Arsenals score hver gang, forvandler den en udesejr til et nederlag. Hold hver score i hjemme-ude-rækkefølge og brug hold-ID’et til at afgøre, hvordan Arsenal klarede sig.
- Opret endnu en API Action med navnet
get_recent_results. Brug det samme GET-endepunkt, datoinput, datochips og turneringsfilter. Tilføj forespørgselsrækkenstatusmed den bogstavelige værdiFINISHED. - Indstil beskrivelsen nedenfor. Gentag opsætningen af den skrivebeskyttede header for
get_recent_results, tjek masken og aktiver handlingen. - Bed om de fem seneste ligakampe i et angivet vindue. For eksemplet skal du bruge 1. oktober til 17. november 2026. Sorter efter
utcDate, før du tager fem. Hvis vinduet kun returnerer tre, skal du vise disse tre og tilbyde at kigge længere tilbage.
Kopiér beskrivelsen af resultathandlingen
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.
Find først Arsenal på udeholdet, og aflæs derefter udeholdets mål. Liverpools nul er et clean sheet.
Læs rækken med de nyeste først. Arsenal slog Hull 1-0, vandt 1-0 på udebane mod Liverpool, slog Everton 2-0, vandt 1-0 på udebane mod Nottingham Forest og slog Leeds 2-1. Det giver fem sejre, syv mål for og ét imod. Liverpool-kamprapporten er en god test, fordi det vindende hold står som nummer to.
I de gemte testdata starter den returnerede liste bevidst med Leeds-kampen og slutter med Hull-kampen. Sortering efter kampstartstidspunkt flytter Hull op øverst i svaret. Åbn handlingssvaret ved siden af chatten, og sammenlign den første og sidste kamp på begge lister.
Fem sejre kan skjule en vigtig detalje. To af disse var udekampe, så det vindende tal står til højre.
4. Hvor kommer placering og point i ligaen fra?
Fem sejre fortæller dig, hvordan de seneste par uger er gået. Placeringen i ligaen afhænger også af alle kampene før dem og alle de andre holds resultater. Giv agenten en separat handling til stillingen.
- Navngiv den
get_league_standings. Vælg GET, indsæt slutpunktet nedenfor, og lad input, forespørgselsparametre og body være tomme. Brug AI decides, tilføj beskrivelsen nedenfor, og gentag den skrivebeskyttede header-opsætning for denne handling. - I Test Response skal du i
standingslede efter den post, hvistypeerTOTAL. Inden for denstableskal du findeteam.idlig med57. Aktivér handlingen, og stil spørgsmålet “Hvor ligger Arsenal i Premier League-tabellen?” - Sammenlign
position,playedGamesogpointsmed kilden for samme sæson og dato. Den 18. november viste Premier League-stillingen i Native Stats 1. plads, 10 kampe spillet, 27 point. Den aktuelle stilling vil ændre sig, efterhånden som andre klubber spiller.
https://api.football-data.org/v4/competitions/PL/standings
Kopiér beskrivelsen af handlingen for stillingen
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.
Læs på tværs af en enkelt række i TOTAL. De 27 point dækker alle ti ligakampe i øjebliksbilledet.
5. Kan du spore kampdagsbriefingen tilbage til dens kilder?
Start en ny AI Preview-samtale. Spørg efter de næste tre kampe, følg op med “Hvordan klarede vi os i vores seneste fem ligakampe?”, angiv resultatvinduet, og spørg derefter “Hvor efterlader det os i tabellen?” I Inbox skal du åbne markøren for den kaldte handling for hvert svar. Handlingens View logs lader dig sammenligne parametrene og svaret med det, supporteren så. Vejledningen til at bygge en API Action viser, hvor du finder disse funktioner.
For at få den samlede kampdagsoversigt, der vises i starten af artiklen, skal du stille spørgsmålet nedenfor med datoerne fra det gemte eksempel. For en opdateret oversigt skal du bruge kommende datoer for kampprogrammet og seneste 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.
Inspicér datoer og kamp-ID i kaldet. I det lokale dataeksempel er 560651 kampen mod Newcastle.
For en gentagelig kontrol skal du åbne Conversations → Testing, oprette et datasæt og gemme de tre spørgsmål. Tilføj de to grænsespørgsmål, der er vist nedenfor. Kør datasættet efter at have ændret en handlingsbeskrivelse og inspicér kaldene sammen med svarene. Brug et kontrolleret svar til at udøve en sjælden status eller en fejl. Et hypotetisk spørgsmål alene tester formuleringen af et svar.
Brug de samme spørgsmål efter hver redigering. Uderesultatet fanger en scoringsfejl, som en test med kun hjemmekampe ville overse.
| Testtilfælde | Hvad supporteren skal høre |
|---|---|
En kamp er udsat, og begge mål er null. Var det uafgjort? | Kampen blev udsat. Der er ingen registreret score. |
En vellykket søgning returnerer en tom matches-liste. Er hele sæsonen tom? | Der blev ikke returneret nogen kampe i det tidsrum. Angiv de datoer, du søgte i. |
| Udbyderen returnerer 401 eller 403. | Opslaget mislykkedes. Kontrollér det gemte token og dækningen af konkurrencen. |
| Udbyderen returnerer 429. | Anmodningsgrænsen blev nået. Stop og prøv igen senere. |
Et tomt datovindue resulterer stadig i en vellykket forespørgsel. Assistenten kan tilbyde at udvide datoperioden.
Hvis du vil have en anden kilde på et ændret kampstartstidspunkt, kan du sammenligne med ligaens offentliggjorte kampændringer. Notér den planlagte dato, tidszonen og datoen, hvor du slog det op. Det gratis feed kan være forsinket i forhold til en ændring i sendeplanen, hvilket er vigtigt, når nogen planlægger deres lørdag ud fra svaret.
Fodbolddata leveres af Football-Data.org API. Football data provided by the Football-Data.org API. Det daterede eksempel bruger udbyderens offentlige Native Stats-sider. Se dataplaner og API-kaldsgrænser for aktuel dækning og opdateringsfrekvens.
Ofte stillede spørgsmål
Hvilket fodbold-API kan jeg bruge til en kampprogram-chatbot?
football-data.org’s v4-API leverer kampprogrammer, resultater og stillinger for de dækkede turneringer. Brug holdets kampe-endpoint til kampprogrammet og holdets seneste resultater og turneringens stillinger-endpoint til placeringen i ligaen.
Er football-data.org resultater live på den gratis plan?
Den gratis plan inkluderer forsinkede resultater og kampprogrammer, stillinger i ligaen for de dækkede turneringer og højst ti API-kald i minuttet. Inkluder kilde og dato med hvert svar, og tjek din plan, hvis du har brug for liveresultater.
Hvordan ændrer jeg Arsenal til et andet hold?
Find klubbens hold-ID og turnering i football-data.org. Erstat hold 57 i begge Actions, skift det numeriske turneringsfilter og stillings-URL’en, og opdater derefter klubnavnet og hold-ID’et i instruktionerne. Test op mod en kamp, du kender.
Hvordan får jeg de seneste fem kampe fra holdets synspunkt?
Filtrer efter afsluttede ligakampe i et angivet datointerval, sorter efter kickoff fra nyeste til ældste, og tag op til fem. For hvert resultat skal du tjekke, om dit hold spillede hjemme eller ude, før du tildeler en sejr, uafgjort eller et tab. Hvis færre end fem kvalificerer sig, skal du vise, hvor mange du fandt.
Hvad betyder et blankt resultat for en udsat kamp?
Et blankt resultat betyder, at udbyderen ikke har angivet et samlet antal mål for den side. Hold kampstatus synlig og lad resultatet være ukendt. En målløs uafgjort kræver en afsluttet kamp med to registrerede nuller.
Hvordan konverterer jeg et fodbold-kickoff til min tidszone?
Start med kampens UTC kickoff, brug en navngiven tidszone som America/New_York, og behold datoen i svaret. Sommertid og et skift af kalenderdag kan begge påvirke den viste tid.