Настройка учетных данных Spotify

О чём урок

Ищите эпизоды подкастов на любую тему в каталоге Spotify, обогащайте их веб-исследованиями и получайте структурированный бриф с ранжированными рекомендациями, организованный агентом Mistral.

Агент координирует три типа инструментов через Agents API:

Все инструменты определены встроенно как функциональные инструменты, поэтому нет внешних серверов или зависимостей, кроме Mistral SDK и spotipy.

Статус API: Этот блокнот использует client.beta.agents и client.beta.conversations. Это бета-версии конечных точек, и они могут измениться.

Для выполнения этого блокнота вам потребуется: - Python 3.11 или новее - Учетная запись Mistral и ключ API - Учетные данные разработчика Spotify (Client ID и Client Secret)

1. Перейдите на Панель разработчика Spotify и войдите в свою учетную запись Spotify. Для использования Web API требуется подписка Spotify Premium.
2. Нажмите Create app.
3. Заполните форму:
4. App name: Любое имя (например, "Podcast Research Agent")
5. App description: Любое описание
6. Redirect URI: Введите https://localhost:8080/callback (это не будет использоваться, но поле является обязательным)
7. Which API/SDKs are you planning to use?: Выберите Web API
8. Установите флажок согласия с условиями обслуживания и нажмите Save.
9. На панели управления вашего приложения нажмите Settings.
10. Скопируйте Client ID и Client Secret (нажмите "View client secret", чтобы показать его).

Этот сборник рецептов использует поток аутентификации Client Credentials, который предоставляет доступ только для чтения к общедоступному каталогу Spotify. Во время выполнения не требуется вход пользователя или перенаправление OAuth.

Установите необходимые пакеты.

Импортируйте необходимые модули, установите ключи API (появятся запросы безопасного ввода, если переменные окружения еще не установлены) и инициализируйте клиент Mistral.

Агент использует функциональные инструменты, зарегистрированные непосредственно на агенте. Когда агент вызывает инструмент, потоковый цикл выполняет соответствующую функцию Python и отправляет результат обратно через FunctionResultEntry.

• Функции Spotify — обертывают Spotify Web API через spotipy с аутентификацией Client Credentials. Предоставляют инструменты для поиска подкастов, поиска эпизодов и получения подробной информации.
• Функция брифинга — использует zai-glm-5-2 для генерации структурированного исследовательского брифинга из собранных данных подкастов и веб-исследований.
• Веб-поиск…

План урока

1. Предварительные условия
2. Настройка учетных данных Spotify
3. Настройка окружения
4. Архитектура
5. Шаг 1 — Определение функций инструмента
6. Шаг 2 — Определение схем инструментов и создание агента
7. Шаг 3 — Выполнение исследовательского запроса
8. Шаг 4 — Отображение брифинга