Начало работы с режимом агента GitHub Copilot

С помощью режима агента GitHub Copilot в Visual Studio можно использовать естественный язык для указания высокоуровневой задачи. ИИ создает план, изменяет код, выполняет команды терминала, вызывает средства и применяет изменения в базе кода. Он отслеживает результаты, такие как результаты сборки, сбои модульного теста или выходные данные инструментов и выполняет итерацию по мере необходимости.

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

Prerequisites

Вам потребуется Visual Studio 2022 версии 17.14 или более поздней.

Использование режима агента

В режиме агента Copilot работает автономно и определяет соответствующий контекст запроса.

Выполните следующие действия, чтобы приступить к работе:

1. Откройте окно чата Copilot, выберите "Запросить ", чтобы развернуть раскрывающийся список режима, а затем выберите агент.

   

2. Введите запрос, а затем нажмите кнопку "Отправить " или выберите клавишу ВВОД , чтобы отправить ее. Вы можете указать высокий уровень требования, и вам не нужно указывать файлы, над которыми нужно работать.

3. Режим агента может вызывать несколько инструментов для выполнения различных задач. При необходимости выберите значок "Сервис" , чтобы настроить дополнительные средства, которые агент может использовать для реагирования на запрос.

   

4. Copilot запрашивает подтверждение перед выполнением команды в терминале или использования средства, которое не является встроенным.

   

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

6. Во время обработки вашего запроса, Copilot транслирует предлагаемые изменения кода напрямую в редактор. Просмотрите предложенные изменения и выполните следующие действия.

   • Сохраняйте или отменяйте предложенные изменения в целом в окне чата.

     

   • Просмотрите отдельные диффы файлов и примените их выборочно.

7. Если вы хотите просмотреть отдельные изменения кода, внесенные агентом, можно:

   • Просмотрите конкретные изменения на каждом шаге.

     

   • Просмотрите совокупные изменения с момента последнего применения или отмены изменений.

     

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

Общие сведения о средствах режима агента

Режим агента может использовать следующие средства для реагирования на запрос:

• Встроенные средства
• Средства протокола контекста модели (MCP)

Чтобы просмотреть средства, доступные в режиме агента, и управлять ими, выберите значок "Сервис " в окне чата.

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

Дополнительные средства, добавленные с помощью серверов MCP, не включены автоматически. Их флажки очищаются по умолчанию, и их необходимо выбрать для активации инструментов.

Управление утверждениями инструментов

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

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

Вы можете сбросить выборы подтверждения в панели Параметры инструментов. Разверните раздел «Все параметры»>«GitHub»>Copilot>Инструменты.

Принятие или отмена правок

Copilot перечисляет измененные файлы в списке общих изменений в окне чата.

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

Кроме того, в списке общих изменений выберите "Сохранить " или "Отменить " для всех изменений, внесенных с момента последнего выбора "Сохранить " или "Отменить".

Восстановление правок

При запросе изменений кода может потребоваться вернуть некоторые изменения. Чтобы вернуться, нажмите кнопку "Восстановить рядом с контрольной точкой" перед запросом, включающим изменения, которые не нужны.

В настоящее время агент Visual Studio Copilot не поддерживает пошаговые отмены или повтора.

Прерывание запроса режима агента

Чтобы прервать текущий запрос, его можно отменить. Отмена запроса останавливает все запущенные средства и команды терминала.

Чтобы остановить сборку, выберите " Сборка " на верхней панели инструментов и нажмите кнопку "Отмена". Или используйте сочетание клавиш CTRL+Break .

Планирование в режиме агента (предварительная версия)

Замечание

Планирование доступно в общедоступной предварительной версии с помощью Visual Studio 2022 версии 17.14. Эта функция находится в активной разработке и может развиваться на основе отзывов пользователей.

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

При активированном планировании Copilot работает:

• Создает план markdown для пользователя , который определяет цели и ход выполнения.
• Поддерживает внутренний план JSON (plan-{sessionId}.json) в виде блокнота, читаемого LLM, для отслеживания шагов, рассуждения и координации.

Эта структура помогает Copilot оставаться согласованной, обновлять план динамически и предоставлять разработчикам видимость того, что он делает.

Принцип работы

Анализ запросов

Если для задачи требуется несколько шагов, Copilot входит в режим планирования.

Создание плана

• План Markdown: описывает задачу, шаги и ход выполнения в доступном для чтения формате.
• План JSON: структурированный формат, читабельный для LLM, который фиксирует тот же план в форме, разбираемой машиной. Этот JSON-файл позволяет Copilot обновлять и интерпретировать план последовательно на каждом этапе.

