Клонирование агента Microsoft Copilot Studio в Microsoft Visual Studio Code

Замечание

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

Когда вы клонируете агент из Microsoft Copilot Studio с помощью расширения, вы загружаете определение агента и связанные определения компонентов из Copilot Studio на ваш локальный компьютер. Вы можете редактировать эти файлы с помощью Microsoft Visual Studio Code. Операция клонирования создает локальное рабочее пространство со всеми файлами агента, расположенными в структурированной папке.

Предпосылки

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

Выберите расположение рабочей области

Выберите подходящую локальную папку для файлов агентов. В выбранной папке расширение сохраняет файлы агента. Вот несколько важных рекомендаций по выбору локальной папки:

  • Убедитесь, что на диске достаточно места. Типичный агент может варьироваться по размеру в зависимости от количества компонентов.
  • По возможности используйте путь без пробелов, хотя пробелы поддерживаются.
  • Рассмотрите возможность использования каталога, который уже отслеживается Git.

Поймите, что клонируется.

Когда вы клонируете агента, его файлы клонируются локально в выбранную вами папку, создавая структуру, подобную приведенной ниже в обозревателе Visual Studio Code:

my-agent/
├── actions                   # Connectors
│   ├── DevOpsAction.mcs.yml  
│   └── GetItems.mcs.yml      
├── knowledge/files                # Knowledge sources
│   ├── source1.yaml
│   └── source2.yaml
├── topics/                   # Conversation topics
│   ├── greeting.mcs.yaml
│   ├── help.mcs.yaml
│   └── escalate.mcs.yaml
├── workflows/                    # Agent tools and actions
│   └── GetDevOpsItems
│       ├── metadata.yaml
│       └── workflow.json
│   └── GetMeetings
│       ├── metadata.yaml
│       └── workflow.json
├── trigger/                 # Event triggers
│   └── welcometrigger.mcs.yaml
├── agent.mcs.yaml                # Main agent definition
├── icon.png                      # Icon used for the agent, visible in test panel and in supported channels
├── settings.mcs.yml              # Configuration settings for the agent
└── connectioreferences.mcs.yml   # Connection References used by Connectors and other actions

Методы клонирования

Если вы используете расширение впервые или только начали работать с Visual Studio Code, самый простой способ клонировать агент — выбрать Клонировать агент, когда открыта панель Расширения. Однако эта опция недоступна, если у вас уже клонирован агент и он открыт локально. Вместо этого можно использовать следующие методы:

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

  1. Откройте расширение Copilot Studio, выбрав значок Copilot Studio в панели активности. Вы также можете нажать Ctrl+Shift+P и ввести «Copilot Studio: фокус на представление агентов». Панель Copilot Studio открывается в боковой панели.

  2. В панели Агенты выберите целевую среду из раскрывающегося списка (например, «Среда 1»), чтобы увидеть список агентов в этой среде.

    > Environment 1
  Environment 2
  Environment 3

  3. Выберите агента для клонирования из списка. Агенты отображают дату последнего изменения. Щелкните правой кнопкой мыши по имени агента и выберите Клонировать агент.

    > Customer Support Agent
    HR Assistant
    Sales Agent
    IT Helpdesk Agent

    Открывается диалог средства выбора файлов.

  4. Перейдите в нужное место в диалоге средства выбора файлов или создайте новую папку и выберите Выбрать папку. Начинается процесс клонирования.

  5. Дождитесь завершения процесса клонирования. Появляется уведомление о ходе процесса с текстом: «Клонирование агента: бот поддержки клиентов», а затем сообщение об успешном завершении: «Агент успешно клонирован». Обычно этот процесс занимает 10–30 секунд.

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

Метод 3. Клонирование с помощью палитры команд

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

  1. Откройте палитру команд, нажав Ctrl+Shift+P.

  2. Введите «Copilot Studio: клонировать агент» и нажмите Enter. Команда выполняется, и появляются подсказки.

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

Метод 3. Клонирование с использованием URL-адреса агента

Этот метод удобен, когда вам предоставляют URL-адрес агента.

  1. Откройте агент в веб-портале Copilot Studio.

  2. Выберите Настройки>Сведения об агенте, и скопируйте URL-адрес агента. URL-адрес должен иметь формат: https://copilotstudio.microsoft.com/environments/{guid}/bots/{guid}. URL-адрес теперь находится в вашем буфере обмена.

  3. Вернитесь в Visual Studio Code и откройте расширение Copilot Studio.

  4. Выберите Клонировать агент. Расширение обнаруживает URL-адрес в вашем буфере обмена и отображает агент, помеченный как «(из буфера обмена)».

  5. Выберите агент, помеченный «(из буфера обмена)», выберите папку назначения и дождитесь завершения клонирования. Агент клонируется в выбранную вами папку.

Распространенные сценарии клонирования

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

Сценарий 1. Клонирование для индивидуальной разработки

Цель: самостоятельная работа с агентом

  1. Клонируйте агента в локальную папку.

  2. Инициализируйте репозиторий Git с панели управления версиями в навигации.

  3. Внесите изменения локально.

  4. Зафиксируйте изменения.

  5. Примените изменения в Copilot Studio, когда будете готовы.

Сценарий 2. Клонирование агента для командной работы

Цель: несколько разработчиков работают над одним агентом

  1. Первый разработчик клонирует агент.

  2. Первый разработчик инициализирует Git и отправляет содержимое в общий репозиторий (GitHub, Azure DevOps).

  3. Другие разработчики клонируют из общего репозитория Git.

  4. Каждый разработчик выполняет команду Copilot Studio: переподключить агент, чтобы подключить свою локальную папку к Copilot Studio.

  5. Команда использует Git для совместной работы и отслеживания изменений, а для работы с агентом — расширение Visual Studio Code.

  6. Затем каждый разработчик вносит изменения в Copilot Studio для тестирования или отправляет их в другую целевую среду в зависимости от жизненного цикла разработки программного обеспечения или автоматизированных конвейеров.

Сценарий 3. Клонирование нескольких сред

Цель: управление версиями для разработки, тестирования и производства

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

  1. Клонируйте агент из среды разработки в локальную папку разработки.

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

  3. Примените эти изменения и протестируйте их в той же среде.

  4. Используйте Copilot Studio: переподключить агент, чтобы подключить агент к альтернативной среде.

  5. Протестируйте агент в тестовой панели Copilot Studio.

Лучшие практики

Делай

  • Клонируйте все агенты в согласованное место.
  • Инициализируйте Git сразу после клонирования.
  • Используйте понятное имя папки.
  • Проверьте, работает ли клон, прежде чем вносить изменения.
  • Храните резервную копию папки клона (например, в GitHub или Azure DevOps).
  • Задокументируйте местоположение вашего клона во внутренней командной вики или документации.

Не

  • Не клонируйте во временные каталоги.
  • Не клонируйте несколько раз в разные каталоги. Это может вызвать путаницу.

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

После клонирования агента:

  • Last updated on