О чём урок
Инструмент командной строки, который строит график истории цен закрытия акций, используя инструмент Agent API sandbox от Perplexity.
Всё выполняется в рамках одного фонового запроса Agent API:
- Модели предоставляется инструмент sandbox — среда Python с urllib/pandas/matplotlib и доступной для записи рабочей директорией.
- Внутри 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 на *написание кода*, который получает данные и рендерит график. Слишком жёсткое ограничение может привести к нехватке ресурсов для шага записи файлов (данные получены, но файлы никогда не записываются…
План урока
- Чем это отличается от документации (важно)
- Возможности
- Предварительные требования
- Установка
- Настройка API-ключа
- Быстрый старт
- Использование
- График за один месяц
Урок входит в полный доступ. Полный текст и видео открываются после оплаты. Первые уроки каждого курса бесплатны.