Поделиться через


Начало работы с GitHub Copilot для Azure

Начните работу с GitHub Copilot для Azure, чтобы упростить рабочий процесс разработки и повысить производительность на платформе Azure. В этом руководстве описаны предварительные требования и установка расширения GitHub Copilot для Azure в Visual Studio Code, чтобы вы могли написать первый запрос.

Предварительные условия

Чтобы выполнить действия, описанные в этой статье, убедитесь, что у вас есть:

Внимание

GitHub Copilot не входит в подписки Visual Studio и является отдельной подпиской, управляемой GitHub. Вопросы о подписках и поддержке GitHub Copilot см. в разделе "Отдельные подписки " или "Бизнес- подписки".

По умолчанию Copilot в Azure доступен всем пользователям в клиенте. Однако глобальные администраторы могут управлять доступом к Copilot в Azure для своей организации. Доступ также можно предоставить определенным пользователям или группам Microsoft Entra. Дополнительные сведения см. в статье "Управление доступом к Microsoft Copilot в Azure".

Установка GitHub Copilot для Azure

  1. В Visual Studio Code щелкните значок расширений.
  2. В Extensions Marketplace найдите GitHub Copilot для Azure. Когда появится расширение GitHub Copilot для Azure, нажмите кнопку "Установить".
  3. При появлении запроса войдите в учетную запись Azure.

Напишите первый запрос

  1. Убедитесь, что расширение установлено, что вы правильно прошли аутентификацию, и что расширение работает корректно.

  2. Если окно чата еще не открыто, убедитесь, что он открыт, нажав кнопку " Переключить чат" в строке меню, или выберите раскрывающийся список рядом с кнопкой "Переключить чат " и нажмите кнопку "Открыть чат" (CTRL+ALT+I).

    Снимок экрана: открытие меню

  3. В текстовой области чата в нижней части области чата введите следующий запрос:

    @azure Do I have any resources currently running?
    

    Снимок экрана: состояние режима запроса по умолчанию в области чата с примером запроса.

По умолчанию GitHub Copilot использует режим ask . Режим запроса предоставляет ответы на запросы в окне чата. Режим агента позволяет GitHub Copilot принять меры в рабочей области.

В режиме запроса @azure, это указывает на то, что вы хотите включить участника чата Azure в беседу. Он ограничивает область запроса для определенной области, а именно учетной записи Azure.

Ответ на ваш вопрос зависит от того, что в настоящее время работает в Azure в вашей подписке.

Режим агента

Начиная с Visual Studio Code версии 1.99, GitHub Copilot представил режим агента, агентический интерфейс, который может выполнять задачи во всей рабочей области Visual Studio Code, делая изменения, выполняя команды терминала и т. д.

GitHub Copilot для Azure предоставляет "инструменты" для GitHub copilot, чтобы улучшить агентический интерфейс с помощью глубокой интеграции с Azure.

В режиме агента вам не нужно указывать GitHub Copilot использовать GitHub Copilot для Azure с @azure префиксом.

Включение режима агента

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

  1. В Visual Studio Code откройте Настройки с помощью значка «Управление» (шестеренка).

    Снимок экрана: меню параметров Visual Studio Code, нажав кнопку

  2. В строке поиска параметров найдите chat.agent.enabled.

  3. Установите флажок рядом с агентом чата > : включено.

    Снимок экрана: диалоговое окно параметров с параметрами, отфильтрованными в chat.agent.enabled.

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

