Как да създадете футболен чатбот за мачове, резултати и класиране

Piotr Grudzień
Публикувано 9 мин четене
Кратък обзор на мача на Арсенал в Quickchat AI, заедно с настройките на акаунта в football-data.org Account Settings, показващи абонамент Free

Планирате си съботата около гостуването на Арсенал на Нюкасъл. Приятел в Ню Йорк иска да знае началния час. После някой в груповия чат пита как се е представил Арсенал при последното си гостуване. Отговорът на първия въпрос се намира в програмата с мачове. За втория трябва да знаете чий е голът в резултата „Ливърпул 0, Арсенал 1“.

Ще създадете Matchday Notebook – футболен чатбот, който проверява следващите три мача от Висшата лига, показва последните пет резултата на Арсенал в лигата и намира мястото им в класирането. Примерът е с дата 18 ноември 2026 г. Гостуването на Нюкасъл е било насрочено за събота, 21 ноември, в 17:30 ч. UTC, или 12:30 ч. следобед в Ню Йорк.

Мачът с Нюкасъл в Native Stats и съответният отговор за мача в Quickchat AI Страницата на доставчика за мача и частният Agent са единодушни за началния час. Разговорът в Quickchat AI е проведен със симулация на базата на архивни публични данни, която можете да възпроизведете по-долу.

Проверете мача с Нюкасъл или изтеглете пакета Matchday Notebook. Разархивирайте го и изпълнете python3 replay.py, за да видите трите мача, петте резултата и реда от класирането, без да е нужен акаунт. Същият пакет включва настройките на Action и Main Prompt за свързване на Ваша собствена емисия с данни.

1. Кой клуб и състезание ще следи чатботът?

Първо задайте клуба и лигата. Формата на Арсенал в лигата може да се промени в зависимост от това дали броите мач от европейските турнири във вторник вечер. В този бележник Арсенал означава отбор 57, а лига означава Висша лига 2021, известна още с кода си PL.

  1. Отворете формуляра за регистрация в football-data.org. Въведете Вашето име и имейл адрес, приемете условията и изберете Create account. Проверете Вашето първенство в списъка с покритие. Безплатният план включва Висшата лига, с програми и резултати със закъснение.

Формулярът за регистрация в football-data.org с полета за име и имейл, бутон Create account и подробности за Free Tier Използвайте имейл адрес, който можете да проверите. football-data.org изпраща API ключа там след регистрацията. Безплатният план позволява 10 заявки в минута.

Ако вече имате акаунт, влезте с Вашия имейл и API токен. Ако Ви е необходимо друго копие на токена, поискайте го по имейл, като използвате адреса, с който сте се регистрирали. Запазете токена за защитения хедър в Стъпка 2.

Страницата Account Settings в football-data.org, показваща абонамент Free и част от списъка Available competitions Проверете Вашия план в Subscription и потърсете Вашето първенство в Available competitions. Този откъс показва Шампионската лига на УЕФА (CL) и Бундеслигата (BL1).

  1. За да следите друг клуб, потърсете го в списъка с отбори на първенството, например GET /v4/competitions/PL/teams. Използвайте върнатите ID на отбора и ID на първенството в заявките за мачове по-долу. Ръководството за бърз старт на v4 съдържа и двете търсения.
  2. Създайте Quickchat AI агент, наречете го Matchday Notebook и го запазете частен, докато тествате. Нуждаете се от налични кредити за разговори и симулации. Отворете Identity → AI Persona → Main Prompt и поставете инструкциите по-долу. Екранните снимки и настройките за копиране използват английски език.

Клубната страница на Арсенал в Native Stats и настройките за Identity на Matchday Notebook в Quickchat AI Запазете същия клуб и на двете места. В продукта инструкциите на агента се намират под Identity.

Копирайте 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. Как да получите информация за следващия мач на Арсенал?