Выполнение и итерация

Copilot выполняет каждый шаг плана, обновляя оба файла по мере продолжения.

• План Markdown обновляется заметно в редакторе.
• План JSON развивается за кулисами, когда Copilot обновляет, переупорядочивает или адаптирует шаги.

Хранение

Оба файла хранятся в C:\Users\username\AppData\Local\Temp\VisualStudio\copilot-vs.

Средства, используемые в планировании

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

Tool	Description
план	Создает исходный структурированный план из запроса пользователя.
адаптировать_план	Уточняет или корректирует план на основе нового контекста или обратной связи.
обновить_продвижение_плана	Обновляет состояние завершения шага и синхронизирует состояние плана.
запись_наблюдения	Записывает результаты среды выполнения или аналитические сведения, влияющие на следующие действия.
завершить_план	Завершает план после завершения всех шагов.

Эти средства позволяют Copilot управлять многоэтапными рабочими процессами постепенно, поддерживать состояние выполнения и оставаться в соответствии с намерением пользователя.

Включение средств планирования и управление ими

Чтобы включить планирование, выполните приведенные ниже действия.

1. Откройте панель инструментов Параметры, и разверните раздел Все настройки>GitHub>Copilot>Чат.

2. Установите флажок "Включить планирование ".

После включения планирования средства планирования отображаются в списке инструментов в окне чата:

Вы можете выборочно отключить набор средств планирования непосредственно в списке инструментов в окне чата. Если вам нужно отключить средства планирования, рекомендуется отключить все, а не только одно. Изменения применяются немедленно к текущему сеансу чата.

Подсказка

Отключение отдельных средств позволяет экспериментировать с различными поведениями планирования или выполнять отладку конкретных шагов во время разработки.

Ограничения

• Планы хранятся временно и удаляются при завершении сеанса, если они не сохранены вручную.
• Из-за структурированного отслеживания состояния существует небольшая задержка.
• Некоторые специализированные агенты пока не поддерживают планирование.

Оставить отзыв

Мы активно улучшаем планирование в режиме агента. Поделитесь своими отзывами, сообщайте о проблемах или предложите улучшения на странице: Планирование в Copilot Chat — сообщество разработчиков Visual Studio

Часто задаваемые вопросы

Какая видимость имеет режим агента в моих файлах?

Режим агента может управлять только следующими способами:

• Локальные файлы, которые являются частью решения.
• Локальные файлы, которые находятся в открытом каталоге решения или его подкаталогах.

Режим агента не может получить доступ к файлам и каталогам, исключенным с помощью исключения файлов.

Для команд терминала режим агента имеет те же разрешения, что и запущенный процесс Visual Studio, и не ограничивается предыдущими ограничениями. Внимательно просмотрите предложенные команды терминала перед их запуском.

В окне "Чат Copilot" не отображается режим "Запрос" и "Режим агента"

Выполните следующие действия по устранению неполадок в указанном порядке:

1. Убедитесь, что вы используете Visual Studio 17.14 или более поздней версии.

   • Проверьте версию в Справка>О Visual Studio.

   • Если вы не используете версию 17.14 или более поздней, откройте установщик Visual Studio и обновите сборку.

2. Убедитесь, что выбран режим включения агента в области чата .

   В разделе Инструменты>Параметры разверните раздел Все настройки>GitHub>Copilot>Copilot Chat и убедитесь, что параметр выбран.

3. Попробуйте перезапустить Visual Studio.

Когда следует использовать режим запроса или режим агента?

• Режим ask отлично подходит, если требуется 100% уверенность в отсутствии изменений кода, если вы явно не выберете "Применить " или скопируйте и вставьте код самостоятельно.
• Режим агента может обрабатывать те же концептуальные вопросы и создавать примеры кода, не применяя их, а также возможности агента редактирования кода.
• Если вы хотите использовать возможности MCP, необходимо выбрать режим агента.

Что случилось с редактированиями Copilot в Visual Studio?

Режим агента — это эволюция Copilot Edits, с большей способностью исправлять ошибки путем итерации, использовать инструменты и автоматически применять изменения кода.

Как администратор может управлять использованием режима агента для пользователей Visual Studio?

Режим агента в Visual Studio регулируется флагом Функции предварительного просмотра редактора на панели инструментов GitHub Copilot для администраторов. Если администратор отключает этот параметр, пользователи в этой подписке не могут использовать режим агента в Visual Studio.

Дополнительные сведения см. в разделе "Управление политиками и функциями для GitHub Copilot" в вашей организации.

Связанный контент

• Изменения GitHub Copilot
• Бесплатный GitHub Copilot