Як створити футбольного чатбота для розкладу матчів, результатів і таблиці

Piotr Grudzień
Опубліковано Час читання: 9 хв
Короткий звіт про ігровий день «Арсеналу» на три рядки в Quickchat AI поруч зі сторінкою Account Settings на football-data.org, де показано підписку Free

Ви плануєте суботу з огляду на виїзний матч «Арсеналу» проти «Ньюкасла». Другові в Нью-Йорку потрібен час початку гри. Потім хтось у груповому чаті запитує, як «Арсенал» зіграв свій останній матч на виїзді. Відповідь на перше питання є в розкладі. Для другого потрібно знати, кому належить гол у рахунку «Ліверпуль 0–1 Арсенал».

Ви створите Matchday Notebook — футбольного чат-бота, який шукає три найближчі матчі Прем’єр-ліги, показує п’ять останніх результатів «Арсеналу» в лізі та знаходить його місце в таблиці. Приклад прив’язаний до 18 листопада 2026 року. Виїзний матч проти «Ньюкасла» був запланований на суботу, 21 листопада, о 17:30 за UTC, тобто о 12:30 в Нью-Йорку.

Матч проти «Ньюкасла» в Native Stats та відповідна відповідь у Quickchat AI Сторінка матчу від постачальника даних і приватний Агент узгоджують час початку гри. Розмова в 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.

Скопіюйте 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. Як отримати наступний матч «Арсеналу»?

Почніть із дії (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, а дві дати надходять із розмови.

Скопіюйте опис для дії з розкладом
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, приклад X-Auth-Token v4 і вкладка 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.

Рядок «Арсеналу» на першому місці в турнірній таблиці Прем'єр-ліги та поля, що використовуються в записнику Прочитайте дані в одному рядку в 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 football-data.org v4 надає розклад матчів, результати та турнірні таблиці для підтримуваних змагань. Використовуйте ендпоїнт матчів команди для розкладу та форми за останніми іграми, а ендпоїнт турнірної таблиці змагання — для позиції в лізі.

Чи доступні результати матчів на football-data.org у реальному часі на безкоштовному плані?

Безкоштовний план включає розклади та результати із затримкою, турнірні таблиці для підтримуваних змагань і ліміт у 10 запитів до API за хвилину. Додавайте джерело та дату до кожної відповіді й перевірте умови свого плану, якщо вам потрібні результати в реальному часі.

Як змінити «Арсенал» на іншу команду?

Знайдіть ID клубу та змагання на football-data.org. Замініть команду 57 в обох діях (Actions) для матчів, змініть числовий фільтр змагання та URL-адресу турнірної таблиці, а потім оновіть назву клубу та ID команди в інструкціях. Перевірте налаштування на матчі, який ви знаєте.

Як отримати останні п’ять матчів з погляду команди?

Відфільтруйте завершені матчі ліги у вказаному проміжку дат, відсортуйте за часом початку від найновіших до найстаріших і візьміть до п’яти. Для кожного рахунку перевірте, чи грала ваша команда вдома чи на виїзді, перш ніж визначати перемогу, нічию або поразку. Якщо знайдено менше п’яти матчів, покажіть, скільки їх є.

Що означає порожній рахунок для відкладеного матчу?

Порожній рахунок означає, що постачальник не надав даних про голи для цієї сторони. Залиште статус матчу видимим, а рахунок — невідомим. Для безгольової нічиєї потрібен завершений матч із двома зафіксованими нулями.

Як перевести час початку футбольного матчу в мій часовий пояс?

Почніть з часу початку матчу UTC, використовуйте названий часовий пояс, такий як America/New_York, і збережіть дату у відповіді. Перехід на літній час та зміна календарного дня можуть вплинути на відображуваний час.

Quickchat AI Quickchat AI Ask Quickchat AI a question