Започнете с Action, която отговаря на въпроса за началния час от груповия чат. Една заявка връща и двата клуба, насрочения час и статуса на мача. Оставете филтъра за статус отворен, за да може да се покаже и евентуално отлагане. Запис със статус TIMED има начален час. За SCHEDULED кажете на потребителя, че часът все още не е потвърден.

  1. Отворете Actions & MCPs → Add Action → API Action → Create manually. Задайте API Action Name на get_club_fixtures и When to run на AI decides. Под What to ask the user first добавете необходимите Text входове date_from и date_to, и двата с No default. Техните описания са „Първа UTC дата за включване, YYYY-MM-DD“ и „Първа UTC дата за изключване, YYYY-MM-DD“.
  2. За API Endpoint изберете GET и въведете URL адреса по-долу. Отворете Query Params и задайте competitions на буквалното 2021. Добавете dateFrom и dateTo. За всяка стойност използвайте Add AI Data → Parameters, за да вмъкнете съответния вход за дата. Оставете Body празно.
  3. Поставете описанието по-долу под API Action Description и запазете действието. Под Headers идентификационните данни ще бъдат в ред само за запис X-Auth-Token. Настройте това преди първата си заявка. Добавете втори, обикновен хедър с Accept като ключ и application/json като стойност. Използвайте същите два хедъра за всичките три действия.
https://api.football-data.org/v4/teams/57/matches

Маршрутът Team matches на football-data.org и крайната точка GET на Quickchat AI с Query Params за състезание 2021 и две дати Следвайте маршрута за мачовете на отбора от справката на доставчика в действието. Арсенал е фиксиран в URL адреса, лигата в Query Params, а двете дати идват от разговора.

Копирайте описанието на 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.

Примерите за заявки на доставчика поставят API ключа в X-Auth-Token. Използвайте същото име на хедъра в Headers на get_club_fixtures.

Публичният формуляр Sign in на football-data.org, примерът за v4 X-Auth-Token и разделът Headers в Quickchat AI Формулярът за влизане изисква Вашия имейл и API токен. В Quickchat AI само токенът се въвежда в защитения ред X-Auth-Token.

Въведете токена поверително. Таблото за управление може да замени запазения ключ. За да направите този хедър само за запис, първо използвайте връзката към акаунта веднъж за всяко действие. Свържете акаунта си, като използвате ръководството за настройка на Quickchat AI в ChatGPT или Claude. Помолете свързания асистент да подготви хедъра с безопасен заместител, като използвате инструкцията по-долу. След това отворете сами раздела Headers на действието, заменете стойността на същия ред с вашия необработен токен от football-data.org и изберете Save changes. Отворете отново редактора и проверете дали показва [redacted]. Пазете токена в таблото за управление, а не в разговора.

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 в действието за мачове, показващ X-Auth-Token с редактирана стойност Това е запазеният хедър. Доставчикът очаква самия токен, без префикс Bearer.

Опитайте първото прочитане. В Test Response → Test the API въведете начална дата и деня след последната желана дата. След това активирайте действието и попитайте в AI Preview за следващите три мача от първенството в този прозорец. За актуална информация изберете предстоящи дати. Примерът с архива използва 2026-11-18 и 2026-12-03, така че вечерта на 2 декември се включва. Проверете най-близкия мач, като отворите връзката към източника му. Справката за филтър по дата v4 обяснява защо крайната дата не се включва.

Три дати на мачове между началната дата 18 ноември (включително) и крайната дата 3 декември (изключително) В примера гостуването на Нюкасъл е на 21 ноември, домакинството на Манчестър Сити – на 29 ноември, а гостуването на Брентфорд – на 2 декември. Ако заявката приключваше на 2 декември, мачът с Брентфорд щеше да отпадне.

3. Как да проверите последните пет резултата на Арсенал?

