Формулирование запросов для агентов

Управляйте агентом с помощью текстовых промптов в поле ввода чата. В любой момент можно прикрепить контекст, изображения и голосовые сообщения, а также переключить модель.

@-упоминания

Введите @ в поле ввода чата, чтобы прикрепить к промпту нужный контекст. Начните вводить текст после @, и Cursor покажет подходящие варианты.

• Файлы и папки: @auth.ts или @src/components/, чтобы включить файлы или папки (после выбора папки введите /, чтобы перейти глубже)
• Терминалы: @Terminals, чтобы включить в контекст выходные данные терминала
• Чаты: @Chats, чтобы использовать контекст из предыдущего диалога
• Git-диффы: @Commit (Diff of Working State) для незакоммиченных изменений или @Branch (Diff with Main) для полного диффа ветки
• Браузер: @Browser, чтобы прикрепить к��нтекст из встроенного браузера

Используйте @-упоминания, если знаете, какие файлы нужны. Если не уверены, какие файлы важны, пропустите этот шаг — Agent сам найдёт подходящие файлы.

Пользовательские режимы

Введите / в поле ввода чата, чтобы вызвать навык. Нажмите Enter, чтобы прикрепить навык к одному сообщению: по мере продолжения диалога он исчезнет. Используйте любой навык как Пользовательский режим, чтобы Agent сохранял на нём фокус во время работы.

Вместо этого выберите навык в меню / и нажмите Option+EnterAlt+Enter (Mac) или Alt+Enter (Windows). В режиме навык остаётся в контексте на каждом шаге, даже если Agent работает часами, пока вы не выйдете из режима. Также можно выбрать Использовать как режим в пункте навыка.

Пользовательские режимы хорошо подходят для описания процесса работы, а не для разовых задач. Оставьте активным чек-лист ревью кода при работе с несколькими файлами или включите командный плейбук, например /tdd, на время работы над всей функцией.

Пользовательские режимы доступны в Окне Agents и CLI. Любой навык с допустимым блоком фронтматтера может лежать в основе режима, а необязательные поля фронтматтера icon и color оформляют значок режима. См. Использование навыка как Пользовательского режима.

Ввод изображений

Прикрепляйте изображения к промпту, чтобы предоставить визуальный контекст при работе с UI, отладке и реализации дизайна.

• Перетащите файл изображения в поле ввода чата
• Вставьте из буфера обмена с помощью Cmd+VCtrl+V, в том числе скриншоты

Это удобно для реализации макетов, отладки визуальных проблем и просмотра сообщений об ошибках или стека вызовов без ручной расшифровки.

Голосовой ввод

Нажмите значок микрофона в поле ввода чата, чтобы надиктовать промпт вместо того, чтобы печатать. Говорите естественно, указывайте технические детали, например названия файлов и функций, и проверьте расшифровку перед отправкой.

Использование контекста

У каждого чата с моделью фиксированное контекстное окно. По мере добавления файлов, запуска инструментов и обмена сообщениями оно заполняется токенами. Когда окно почти заполнено, Cursor сжимает предыдущие части диалога в сводку, чтобы освободить место для продолжения диалога.

Индикатор контекста рядом с полем ввода промпта позволяет сразу увидеть, насколько заполнено окно. Нажмите на индикатор, чтобы открыть панель с разбивкой общего числа использованных токенов по категориям:

• Системный промпт: встроенные инструкции Cursor для модели
• Инструменты: определения всех инструментов, доступных Agent
• Правила: правила проекта и пользователя, включённые в промпт
• Навыки: описания навыков, добавленные в системный контекст
• MCP: инструкции и каталог подключённых MCP‑серверов
• Субагенты: документация по типам субагентов, которых может запускать Agent
• Сводка диалога: сжатые сводки предыдущих шагов
• Диалог: ваши сообщения, ответы Agent и результаты работы инструментов

Наведите указатель на сегмент индикатора или строку в списке, чтобы выделить соответствующую категорию.

Смена моделей

Чтобы переключить модель, воспользуйтесь выпадающим списком выбора модели в верхней части поля ввода чата или нажмите Cmd /Ctrl /, чтобы последовательно переключаться между моделями. Изменение будет применяться к текущему диалогу. Модель по умолчанию можно задать в Cursor Settings > Models.

• Быстрые модели хорошо подходят для быстрых правок и типовых задач
• Более мощные модели лучше подходят для сложных рассуждений и рефакторинга нескольких файлов

Модели можно переключать в ходе диалога: например, если быстрая модель помогла с исследованием, но для реализации требуется более глубокое рассуждение. Полный список моделей см. в разделе Models & Pricing.