Установка Copilot Agent Kit

Copilot Agent Kit — это открытый набор инструментов для тестирования и оценки агентов Copilot Studio. Например, он помогает определять тестовые случаи, моделировать пользовательские запросы и проверять ответы агентов. В этой статье представлены пошаговые инструкции по установке набора с Marketplace или GitHub, а также шаги и настройки после развертывания.

Note

Перед тем как скачать и установить Copilot Agent Kit, убедитесь, что вы соответствуете всем требованиям.

Установите набор агентов Copilot с Marketplace

Если вы предпочитаете установить Copilot Agent Kit с GitHub, перейдите к Install Copilot Agent Kit с GitHub.

Развертывание с Marketplace

Чтобы развернуть Copilot Agent Kit из Marketplace, следуйте следующим шагам:

  1. Зайдите в набор агентов Copilot в Marketplace.
  2. Выберите Получить сейчас.
  3. При необходимости войдите в систему.
  4. В просмотре Install Copilot Agent Kit выберите среду, в которой хотите развернуть Copilot Agent Kit.
  5. Ознакомьтесь с условиями и заявлениями. Если согласны, установите флажки и выберите Установить.

Начинается установка Copilot Agent Kit.

Шаги после развертывания (Marketplace)

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

  1. Войдите в Power Apps.
  2. Перейдите в раздел Решения.
  3. Выберите Решение по умолчанию.
  4. Выберите ссылки на соединения.
  5. Найдите Copilot Agent Kit - Dataverse и откройте его для редактирования.
  6. Убедитесь, что все обязательные поля заполнены, и выбранное подключение действительно. При необходимости создайте новое подключение к Dataverse.
  7. Нажмите Сохранить.
  8. Следуйте дальнейшим и необязательным шагам по настройке.

Установите Copilot Agent Kit с GitHub

Следуйте этим шагам, чтобы установить Copilot Agent Kit с GitHub. Если вы предпочитаете устанавливать с Marketplace, перейдите в раздел Install Copilot Agent Kit на Marketplace.

Загрузка последнего выпуска GitHub

Скачайте последнюю версиюуправляемого решения для Power CAT Copilot Agent Kit.

Установка управляемого zip-файла Copilot Agent Kit

Чтобы установить управляемое решение Copilot Agent Kit:

  1. Войдите в Power Apps.
  2. Выберите среду, в которую хотите установить Copilot Agent Kit.
  3. Перейдите в раздел Решения.
  4. Выберите Импорт решения.
  5. Нажмите кнопку "Обзор".
  6. Выберите файл CopilotStudioKit*_managed.zip.
  7. Нажмите кнопку Далее.
  8. После просмотра информации о решении выберите Далее.
  9. Если будет предложено, создайте необходимые подключения и выберите Импорт.
  10. Значения отчета по КПЭ разговоров пока что оставьте без изменений. Вы можете обновить эти значения позже.
  11. Дождитесь завершения операции импорта.

Обновление существующего решения (GitHub)

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

  1. Войдите в Power Apps.
  2. Выберите окружение, в котором хотите улучшить комплект агента Copilot.
  3. Перейдите в раздел Решения.
  4. Выберите Импорт решения.
  5. Нажмите кнопку "Обзор".
  6. Выберите CopilotStudioKit*_managed.zip.
  7. Нажмите кнопку Далее. Power Apps определяет, что это обновление относится к существующему управляемому решению.
  8. Подтвердите обновление существующего решения, выбрав Далее.
  9. Значения отчета по КПЭ разговоров пока что оставьте без изменений. Вы можете обновить эти значения позже.
  10. Выберите Импортировать.

Note

При обновлении Copilot Agent Kit вы можете столкнуться со следующей ошибкой: Решение «Power CAT Copilot Agent Kit» не сработало: ImportAsHolding не удалось импортировать: Нельзя удалить атрибут: cat_copilottestrunid из Entity: cat_CopilotTestRun, поскольку атрибут не является пользовательским полем.

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

Дополнительные и необязательные шаги настройки

Эти этапы настройки применимы независимо от того, установили ли вы Copilot Agent Kit с Marketplace или GitHub.

Подсказка

Copilot Agent Kit включает мастер настройки для настройки ссылок на соединения, переменных среды и облачных потоков. Узнайте больше о Мастере настройки.

Настройка синхронизации с SharePoint

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

Направьте подключение к SharePoint на исходный сайт SharePoint. Направьте URL-адрес Dataverse на экземпляр Dataverse для целевых пользовательских агентов, где синхронизируется контент.

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

Чтобы использовать функцию синхронизации с SharePoint:

  1. Установите набор Copilot Agent Kit, описанный ранее в этой статье.
  2. Войдите в Power Apps.
  3. Перейдите в раздел Решения.
  4. Выберите Решение по умолчанию.
  5. Выберите ссылки на соединения.
  6. Найдите ссылку на соединение Copilot Agent Kit - SharePoint и откройте его для редактирования.
  7. Убедитесь, что все обязательные поля заполнены, и выбранное подключение действительно. Создайте новое подключение к SharePoint, если потребуется.
  8. Нажмите Сохранить.

Дополнительная информация: Узнайте о настройке агентов в Copilot Agent Kit, включая настройку нового агента для синхронизации файлов.

Настройка Инвентаризации агентов

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

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

  • Copilot Agent Kit - Power Platform for Admins загружает список сред в арендаторе. Требуются разрешения уровня администратора Power Platform.
  • Copilot Agent Kit — Dataverse собирает информацию об агентах из окружений. Требуются разрешения уровня системного администратора для всех сред.

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