Най-показателният мач в този пример завършва Ливърпул 0, Арсенал 1. Ако чатботът всеки път приема първото число за резултата на Арсенал, той ще превърне победата като гост в загуба. Винаги запазвайте резултата в реда домакин-гост и използвайте ID на отбора, за да определите как се е представил Арсенал.

  1. Създайте второ действие (API Action) с име get_recent_results. Използвайте същата крайна точка (GET), полета за дата, чипове за дата и филтър за първенство. Добавете реда за заявка status със стойност FINISHED.
  2. Задайте описанието по-долу. Повторете настройката на хедъра само за запис за get_recent_results, проверете маскирането и активирайте действието.
  3. Поискайте петте най-скорошни мача от първенството в зададен период. За примера използвайте от 1 октомври до 17 ноември 2026 г. Сортирайте по utcDate, преди да изберете петте мача. Ако в периода има само три, покажете тях и предложете да потърсите по-назад.
Копирайте описанието на действието за резултати
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.

Ливърпул 0, Арсенал 1 на страницата на източника на мача с отбелязан резултат на Арсенал като гост Първо намерете Арсенал от страната на гостите, след това вижте отбелязаните от тях голове. Нулата на Ливърпул означава чиста мрежа.

Четете серията от най-новия към най-стария мач. Арсенал побеждава Хъл с 1:0, печели с 1:0 при гостуването на Ливърпул, побеждава Евертън с 2:0, печели с 1:0 при гостуването на Нотингам Форест и побеждава Лийдс с 2:1. Това прави пет победи, седем вкарани и един допуснат гол. Статистиката от мача с Ливърпул е добър тест, защото отборът победител е посочен на второ място.

В запазените тестови данни върнатият списък умишлено започва с мача с Лийдс и завършва с мача с Хъл. Сортирането по начален час премества Хъл в началото на отговора. Отворете отговора на действието до чата и сравнете първия и последния мач в двата списъка.

Пет завършени мача на Арсенал, показани по дата с резултатите като домакин и гост Петте победи могат да скрият важен детайл. Две от тях са като гост, така че головият резултат на победителя е отдясно.

4. Откъде идват позицията в класирането и точките?

Петте победи ви показват как са минали последните няколко седмици. Позицията в класирането обаче зависи и от всички мачове преди тях, както и от резултатите на всички останали отбори. Дайте на агента отделно действие за класирането.

  1. Назовете го get_league_standings. Изберете GET, поставете крайната точка по-долу и оставете полетата за входни данни, параметри на заявката и тяло на заявката празни. Използвайте AI decides, добавете описанието по-долу и повторете настройката на хедъра само за запис за това действие.
  2. В Test Response потърсете в standings записа, чийто type е TOTAL. В неговия table намерете team.id, равно на 57. Активирайте действието и попитайте „Къде е Арсенал в класирането на Висшата лига?“
  3. Сравнете position, playedGames и points с източника за същия сезон и дата. На 18 ноември класирането на Висшата лига в Native Stats показваше 1-во място, 10 изиграни мача, 27 точки. Текущото класиране ще се променя с изиграването на мачовете на другите клубове.
https://api.football-data.org/v4/competitions/PL/standings
Копирайте описанието на действието за класиране
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.

Редът на Арсенал на първо място в класирането на Висшата лига и полетата, използвани от Matchday Notebook Прочетете един ред в TOTAL. 27-те точки покриват всички десет мача от лигата в моментната снимка.

5. Можете ли да проследите справката за мача до нейните източници?

Започнете нов разговор в AI Preview. Попитайте за следващите три мача, продължете с „Как се представихме в последните си пет мача от първенството?“, задайте периода за резултатите, след което попитайте „Какво е мястото ни в класирането?“. В Inbox отворете маркера за извикано действие за всеки отговор. View logs на действието ви позволява да сравните параметрите и отговора с това, което е видял привърженикът. Ръководството за изграждане на API Action показва къде да намерите тези контроли.

За да получите обобщението за мачовете, показано в началото на статията, задайте въпроса по-долу с датите от запазения пример. За актуално обобщение използвайте предстоящи дати за мачовете и скорошни дати за резултатите.

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

