Cursor Agent
Agent — помощник Cursor, который может самостоятельно выполнять сложные задачи по программированию, запускать команды в терминале и редактировать код. Откройте его на боковой панели с помощью Cmd+ICtrl+I.
Узнайте больше о том, как работают агенты, и разрабатывайте быстрее.
Как работает Agent
Agent состоит из трёх компонентов:
- Инструкции: системный промпт и правила, определяющие поведение Agent
- Инструменты: редактирование файлов, поиск по кодовой базе, выполнение команд в терминале и многое другое
- Модель: модель Agent, которую вы выбираете для задачи
Agent Cursor координирует эти компоненты для каждой поддерживаемой модели, адаптируя инструкции и инструменты под каждую передовую модель. По мере выхода новых моделей вы можете сосредоточиться на разработке ПО, а Cursor возьмёт на себя оптимизацию для конкретных моделей.
Инструменты
Инструменты — ключевые возможности Agent. Они позволяют искать информацию в вашей кодовой базе и интернете, редактировать файлы, выполнять команды в терминале и многое другое.
Чтобы узнать, как устроен вызов инструментов, см. основы вызова инструментов.
Количество вызовов инструментов, которые Agent может выполнить в рамках задачи, не ограничено.
Ищите файлы по имени, просматривайте структуру каталогов и находите точные ключевые слова или шаблоны в файлах.
Создавайте поисковые запросы и выполняйте поиск в интернете.
Получайте конкретные правила на основе типа и описания.
Интеллектуально считывайте содержимое файлов. Также поддерживаются файлы изображений (.png, .jpg, .gif, .webp, .svg): они добавляются в контекст диалога для анализа моделями с поддержкой зрения.
Предлагайте изменения в файлах и применяйте их автоматически.
Выполняйте терминальные команды и отслеживайте вывод. По умолчанию Cursor использует первый доступный профиль терминала.
Чтобы задать предпочитаемый профиль терминала:
- Откройте Command Palette (
Cmd/Ctrl+Shift+P) - Найдите "Terminal: Select Default Profile"
- Выберите нужный профиль
Управляйте браузером: делайте скриншоты, тестируйте приложения и проверяйте визуальные изменения. Agent может переходить на страницы, взаимодействовать с элементами и фиксировать текущее состояние для анализа. Подробнее см. в документации Browser.
Создавайте изображения по текстовым описаниям или референсным изображениям. Полезно для создания макетов UI, ресурсов продукта и визуализации архитектурных диаграмм. По умолчанию изображения сохраняются в папке assets/ вашего проекта и отображаются прямо в чате.
Задавайте уточняющие вопросы во время выполнения задачи. Пока Agent ожидает вашего ответа, он продолжает читать файлы, вносить изменения или выполнять команды. Ваш ответ учитывается сразу после получения.
Контрольные точки
Контрольные точки сохраняют снимки вашей кодовой базы во время сессии Agent. Agent автоматически создаёт их перед существенными изменениями, сохраняя состояние всех изменённых файлов.
Если Agent допустит ошибку, нажмите любую контрольную точку на временной шкале чата, чтобы просмотреть состояние файлов на тот момент, а затем восстановите его, чтобы вернуть все файлы к этому состоянию. Вы также можете восстановить состояние с помощью кнопки Restore Checkpoint в предыдущих запросах или кнопки + при наведении на сообщение. Восстановление контрольной точки отменяет изменения только в файлах; сообщения из диалога при этом не удаляются.
Контрольные точки полезны при исследовательской работе, сложном рефакторинге и итеративной разработке, когда нужны безопасные точки отката.
Контрольные точки хранятся локально и не связаны с Git. Используйте их только для отмены изменений, внесённых Agent; для постоянного контроля версий используйте Git.
Сообщения в очереди
Есть два способа общаться с Agent, пока он работает. Отправьте сообщение в очередь — оно будет ждать завершения текущей задачи. Отправить уточнение сейчас, и оно направит текущий шаг при следующем вызове инструмента Agent.
Использование очереди
- Пока Agent работает, введите следующую инструкцию
- Нажмите Enter, чтобы добавить её в очередь
- Сообщения отображаются в порядке очереди под активной задачей
- При необходимости перетаскивайте сообщения, чтобы изменить их порядок
- После завершения Agent обработает их по очереди
Сочетания клавиш
Пока Agent работает:
- Нажмите Enter, чтобы добавить сообщение в очередь (оно будет отправлено после завершения Agent текущей задачи)
- Нажмите Cmd+EnterCtrl+Enter, чтобы отправить сообщение сразу, минуя очередь
Немедленная отправка сообщений
При использовании Cmd+EnterCtrl+Enter для немедленной отправки ваше сообщение добавляется к последнему сообщению пользователя в чате и обрабатывается сразу, без постановки в очередь.
- Ваше сообщение прикрепляется к результатам работы инструментов и отправляется сразу
- Это делает работу со срочными уточнениями более удобной
- Используйте это, если нужно прервать или перенаправить текущую работу Agent
Управление работающим Agent
Вы можете отправить уточнение, чтобы направить Agent во время работы, не прерывая его. Введите уточнение и нажмите Отправить сейчас или дважды Enter. Сообщение будет доставлено при следующем вызове инструмента Agent, а не прервёт работу в середине действия, что сохраняет незавершённую работу и помогает Agent не отклоняться от задачи.
Эта возможность уже доступна на cursor.com/agents и постепенно появляется в Окне Agents. Чтобы поставить сообщение в очередь до завершения текущего шага, вместо этого нажмите Tab.
В CLI нажатие Enter во время работы Agent перенаправляет активный запуск в безопасный момент, а повторное нажатие Enter прерывает текущий шаг.
Цели с /goal
Agent воспринимает каждое сообщение как новую задачу. Используйте /goal, чтобы задать Agent долгосрочную цель, над которой он будет работать до полного выполнения:
/goal починить все нестабильные тесты и сделать CI зелёнымВ CLI Ctrl+C приостанавливает цель. Добавьте к цели пользовательский режим, если хотите, чтобы Agent следовал сценарию, или встроенный навык /loop для регулярных проверок состояния, пока Agent работает над достижением цели.
/goal внедряется постепенно. Если вы его не видите, попробуйте в новом чате.