Урок из полного доступа, первые уроки курса бесплатно Официальный курс Perplexity API Cookbook на русском
Урок 13 · Текст · ~5 мин

Финансовый график в песочнице

Урок 13 из 43 курса «Perplexity API Cookbook»: официальный курс Perplexity API Cookbook (Перплексити) на русском языке. Урок входит в платный доступ; первые уроки курса бесплатно.

О чём урок

Инструмент командной строки, который строит график истории цен закрытия акций, используя инструмент Agent API sandbox от Perplexity.

Всё выполняется в рамках одного фонового запроса Agent API:

  1. Модели предоставляется инструмент sandbox — среда Python с urllib/pandas/matplotlib и доступной для записи рабочей директорией.
  2. Внутри sandbox он получает ежедневные цены закрытия тикера из закреплённого источника данных (JSON-эндпоинт v8 графиков Yahoo Finance), записывает prices.csv и рендерит chart.png. Sandbox предоставляет оба файла в качестве загружаемых артефактов.

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

Этот рецепт был создан и проверен на работающем Agent API. Некоторые особенности определяют его дизайн:

  • Инструмент sandbox требует фоновой задачи. При синхронном/streaming пути запрос отклоняется с сообщением streaming failed: ... unknown tool "sandbox". Вы должны отправлять запрос с background: true и опрашивать ответ по id. Этот скрипт всегда так делает.
  • Sandbox возвращает файлы. Всё, что sandbox записывает в свою рабочую директорию, возвращается как элемент вывода share_file, содержащий file_id, filename и готовый URL /v1/responses/{id}/files/{file_id}/content — их также можно получить списком с помощью GET /v1/responses/{id}/files. Скрипт загружает артефакты prices.csv и chart.png напрямую, вместо того чтобы извлекать что-либо из stdout.
  • Закрепите источник данных, чтобы сократить задержку. Медленная часть выполнения sandbox без ограничений — это *поиск* моделью источника цен (публичные страницы возвращают 429 или защищены капчами — легко 3–7 вызовов sandbox). Указание напрямую обращаться к JSON-эндпоинту v8 графиков Yahoo превращает это в один запрос и оставляет бюджет токенов для рендеринга графика в той же сессии. Типичное выполнение теперь — это один вызов sandbox.
  • Предоставьте sandbox запас output-токенов. Sandbox тратит max_output_tokens на *написание кода*, который получает данные и рендерит график. Слишком жёсткое ограничение может привести к нехватке ресурсов для шага записи файлов (данные получены, но файлы никогда не записываются…

План урока

  1. Чем это отличается от документации (важно)
  2. Возможности
  3. Предварительные требования
  4. Установка
  5. Настройка API-ключа
  6. Быстрый старт
  7. Использование
  8. График за один месяц

Урок входит в полный доступ. Полный текст и видео открываются после оплаты. Первые уроки каждого курса бесплатны.

Откройте полный доступ

Вы прошли бесплатные уроки. Выберите тариф, чтобы продолжить обучение.

Курсы Perplexity 1 490 ₽ Разовый платёж, навсегда
  • Все курсы от Perplexity (1 шт.)
  • Именной сертификат по каждому пройденному курсу
Оплатить
Полный доступ 4 900 ₽ Разовый платёж, навсегда
  • Все 77 курсов от 11 AI-провайдеров
  • Библиотека промптов и новые курсы
Оплатить

Безопасная оплата через Robokassa: СБП, карты, электронные кошельки. Доступ откроется в этом браузере и придёт письмом. Уже оплатили? Восстановить доступ

Полезные гиды