Skillum.AI
РазработкаИсточник изучен

Подключить викторины и развлекательные API

Получать вопросы викторин, шутки и изображения из публичных источников с обработкой повторов и ошибок.

Получить скилл
Что передать агенту

Нужный формат, выбранный API, параметры запроса и способ показа пользователю.

Что получите

Интеграция источника, обработка ответа и правила повторных запросов.

Кому пригодится

Разработчикам развлекательных функций.

Требования и ограничения

Для точного голоса нужны примеры; используйте только материалы, на которые у вас есть права.

Добавить викторины и развлекательные материалы

Скилл описывает подключение публичных API с вопросами для викторин, фактами, короткими советами и изображениями животных. Он подходит для демонстрационного приложения, бота или игровой функции. Основное внимание уделено формату ответов, повторениям вопросов и обработке ошибок при загрузке.

Выбрать источник под формат

В оригинале для викторин используется Open Trivia DB, для фактов о кошках — catfact.ninja, для медиа с собаками — random.dog. Короткие советы и факты рассматриваются через Advice Slip и Useless Facts. Актуальную доступность проверяют при интеграции: упомянутые автором сбои альтернативных сервисов не следует переносить в каталог как постоянный факт.

Организовать сеанс викторины

Для серии вопросов источник предлагает получить токен сеанса и передавать его при запросах. Это позволяет API отслеживать уже выданные вопросы. Категорию, сложность и количество задают параметрами. Приложение учитывает срок жизни токена и состояние, при котором доступный набор исчерпан: тогда требуется сброс или новый сеанс.

Подготовить данные перед показом

Вопросы могут содержать HTML-сущности либо закодированные символы, поэтому текст декодируют выбранным способом. Верный ответ приходит отдельно от неверных: их объединяют и перемешивают, чтобы позиция не выдавала решение. Каждый ответ API анализируют по коду результата, различая успех, нехватку вопросов, проблемы токена и ограничение частоты.

Обработать изображения и повторные запросы

Для медиа сначала получают JSON и извлекают ссылку. Если слот предназначен только для картинки, видеофайлы отфильтровывают. Кэширование коротких советов может давать одинаковый ответ при частых обращениях, поэтому кнопку следующего материала связывают с допустимым темпом загрузки. Частоту и размер партий вопросов сверяют с текущими правилами сервиса.

Какой результат ожидается

Для викторины результатом служит интеграция с жизненным циклом токена, читаемыми вопросами, перемешанными ответами и обработанными ошибками. Для отдельного материала сохраняют полученный элемент и адрес источника. Скилл не предназначен для справочных определений или заполнения интерфейса тестовыми пользователями. Бесплатные внешние источники требуют плана на случай недоступности, если функция становится существенной частью продукта.

Автор и источник

Оригинальное название: fun-content
Автор или репозиторий: SkillMedev/skills
Лицензия: MIT
Открыть первоисточник

Полный текст скилла

Нужен агент, который применит этот навык?

Поможем подключить его к вашим системам и настроить работу.