Установка расширения Microsoft Copilot Studio для Microsoft Visual Studio Code

Замечание

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

Предпосылки

Перед установкой расширения Microsoft Copilot Studio для Microsoft Visual Studio Code убедитесь, что выполняются следующие требования:

Требования к системе

  • Операционная система:
    • Windows (архитектура x64)
      • Windows 10 версии 1809 или более поздней
      • Windows 11 (любая версия)
    • macOS
  • Visual Studio Code: версия 1.80 или выше (рекомендуется последняя стабильная версия)
  • Подключение к Интернету: требуется для установки и аутентификации

Требования к учетной записи

  • Учетная запись Майкрософт: активная учетная запись Майкрософт с лицензией Copilot Studio или доступом к Copilot Studio
  • Лицензия Copilot Studio: соответствующая лицензия назначена вашему аккаунту
  • Доступ к окружению: разрешения на доступ к как минимум одному окружению Copilot Studio
  • Права агента: права на чтение и запись к любым агентам, которых вы планируете редактировать

Этапы установки

Вы можете установить расширение Copilot Studio в Visual Studio Code двумя способами:

  • Установка из кода Visual Studio
  • Установка с сайта Visual Studio Code Marketplace

Способ 1. Установка через Visual Studio Code

  1. Выберите значок Расширения на панели действий или нажмите Ctrl+Shift+X. Область Расширения открывается в Visual Studio Code.

  2. В строке поиска введите «Copilot Studio». Найдите официальное расширение Copilot Studio в списке результатов. Проверьте, что издатель — «Microsoft».

  3. После того как вы найдете правильное расширение, выберите его, чтобы открыть страницу сведений о расширении.

  4. Выберите Установить, чтобы начать установку.

  5. Дождитесь завершения установки. Возможно, появится запрос на перезагрузку Visual Studio Code; в таком случае выберите Перезагрузить при появлении запроса.

  6. Проверка установки. Ищите значок Copilot Studio в панели действий. Значок отображается с фирменным стилем Copilot Studio.

Способ 2. Установка с веб-сайта Visual Studio Code Marketplace

  1. Перейдите по https://marketplace.visualstudio.com/ и выполните поиск по запросу «Copilot Studio». Вы также можете воспользоваться прямой ссылкой: https://marketplace.visualstudio.com/items?itemName=ms-CopilotStudio.vscode-copilotstudio.

  2. Выберите Install на странице маркетплейса. Браузер может предложить скачать Visual Studio Code до того, как будет предложено открыть Visual Studio Code.

  3. Разрешите браузеру открыть Visual Studio Code и проверьте установку, найдя значок расширения на панели действий.

Исходная конфигурация

Первый запуск

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

  2. Выберите «Войти » в всплывающем окне, затем выберите «Разрешить». Ваш браузер по умолчанию откроется на странице аутентификации Microsoft.

  3. Введите свои учетные данные для аутентификации и при необходимости завершите многофакторную аутентификацию.

  4. Просмотрите запрошенные разрешения:

    • Чтение и запись агентов Copilot Studio
    • Доступ к информации о среде
    • Синхронизация файлов с облаком

    Выберите Принять или Разрешить. Браузер сообщает, что вы можете закрыть окно и вернуться в Visual Studio Code.

  5. Вернитесь в Visual Studio Code. Панель расширения загружает среды, к которым у вас есть доступ, и агенты в этих средах.

Проверка установки

После аутентификации вы видите структуру под панелью Agents внутри расширения Copilot Studio в Visual Studio Code. Вы видите список групп окружений с вложенными средами и агентами, похожий на следующую структуру:

AGENTS
  └─ Environment Group (for example, developer, default, sandbox, production)
      ├─ Example Environment 1
      │   ├─ Agent 1
      │   └─ Agent 2
      └─ Example Environment 2
          └─ Agent 3

Устранение неполадок при установке

Следующие шаги по устранению неполадок решают некоторые проблемы, которые могут возникнуть при установке или настройке расширения Copilot Studio Visual Studio Code.

Расширение не отображается

Проблема: значок Copilot Studio не отображается на панели действий.

Solution:

  1. Перезагрузите Visual Studio Code.
  2. Выберите Расширения и найдите расширение в списке Установленные. Убедитесь, что расширение не отключено.
  3. Обновите Visual Studio Code до последней версии.
  4. Переустановите расширение.

Сбой при аутентификации

Проблема: аутентификация не проходит или зацикливается.

Solution:

  1. Очистите кэш браузера и удалите файлы cookie для microsoft.com.

  2. Попробуйте войти, используя другой браузер. Временно установите этот браузер по умолчанию.

  3. Отключите расширения браузера, которые могут блокировать аутентификацию.

  4. Проверьте настройки корпоративного брандмауэра и прокси-сервера.

  5. Убедитесь, что вы используете поддерживаемый тип учетной записи.

Расширение не найдено в маркетплейсе Visual Studio Code

Проблема: Вы не можете найти расширение Copilot Studio при поиске.

Solution:

  1. Убедитесь, что вы ищете в панели расширений , а не в веб-поиске.

  2. Проверьте написание: «Copilot Studio».

  3. Свяжитесь с вашим администратором, чтобы узнать, ограничивает ли ваша организация доступ к маркетплейсу Visual Studio Code.

Удаление расширения

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

  1. Откройте панель расширений.

  2. Найдите Copilot Studio в установленных расширениях.

  3. В записи списка выберите значок «Управление », а затем выберите «Удалить».

  4. Перезагрузите Visual Studio Code, когда будет предложено.

Замечание

Удаление расширения не удаляет локально клонированные файлы агентов. Вам нужно удалить эти файлы вручную.

Дальнейшие действия

После установки расширения и аутентификации с Copilot Studio вы готовы:

  • Last updated on