Существует три режима: запрос (по умолчанию), изменение и агент. Чтобы использовать режим агента, его необходимо выбрать в области чата.

  1. В панели чата в поле ввода чата выберите выпадающее меню режима и выберите Агент.

    Снимок экрана: всплывающее меню в поле чата с выбранным агентом.

  2. Область чата подтверждает, что в настоящее время вы находитесь в режиме агента.

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

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

    What are your tools?
    

    Ответ завершения отображает список средств GitHub Copilot, специфичных для Azure, доступных в GitHub Copilot. Ответ предоставляет хороший обзор типов функциональных возможностей, доступных для вас:

    I can assist you with various tasks using a range of tools. Here are the main tools I have available:
    
    1. Search and Navigation
      Semantic search for code or documentation
      File search using glob patterns
      Text search (grep)
      List directory contents
      Read file contents
      List code usages/references
    
    2. Code Editing and Analysis
      Insert edits into files
      Get errors in code files
      Test search (find test files)
    
    3. Terminal and Git Operations
      Run commands in terminal
      Get terminal output
      Get Git diffs and changed files
    
    4. Project Creation
      Create new workspaces
      Get project setup information
      Install VS Code extensions
      Create new Jupyter Notebooks
    
    5. Web and API Tools
      Fetch webpage content
      Get VS Code API references
    
    6. Azure Tools
      Azure development best practices
      Microsoft Learn documentation
      Azure resource management
      Azure authentication tools
      AI model deployment and management
      Azure Bicep schemas
      Service configuration and deployment
      Azure Developer CLI tools
    
    Would you like me to explain any specific tool in more detail or help you with a particular task?
    
    
  4. Последняя запись Azure Developer CLI toolsможет быть использована со следующим запросом:

    What is the az command to list all my storage accounts ordered by location?
    

    Завершение этой подсказки может создать следующее:

    
    I'll help you generate the Azure CLI command to list all your storage accounts ordered by location. Let me use the Azure CLI generator tool to get the correct syntax for this command.
    
    To list all your storage accounts ordered by location in Azure, you can use the following Azure CLI command:
    
    az storage account list --query "sort_by(@, &location)"
    
    This command will:
    
    1. Retrieve all storage accounts you have access to in your Azure subscription
    2. Sort the results based on the location (Azure region) of each storage account
    3. Display the full details of each storage account in the sorted order
    
    If you'd prefer a more concise output focusing on specific fields, you could modify the query. For example, to show only the name and location in a table format:
    
    az storage account list --query "sort_by(@, &location)[].[name,location]" -o table
    
    Make sure you're logged into the Azure CLI before running this command. If you're not logged in yet, you can do so with az login.
    
    

Включение и отключение средств в режиме агента

Вы можете отключить или повторно включить определенные средства, доступные GitHub Copilot для Azure.

  1. Выберите значок инструмента в области чата.

    Снимок экрана: панель чата с выделением вокруг значка инструмента.

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

    Снимок экрана: список инструментов в Visual Studio Code.

Рекомендации по работе в режиме агента

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

  • При появлении запроса добавьте в рабочую область файл copilot-instructions.md.

    Снимок экрана уведомления Visual Studio Code о добавлении файла инструкций Copilot в рабочую область.

  • Делайте ваши запросы максимально детализированными. Вместо запроса, например Generate a Python web application and deploy it to Azure, следует разбить их на несколько запросов с меньшей областью ответственности.

  • Разрешить GitHub Copilot делать работу (вместо того, чтобы делать это самостоятельно). Иногда GitHub Copilot запрашивает разрешение на выполнение задачи с кнопкой "Продолжить". Хотя вы можете выполнить эту задачу за пределами окна чата, вместо этого следует разрешить GitHub Copilot выполнять эту задачу. Это позволяет GitHub Copilot сохранять контекст текущего состояния более общего плана.

  • Разрешить GitHub Copilot повторяться. Иногда GitHub Copilot запрашивает разрешение на выполнение задачи неоднократно. Программа делает это, чтобы лучше понять состояние файлов проекта и определить, что следует сделать дальше. Необходимо разрешить GitHub Copilot повторять задачи, которые необходимо выполнить.

  • Укажите свои предпочтения. Если GitHub Copilot хочет выполнить действие, но вы предпочитаете выполнить другое действие, вы можете указать ему сделать это вашим предпочтительным способом. Например, если требуется создать папку для хранения файлов под названием \.azurebicep, можно вмешаться и попросить использовать другую папку с запросом, например:

    Instead of naming the folder `.azure`, please name it `infra`
    

Необязательный шаг: Установите вашего арендатора по умолчанию

Если у вас несколько арендаторов Microsoft Entra ID, можно задать арендатора по умолчанию с помощью следующего запроса:

@azure /changeTenant

Выберите из списка доступных арендаторов в выпадающем списке в верхней части по центру.

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

  1. В Visual Studio Code на панели действий выберите расширения. Затем прокрутите вниз до GitHub Copilot для Azure.

    Снимок экрана: GitHub Copilot для Azure в списке расширений в Visual Studio Code.

  2. Щелкните значок шестеренки в углу элемента расширения и выберите Параметры во всплывающем меню.

    Снимок экрана: всплывающее меню для GitHub Copilot для Azure.

  3. На вкладке "Параметры" задайте для клиента Azure Resource Graph идентификатор клиента Microsoft Entra. Идентификатор клиента Microsoft Entra можно найти в портале Azure.

    Снимок экрана: вкладка