# Pi Agent: полное руководство по настройке AI-агента

Источник: https://www.youtube.com/watch?v=jcUqsNpDDDk
Канал: David Ondrej
Опубликовано: 12.06.2026

---

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

[[JUMP:0:00]]

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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