Интерактивный режим Pi Agent
В этой главе подробно рассматриваются основные операции в интерактивном режиме Pi Agent, включая слэш-команды, управление моделями и работу с клавиатурой.
Справочник по слэш-командам
Ввод в области редактора/запускает автоматическое дополнение команд.
Ниже перечислены распространённые встроенные команды в интерактивном режиме Pi Agent:
| Команда | Функция | Описание |
|---|---|---|
| /login | Провайдер входа | Выберите подписку OAuth или провайдера API Key для аутентификации |
| /logout | Выход | Удалить сохранённые учётные данные аутентификации |
| /model | Переключить модель | Откройте селектор модели и ищите по имени; нажмите Ctrl+S внутри селектора, чтобы сохранить как значение по умолчанию при запуске |
| /thinking | Переключить уровень рассуждения | Откройте селектор уровня рассуждений; нажмите Ctrl+S внутри селектора, чтобы сохранить как значение по умолчанию при запуске |
| /scoped-models | Управление областью моделей | Задайте список моделей, доступных для циклического переключения по Ctrl+P |
| /settings | Панель настроек | Откройте встроенный интерфейс настроек: уровень рассуждений, тема, доставка сообщений, транспортный протокол и т. д. |
| /resume | Возобновить сессию | Выбрать и восстановить из исторической сессии |
| /new | Новая сессия | Начать совершенно новый диалог |
| /name | Имя сессии | Задать понятное имя текущей сессии |
| /session | Информация о сессии | Показать путь к файлу сессии, ID, количество сообщений, использование токенов и стоимость |
| /tree | Навигация по дереву сессии | Перейти к любому узлу дерева диалога, чтобы продолжить разговор |
| /trust | Доверять проекту | Сохранять решения о доверии к проекту, чтобы не спрашивать при каждом запуске |
| /fork | Ответвить сессию | Создать новый файл сессии ответвлением от предыдущего сообщения пользователя |
| /clone | Клонировать сессию | Скопировать текущую активную ветку в новый файл сессии |
| /compact | Сжать контекст | Вручную сжать историю переписки, чтобы освободить место в окне контекста |
| /copy | Копировать ответ | Скопировать последний ответ ИИ в буфер обмена |
| /export | Экспортировать сеанс | Экспорт в файл HTML или JSONL |
| /import | Импортировать сеанс | Импортировать и восстановить сеанс из файла JSONL |
| /share | Поделиться сессией | Загрузить как приватный GitHub Gist, создать ссылку HTML для общего доступа |
| /reload | Горячая перезагрузка | Перезагрузить расширения, Skills, шаблоны промптов, темы, контекстные файлы и конфигурации сочетаний клавиш |
| /hotkeys | Справка по сочетаниям клавиш | Показать список всех сочетаний клавиш |
| /changelog | История изменений | Показать историю обновлений версий |
| /quit | Выход | Выйти из Pi Agent |
Помимо встроенных команд, расширения также могут регистрировать пользовательские команды.
Навыки автоматически регистрируются как команда/skill:name, а шаблоны промптов вызываются через/template-name.
Управление моделями
Управление моделями охватывает три аспекта: переключение моделей, настройку области циклического переключения и регулировку уровней рассуждения.
Соответствующие команды и сочетания клавиш описаны ниже.
Переключение модели (/model и Ctrl+L)
Используйте команду/modelилиCtrl+L, чтобы открыть селектор моделей и просмотреть все доступные AI-модели.
В селекторе моделей можно искать по имени; после выбора нажмите Ctrl+S, чтобы сохранить как стартовое значение по умолчанию.
Ниже показан процесс открытия селектора моделей и переключения моделей:
/model ┌ 选择模型（输入关键词过滤，↑/↓ 移动，Enter 确认）： │ > anthropic/claude-sonnet-4-5 │ anthropic/claude-opus-4-1 │ openai/gpt-4o │ google/gemini-2.5-pro └ 已切换到 anthropic/claude-sonnet-4-5
Модели в списке зависят от настроенных вами провайдеров; фактическое отображение может отличаться от примера.
Быстрое циклическое переключение (Ctrl+P)
Ctrl+PПереключение вперёд по моделям,Shift+Ctrl+Pпереключение назад.
Диапазон переключения управляется командой/scoped-modelsили настройкамиenabledModels.
Уровень рассуждений (Shift+Tab)
Shift+TabПереключение между уровнями рассуждений.
Цвет границы редактора меняется в зависимости от уровня, давая интуитивное представление о текущей глубине рассуждений:
| Уровень | Сценарий применения |
|---|---|
| off | Без рассуждений (общие задачи) |
| minimal / low | Лёгкие рассуждения (рутинное программирование) |
| средний | Умеренные рассуждения |
| high / xhigh | Глубокие рассуждения (сложные задачи) |
| max | Максимальные рассуждения (чрезвычайно сложная логика) |
Нажмите Ctrl+S в селекторе /thinking, чтобы сохранить текущий уровень как уровень по умолчанию при запуске.
Уровни рассуждений, не поддерживаемые моделью, не будут применяться и не появятся в списке переключения.
Возможности модели определяют верхний предел уровней рассуждения.
Интеграция shell-команд
Вы можете запускать shell-команды прямо в области редактора, не покидая Pi Agent:
| Префикс | Поведение | Обработка вывода | Сценарий использования |
|---|---|---|---|
| ! | Выполнить команду и отправить вывод ИИ | Доступно ИИ | Позволить ИИ просматривать результаты тестов, вывод линтера, git status |
| !! | Выполнить команду, не отправлять вывод ИИ | Только локальное отображение | Открывать файлы, просматривать окружение, быстрые проверки |
Пример использования:
!npm test !git diff --stat !python -m pytest -v !!cat ~/.zshrc !!ls -la
Ниже выполните!npm testфактический эффект после выполнения: вывод будет отображён локально и также передан ИИ.
!npm test > [email protected] test > vitest run PASS src/utils/format.test.ts (6 tests) 12ms PASS src/utils/parse.test.ts (4 tests) 8ms Test Files 2 passed (2) Tests 10 passed (10)
!Вывод команды расходует контекстное окно ИИ.
Если вывод большой (например, полные логи), рассмотрите возможность использования!!или перенаправьте вывод в файл, а затем позвольте ИИ прочитать его.
Глубокое погружение в очередь сообщений
Очередь сообщений позволяет отправлять инструкции, пока ИИ работает, что значительно повышает эффективность взаимодействия:
| Тип сообщения | Горячая клавиша | Момент срабатывания | Типичный сценарий |
|---|---|---|---|
| Корректировка | Enter | Вставляется после завершения выполнения всех вызовов инструментов в текущем раунде, перед следующим вызовом LLM | Когда ИИ выполняет последовательность вызовов read → edit → bash, а вы хотите скорректировать его направление на полпути |
| Дополнение | Alt+Enter | Вставляется только после того, как ИИ завершит всю работу (больше нет вызовов инструментов для выполнения) | Добавить новые требования после того, как ИИ завершит текущую задачу |
| Прервать и вернуть | Escape | Прервать текущую операцию и вернуть сообщения из очереди обратно в область редактора | Немедленно остановиться, когда ИИ сбивается с курса, и вернуть поставленные в очередь инструкции |
| Только извлечь сообщения из очереди | Alt+Up | Не прерывать текущую операцию, а только вернуть сообщения из очереди в область редактора | Когда вы хотите переписать содержимое очереди, но не нужно прерывать ИИ |
Вы можете в настройках,steeringModeиfollowUpModeуправлять стратегией отправки сообщений.
В Windows и WSL комбинация Alt+Enter часто занята терминалом (например, Windows Terminal по умолчанию привязывает её к переключению полноэкранного режима). В этом случае Ctrl+Q на самом деле является комбинацией по умолчанию для отправки последующих сообщений.
Возможности редактора
Область редактора предоставляет расширенные возможности, такие как ссылки на файлы, автодополнение пути и многострочный ввод, что снижает необходимость переключаться между инструментами.
| Характеристика | Способ выполнения |
|---|---|
| Поиск ссылок на файлы | Введите @, чтобы запустить нечёткий поиск по файлам проекта |
| Автодополнение пути | Нажмите Tab для автозаполнения путей |
| Многострочный ввод | Shift+Enter для новой строки (используйте Ctrl+Enter в Windows Terminal) |
| Вставить изображение | Ctrl+V (в Windows используется Alt+V, в WSL также используется Alt+V), или перетащите изображение в терминал |
| Копировать ответ ИИ | Ctrl+X копирует текущее выбранное сообщение в /tree, а в других сценариях копирует последний ответ ИИ |
| Внешний редактор | Ctrl+G открывает внешний редактор для редактирования текущего содержимого |
Другие расширенияВ многострочном вводе «Windows Terminal использует Ctrl+Enter» — это автоматическая адаптация в Windows Terminal, а не значение по умолчанию в keybindings.json.