Вы планируете субботу с учётом выездного матча «Арсенала» с «Ньюкаслом». Другу в Нью-Йорке нужно узнать время начала игры. Тут кто-то в групповом чате спрашивает, как «Арсенал» сыграл в прошлый раз на выезде. Ответ на первый вопрос есть в календаре матчей. Для второго нужно знать, чей гол обозначен единицей в счёте «Ливерпуль 0–1 Арсенал».
Вы создадите Matchday Notebook» — футбольный чат-бот, который находит три следующих матча Премьер-лиги, сообщает о пяти последних результатах «Арсенала» в лиге и показывает его место в таблице. Пример привязан к 18 ноября 2026 года. Выездной матч с «Ньюкаслом» был назначен на субботу, 21 ноября, в 17:30 по UTC, или в 12:30 в Нью-Йорке.
Страница матча у провайдера и приватный агент показывают одинаковое время начала. Разговор в Quickchat AI вёлся на основе архивной копии общедоступных данных, которую вы можете воспроизвести ниже.
Проверьте матч с «Ньюкаслом» или скачайте комплект Matchday Notebook. Распакуйте его и запустите python3 replay.py, чтобы увидеть три матча, пять результатов и строку таблицы без учетной записи. Тот же комплект включает настройки Action и Main Prompt для подключения вашего собственного фида.
1. Какой клуб и соревнование будет отслеживать чат-бот?
Сначала закрепите клуб и лигу. Форма «Арсенала» в лиге может меняться в зависимости от того, учитываете ли вы вторничный вечер в Европе. В этом блокноте «Арсенал» означает команду 57, а лига означает Премьер-лигу 2021, также известную по коду PL.
- Откройте форму регистрации football-data.org. Введите свое имя и адрес электронной почты, примите условия и выберите Create account. Проверьте свою лигу в списке поддерживаемых соревнований. Бесплатный тарифный план включает Премьер-лигу с задержкой в расписаниях и результатах.
Используйте адрес электронной почты, к которому у вас есть доступ. football-data.org отправит на него ключ API после регистрации. Бесплатный тарифный план допускает 10 запросов в минуту.
Если у вас уже есть учетная запись, войдите в нее, используя свой адрес электронной почты и токен API. Если вам нужна еще одна копия токена, запросите ее по электронной почте, указав адрес, который вы использовали при регистрации. Сохраните токен для защищенного заголовка на шаге 2.
Проверьте свой тарифный план в разделе Subscription и найдите свою лигу в разделе Available competitions. На этом фрагменте показаны Лига чемпионов УЕФА (CL) и Бундеслига (BL1).
- Чтобы следить за другим клубом, найдите его в списке команд соревнования, например с помощью запроса
GET /v4/competitions/PL/teams. Используйте полученные ID команды и ID соревнования в запросах матчей ниже. Оба варианта поиска описаны в кратком руководстве по v4. - Создайте Агента Quickchat AI, назовите его Matchday Notebook и держите его приватным, пока тестируете. Вам нужны доступные кредиты для разговоров и симуляций. Откройте Identity → AI Persona → Main Prompt и вставьте инструкции ниже. Скриншоты и копируемые настройки используют английский язык.
Сохраняйте один и тот же клуб в обоих местах. В продукте инструкции Агента находятся в разделе 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. Как получить следующий матч «Арсенала»?
Начните с действия, которое отвечает на вопрос из группового чата о времени начала матча. Один запрос возвращает оба клуба, запланированное время и статус матча. Оставьте фильтр статуса пустым, чтобы в результатах могли появиться и перенесённые игры. У записи со статусом TIMED есть время начала. Для статуса SCHEDULED сообщите пользователю, что время ещё не подтверждено.
- Откройте 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 добавьте обязательные поля ввода Textdate_fromиdate_to, оба с параметром No default. Их описания: «Начальная дата для включения в выборку (UTC), YYYY-MM-DD» и «Конечная дата для исключения из выборки (UTC), YYYY-MM-DD». - Для API Endpoint выберите GET и введите URL ниже. Откройте Query Params и установите для
competitionsзначение2021. ДобавьтеdateFromиdateTo. Для каждого значения используйте Add AI Data → Parameters, чтобы вставить соответствующее поле для ввода даты. Оставьте Body пустым. - Вставьте описание ниже в поле API Action Description и сохраните действие. В разделе Headers учетные данные будут находиться в строке
X-Auth-Tokenтолько для записи. Настройте это перед первым запросом. Добавьте второй, обычный заголовок сAcceptв качестве ключа иapplication/jsonв качестве значения. Используйте эти два заголовка для всех трех действий.
https://api.football-data.org/v4/teams/57/matches
Следуйте маршруту матчей команды из справочника поставщика данных в действие. «Арсенал» зафиксирован в 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.
Для входа в учетную запись введите свой адрес электронной почты и токен 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.
Это сохраненный заголовок. Провайдер ожидает сам токен, без префикса Bearer.
Выполните первый запрос. В разделе Test Response → Test the API укажите дату начала и день после нужной вам даты окончания. Затем включите действие и запросите в AI Preview три следующих матча лиги в этом временном окне. Для актуальных данных выбирайте будущие даты. В архивном примере использовались 2026-11-18 и 2026-12-03, поэтому вечер 2 декабря был включен в диапазон. Проверьте ближайший матч, открыв ссылку на его источник. В справке по фильтру дат v4 объясняется, почему дата окончания не включается в диапазон.
В архивном примере гостевой матч с «Ньюкаслом» состоялся 21 ноября, домашний с «Манчестер Сити» — 29 ноября, а гостевой с «Брентфордом» — 2 декабря. Если бы датой окончания запроса было 2 декабря, матч с «Брентфордом» не был бы включен в результаты.
3. Как узнать последние пять результатов «Арсенала»?
Самый показательный матч в этом примере закончился со счетом «Ливерпуль» 0:1 «Арсенал». Если чат-бот будет всегда считать первое число голами «Арсенала», он примет гостевую победу за поражение. Сохраняйте счет в формате «хозяева-гости» и используйте ID команды, чтобы определить результат «Арсенала».
- Создайте второе действие API Action с именем
get_recent_results. Используйте тот же эндпоинт GET, те же поля для ввода дат, чипы дат и фильтр по соревнованию. Добавьте строку запросаstatusс литеральным значениемFINISHED. - Задайте описание ниже. Повторите настройку заголовка, доступного только для записи, для
get_recent_results, проверьте маску и включите действие. - Запросите пять последних матчей лиги в указанном временном окне. Для примера используйте период с 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.
Сначала найдите «Арсенал» в качестве гостевой команды, затем посмотрите на количество забитых ею голов. Ноль у «Ливерпуля» означает, что «Арсенал» сыграл на ноль.
Читайте серию результатов от новых к старым. «Арсенал» обыграл «Халл» 1:0, победил «Ливерпуль» в гостях 1:0, обыграл «Эвертон» 2:0, победил «Ноттингем Форест» в гостях 1:0 и обыграл «Лидс» 2:1. Итого пять побед, семь забитых и один пропущенный мяч. Протокол матча с «Ливерпулем» — хороший пример для теста, так как победившая команда указана второй.
В сохраненных тестовых данных список намеренно начинается с матча против «Лидса» и заканчивается матчем против «Халла». Сортировка по времени начала матча перемещает «Халл» в начало ответа. Откройте ответ действия рядом с чатом и сравните первый и последний матчи в обоих списках.
За пятью победами может скрываться важная деталь. Две из них были гостевыми, поэтому победный счет указан справа.
4. Откуда берутся место в лиге и очки?
Пять побед показывают, как прошли последние несколько недель. Место в лиге также зависит от всех предыдущих матчей и результатов других команд. Предоставьте Агенту отдельное действие для получения турнирной таблицы.
- Назовите его
get_league_standings. Выберите GET, вставьте эндпоинт ниже и оставьте поля для ввода, параметры запроса и тело пустыми. Используйте AI decides, добавьте описание ниже и повторите для этого действия настройку заголовка, доступного только для записи. - В разделе Test Response найдите в
standingsзапись, у которойtypeравноTOTAL. Внутри ееtableнайдитеteam.id, равное57. Включите действие и задайте вопрос «На каком месте «Арсенал» в таблице Премьер-лиги?» - Сравните
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.
Проверьте даты и ID матча в вызове. В локальном архивном примере 560651 — это матч с «Ньюкаслом».
Для повторяемой проверки откройте Conversations → Testing, создайте набор данных и сохраните три вопроса. Добавьте два пограничных вопроса, показанных ниже. Запустите набор данных после изменения описания действия и проверьте вызовы вместе с ответами. Используйте контролируемый ответ, чтобы проверить редкий статус или ошибку. Гипотетический вопрос сам по себе проверяет только формулировку ответа.
Используйте одни и те же вопросы после каждого изменения. Результат гостевого матча помогает выявить ошибку в счете, которую пропустил бы тест только с домашними матчами.
| Тестовый случай | Что должен услышать болельщик |
|---|---|
Матч перенесен, и оба значения голов — null. Это была ничья? | Матч был перенесен. Счет не зафиксирован. |
Успешный поиск вернул пустой список matches. Значит, за весь сезон нет матчей? | В этом временном окне матчей не найдено. Укажите даты, по которым вы искали. |
| Провайдер возвращает 401 или 403. | Не удалось выполнить поиск. Проверьте сохраненный токен и доступ к соревнованию. |
| Провайдер возвращает 429. | Лимит запросов достигнут. Повторите попытку позже. |
Даже при отсутствии данных в ответе запрос считается успешным. Помощник может предложить расширить диапазон дат.
Чтобы перепроверить измененное время начала матча, сверьтесь с опубликованными изменениями в календаре на сайте лиги. Записывайте вместе дату матча, часовой пояс и дату проверки. Данные из бесплатного источника могут обновляться с задержкой, а это важно, если кто-то строит планы на субботу по вашему ответу.
Football data provided by the Football-Data.org API. В этом примере используются общедоступные страницы Native Stats от поставщика данных. Актуальные сведения о покрытии и частоте обновления см. в разделе тарифы и лимиты запросов.
Часто задаваемые вопросы
Какой футбольный API я могу использовать для чат-бота с расписанием матчей?
API football-data.org v4 предоставляет календарь матчей, результаты и турнирные таблицы для поддерживаемых соревнований. Используйте эндпойнт матчей команды для получения расписания и текущей формы, а эндпойнт турнирной таблицы соревнования — для определения позиции в лиге.
Доступны ли результаты football-data.org в реальном времени на бесплатном тарифе?
Бесплатный тариф включает расписания и результаты с задержкой, турнирные таблицы для поддерживаемых соревнований и лимит в 10 запросов к API в минуту. Указывайте источник и дату в каждом ответе и проверьте условия своего тарифа, если вам нужны результаты в реальном времени.
Как изменить «Арсенал» на другую команду?
Найдите ID клуба и ID соревнования в football-data.org. Замените команду 57 в обоих действиях, связанных с матчами, измените числовой фильтр соревнования и URL турнирной таблицы, а затем обновите название клуба и ID команды в инструкциях. Протестируйте на примере известного вам матча.
Как получить последние пять матчей с точки зрения команды?
Отфильтруйте завершённые матчи лиги в указанном временном окне, отсортируйте их по времени начала от новых к старым и выберите до пяти матчей. Для каждого счёта определите, играла ли ваша команда дома или в гостях, чтобы присвоить результат: победа, ничья или поражение. Если нашлось менее пяти матчей, покажите, сколько удалось найти.
Что означает пустой счет для отложенного матча?
Пустой счёт означает, что провайдер не предоставил данные о голах для этой команды. Оставьте статус матча видимым, а счёт — неизвестным. Для безголевой ничьей требуется завершённый матч с двумя зафиксированными нулями.
Как перевести время начала футбольного матча в мой часовой пояс?
Начните с времени начала матча в UTC, используйте именованный часовой пояс, такой как America/New_York, и сохраните дату в ответе. Переход на летнее время и изменение календарного дня могут повлиять на отображаемое время.