Извикването на действието за мачове в Quickchat AI с неговата заявка и върнатия запис на мача Проверете датите и ID на мача в извикването. В локалния пример 560651 е мачът с Нюкасъл.

За повтаряема проверка отворете Conversations → Testing, създайте набор от данни и запазете трите въпроса. Добавете двата гранични въпроса, показани по-долу. Стартирайте набора от данни след промяна на описанието на действието и проверете извикванията заедно с отговорите. Използвайте контролиран отговор, за да тествате рядък статус или грешка. Самостоятелен хипотетичен въпрос тества формулировката на отговора.

Наборът от данни Matchday Notebook в Quickchat AI, съдържащ въпроси за предстоящи мачове, форма, класиране и гранични случаи Използвайте същите въпроси след всяка редакция. Резултатът като гост улавя грешка в отчитането, която тест само с домакински мачове би пропуснал.

Тестов случайКакво трябва да чуе привърженикът
Мач е отложен и двата резултата са null. Равенство ли е?Мачът е отложен. Няма записан резултат.
Успешно търсене връща празен списък matches. Означава ли това, че целият сезон е празен?В този период не бяха намерени мачове. Посочете датите, в които сте търсили.
Доставчикът връща 401 или 403.Проверката не бе успешна. Проверете запазения токен и обхвата на първенството.
Доставчикът връща 429.Лимитът за заявки е достигнат. Спрете и опитайте отново по-късно.

Отговор от Quickchat AI без резултати при успешна заявка, която не връща мачове Дори прозорец без резултати е следствие от успешна заявка. Асистентът може да предложи разширяване на периода.

За второ мнение относно променен начален час го сравнете с публикуваните промени в програмата на лигата. Пазете заедно насрочената дата, часовата зона и датата, на която сте направили проверката. Безплатният канал за данни може да изостава от промяна в излъчването, което е от значение, когато някой планира съботата си според отговора.

Football data provided by the Football-Data.org API. Примерът използва публичните страници Native Stats на доставчика. Вижте плановете за данни и ограниченията за броя на заявките за актуално покритие и свежест на информацията.

Често задавани въпроси

Кой футболен API мога да използвам за чатбот за мачове?

API v4 на football-data.org предоставя програми, резултати и класирания за обхванатите първенства. Използвайте крайната точка за мачовете на отбора за програмата и формата му, а крайната точка за класирането в първенството за позицията в лигата.

Резултатите на football-data.org на живо ли са в безплатния план?

Безплатният план включва резултати и програми със закъснение, класирания в обхванатите първенства и ограничение за броя на заявките от 10 на минута. Включвайте източника и датата с всеки отговор и проверете плана си, ако имате нужда от резултати на живо.

Как да сменя Арсенал с друг отбор?

Намерете ID на отбора и първенството на клуба в football-data.org. Заменете отбор 57 и в двете Actions за мачове, променете числовия филтър за първенство и URL адреса за класиране, след това актуализирайте името на клуба и ID на отбора в инструкциите. Тествайте с мач, който разпознавате.

Как да получа последните пет мача от гледна точка на отбора?

Филтрирайте за завършени мачове от лигата в определен период, сортирайте по начален час от най-новия към най-стария и вземете до пет. За всеки резултат проверете дали отборът Ви е играл като домакин или като гост, преди да отбележите победа, равенство или загуба. Ако са намерени по-малко от пет, покажете колко са.

Какво означава празен резултат за отложен мач?

Празен резултат означава, че доставчикът не е предоставил данни за головете на този отбор. Статусът на мача трябва да остане видим, а резултатът – неизвестен. За нулево равенство е нужен завършил мач с две записани нули.

Как да конвертирам начален час на футболен мач в моята часова зона?

Започнете с началния час на мача в UTC, използвайте наименована часова зона като America/New_York и запазете датата в отговора. Лятното часово време и промяната на календарния ден могат да повлияят на показваното време.

Quickchat AI Quickchat AI Ask Quickchat AI a question