Освоение Pi Agent: Полный курс по созданию и настройке AI-агента

0:00

Pi Agent (pi.dev) — это минималистичный и легко настраиваемый AI-агент, который быстро набирает популярность среди профессионалов в области разработки и бизнеса. В отличие от тяжеловесных решений вроде Cursor или Claude Code, Pi Agent представляет собой «упряжку» (harness) с минимальным набором базовых инструментов, которую пользователь адаптирует под свои конкретные рабочие процессы, а не наоборот.

🚀 Начало работы и установка 0:39

Установка Pi Agent выполняется одной командой в терминале, которую можно найти на официальном сайте pi.dev.

• Установка: Скопируйте команду curl с сайта и выполните её в терминале. Это установит Pi глобально на компьютер за считанные секунды.
• Запуск: Введите pi в терминале.
• Аутентификация: Если вы не авторизованы, используйте команду /lo для выбора провайдера (например, Open Router). Для работы потребуется API-ключ от выбранного сервиса.

По словам Дэвида Ондрея, Pi Agent обладает преимуществом в экономии токенов: его системный промпт занимает около 1000 токенов, что в 10–15 раз меньше, чем у большинства других агентов.

🛠 Архитектура контекста и основные инструменты 5:30

Pi Agent полагается на простые Markdown-файлы для формирования контекста работы:

1. system.md: Полностью переопределяет системный промпт (использовать с осторожностью).
2. append_system.md: Добавляется в конец системного промпта при каждом сеансе — лучший способ кастомизации без удаления стандартных настроек.
3. agents.md: Контекст, специфичный для конкретного проекта или папки.

Агент оснащен всего четырьмя встроенными инструментами: Read (чтение), Write (создание), Edit (редактирование) и Bash (управление терминалом). Дэвид Ондрей утверждает, что этого достаточно для выполнения практически любой задачи — от управления файлами и установки пакетов до настройки параметров сети.

📈 Методы повышения производительности 12:41

Чтобы превратить Pi Agent в мощный инструмент, стоит использовать четыре уровня расширения системы:

• Agents.md: Базовая настройка, «всегда включенная» память агента.
• Prompt Templates: Создание шаблонов с помощью слэш-команд (например, /short для краткости или /review для анализа кода). Это экономит время при повторении одних и тех же запросов.
• Skills: Навыки, которые автоматически загружаются в контекстное окно, когда они релевантны текущей задаче.
• Extensions: Написанные на TypeScript расширения, которые служат хуками для выполнения сложных задач, недоступных через Markdown (например, веб-поиск).

Для вступления в силу изменений после редактирования конфига обязательно используйте команду /reload.

⚡ Управление сессиями и многозадачность 21:36

Одной из уникальных особенностей Pi является возможность «рулить» агентом на лету:

• Очередь сообщений: Используйте Option + Enter (на Mac), чтобы поставить задачу в очередь — она будет выполнена сразу после завершения текущего процесса.
• Compact: Команда /compact эффективно сжимает историю контекста, что работает значительно быстрее, чем в других инструментах.
• YOLO Mode: По умолчанию агент работает без запросов на подтверждение действий. Это дает невероятную свободу, но требует использования мощных моделей (таких как Claude Opus), чтобы избежать ошибок. Для повышения безопасности можно установить пакет pi-permission-system.

Дэвид Ондрей рекомендует использовать Pi Agent совместно с CMAX — терминалом, оптимизированным для запуска нескольких AI-агентов параллельно. В такой связке Pi Agent выступает как «оркестратор», управляющий другими агентами (например, Codex CLI) для выполнения параллельных задач.

🌳 Древовидная структура истории 39:16

В отличие от линейных чатов в других AI, в Pi Agent сессия — это дерево. Вы можете в любой момент вернуться к любой точке истории, изменить запрос, и система создаст новую ветку.

• Forking: Команда /fork позволяет разветвить текущий чат в отдельную сессию, что удобно для изоляции экспериментов.
• Sharing: Команда /share создает ссылку (gist) на текущую сессию, которую можно отправить коллегам для демонстрации процесса решения задачи.
• Resume: Команда /resume позволяет быстро переключаться между всеми предыдущими сессиями.