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

О чём урок

Инструмент командной строки, который строит график истории цен закрытия акций, используя инструмент 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 на *написание кода*, который получает данные и рендерит график.

План урока

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