Для использования функции "Инвентаризация агентов":

  1. Установите набор Copilot Agent Kit, описанный ранее в этой статье.
  2. Войдите в Power Apps.
  3. Перейдите в раздел Решения.
  4. Выберите Решение по умолчанию.
  5. Выберите ссылки на соединения.
  6. Найдите ссылку на подключение Copilot Agent Kit - Power Platform for Admins и откройте его для редактирования.
  7. Убедитесь, что все обязательные поля заполнены, и выбранное подключение действительно.
  8. Нажмите Сохранить.
  9. Найдите ссылку на соединение Copilot Agent Kit - Dataverse и откройте его для редактирования.
  10. Убедитесь, что все обязательные поля заполнены, и выбранное подключение действительно.
  11. Нажмите Сохранить.

Включение потоков

Note

Если вы планируете использовать синхронизацию с SharePoint, настройте синхронизацию с SharePoint перед включением соответствующих потоков (их названия начинаются с Синхронизация с SharePoint).

Чтобы включить облачные потоки, включённые в комплект агентов Copilot, выполните эти шаги или воспользуйтесь мастером настройки.

  1. Установите набор Copilot Agent Kit, описанный ранее в этой статье.
  2. Войдите в Power Automate.
  3. Убедитесь, что окружение с набором агентов Copilot выбрано.
  4. Выберите решения.
  5. Выберите Copilot Agent Kit.
  6. Выберите Облачные потоки.
  7. Убедитесь, что все потоки включены (состояние = вкл).
  8. Включите потоки, которые не включены, в следующем порядке:
    1. Потоки, названия которых заканчиваются словом внучатый.
    2. Потоки, названия которых заканчиваются словом дочерний.
    3. Остальные потоки по мере необходимости, в любом порядке.

Настройка Центра соответствия

Чтобы настроить Compliance Hub, следуйте шагам в разделе «Настройка и настройка Copilot Agent Kit Compliance Hub». Для работы Центра соответствия требуется Инвентаризация агентов.

Настройка встроенной панели мониторинга КПЭ разговоров

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

В ходе выполнения шагов запишите следующие значения:

  • Имя рабочего пространства
  • GUID рабочей области
  • Название отчета
  • GUID отчета

Публикация отчета

Чтобы опубликовать отчет по КПЭ разговоров:

  1. Установите набор Copilot Agent Kit, описанный ранее в этой статье.

  2. Скачайте Conversation.KPIs.zip из GitHub репозитория Power CAT Copilot Agent Kit.

  3. Извлеките содержимое файла .zip.

  4. Откройте файл Conversation KPIs.pbit в приложении Power BI Desktop.

  5. Введите URL-адрес Dataverse в соответствующее поле как URL-адрес среды в появившемся диалоговом окне и нажмите Загрузить (например, org3c23948.crm.dynamics.com, без префикса https://).

    Если диалоговое окно не появилось, введите URL-адрес среды, выбрав Главная>Преобразование данных>Изменить параметры.

  6. Обновите данные и войдите в систему, если необходимо.

  7. Сохраните и опубликуйте отчет в рабочей области.

  8. Запишите имя отчета и имя рабочего пространства.

  9. Войдите в Power BI.

  10. Откройте опубликованный отчет и запишите GUID рабочей области и GUID отчета из URL-адреса.

    Если вы опубликовали отчет в "мою рабочую область", GUID рабочей области будет 00000000-0000-0000-0000-000000000000.

  11. Выберите три точки (...), затем выберите Просмотреть семантическую модель.

  12. Откройте Файл>Параметры.

  13. Убедитесь, что в учетных данных источника данных нет никаких проблем. Если проблемы есть, войдите в систему и устраните их.

  14. Перейдите в раздел Обновление и установите график обновления.

Обновление переменной среды отчета

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

  1. Войдите в Power Apps и выберите среду, в которую вы установили Copilot Agent Kit.
  2. Выберите Решения>Решение по умолчанию.
  3. Выберите Переменные среды.
  4. Найдите и выберите Отчет по КПЭ разговоров.
  5. Замените значения-заполнители в значении по умолчанию значениями Имя рабочей области, GUID рабочей области, Имя отчета и GUID отчета, которые вы записали во время публикации.
  6. Нажмите Сохранить.

Узнайте о настройке агентов в Copilot Agent Kit, включая то, как настроить новый агент для ключевых показателей Conversation KPI.

Доступ к приложению Copilot Agent Kit

Чтобы получить доступ к приложению Copilot Agent Kit:

  1. Войдите в Power Apps и выберите среду, в которую вы установили Copilot Agent Kit.
  2. Перейдите в раздел Приложения.
  3. Найдите и выберите Power CAT Copilot Agent Kit.
  4. Нажмите кнопку Воспроизвести.
  5. (Optional) Добавьте приложение в закладки.

Поделиться приложением Copilot Agent Kit

После подтверждения успешного запуска приложения владелец (или системный администратор, установивший Kit) должен поделиться приложением Copilot Agent Kit с командой.

  1. Войдите в Power Apps.
  2. Выберите Приложения.
  3. Найдите «Copilot Agent Kit» и найдите тот, где есть тип Code (не приложение, управляемое моделями).
  4. Выберите три точки (), а затем выберите Поделиться рядом с именем приложения.
  5. Найдите и добавьте пользователей или группы безопасности, которым нужен доступ.
  6. Выберите Поделиться для подтверждения.

Подробнее: Предоставление доступа к приложению на основе холста в вашей организации.

Следующий шаг