Расширение Microsoft Copilot с помощью действий соединителя (предварительная версия)

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

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

Для расширения возможностей помощника под брендом Microsoft с помощью действий соединителя необходимо выполнить несколько предварительных условий.

Общие предварительные требования

Для всех типов Copilot у вас должны быть учетные данные уровня создателя, лицензия на помощник и лицензия Microsoft Teams.

Предварительные условия для Dynamics 365 Customer Service и Copilot для продаж

Для Copilot для Dynamics 365 Customer Service и Copilot для продаж необходимо войти в среду, содержащую Copilot, который вы хотите расширить.

Предварительные требования для Copilot для продаж

• Клиентам Salesforce необходимо войти в свою среду Dataverse (обычно среда называется msdyn_viva).
• Вам необходимо выполнить вход в Copilot для продаж через Outlook в среде, которую вы хотите расширить, хотя бы один раз, прежде чем ее можно будет расширить.

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

Добавление действия соединителя к помощнику под брендом Microsoft требует выполнения нескольких шагов. В следующих разделах приведены инструкции по добавлению действия соединителя в Copilot для Microsoft 365, Copilot для продаж и Copilot для Dynamics 365 Customer Service.

Выбор интерфейса Copilot и выбор действия соединителя

1. На домашней странице выберите Помощники.

   

2. В списке «Помощники» на левой панели навигации выберите помощник под брендом Microsoft, возможности которого вы хотите расширить.

   

   Отображается страница обзора для Copilot.

   

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

4. Далее выберите для расширения Copilot с помощью действия.

   Для Copilot для Microsoft 365 выберите Добавить расширение, затем выберите Создать действие.

   Для других типов Copilot выберите Добавить действие.

   

   Вам предоставляется список всех поддерживаемых типов действий для этого Copilot.

   

5. Выберите Соединитель, чтобы расширить действие соединителя.

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

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

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

   Заметка

   В настоящее время пользовательские соединители нельзя использовать для расширения Copilot для Dynamics 365 Customer Service.

Выберите тип соединителя и выберите решение

1. Найдите тип соединителя с помощью панели поиска и выберите его.

   

   Откроется страница Создание пользовательского действия ИИ с использованием вашего соединителя.

2. Запишите имя и описание для вашего соединителя.

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

   

   Может быть предоставлено описание, если оно присутствует в выбранном вами соединителе. Помощник использует описание, чтобы определить, когда действие можно использовать для получения ответов на запрос пользователя. Сделайте описание как можно более подробным и описательным. Предоставьте конкретную информацию, используя термины, которые, как вы ожидаете, пользователи будут использовать при вызове действия. Чтобы продолжить пример почтовой службы, вы можете включить что-то вроде:

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

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

3. В разделе Решение в раскрывающемся списке будут перечислены все решения, доступные в текущей среде. Выберите решение, которое нужно использовать. Для получения дополнительной информации о том, что это за решения и почему они вам полезны, см. раздел Концепции решения.

   

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

   Заметка

   В этом случае вы не видите решение по умолчанию или решение по умолчанию CDS в качестве опции, поскольку мы рекомендуем использовать пользовательское решение для упрощения управления. Дополнительные сведения см. в разделе Решение по умолчанию и пользовательское решение.

4. Выберите решение и выберите Далее.

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

   

Добавление действий в соединитель

Далее вам необходимо выбрать одно из доступных действий для добавления в соединитель.

Заметка

Соединители могут выполнять только те действия, которые вы здесь специально выбираете и настраиваете. Если действия нет в списке, то оно недоступно. Невозможно добавлять или удалять действия из соединителя из мастера действий Copilot Studio.

1. Выберите действие для продолжения. Отображается страница Настройка вашего действия подключаемого модуля для выбранного действия.

   

2. Введите имя и описание для вашего действия. В этом случае имя не обязательно должно быть уникальным. Эти значения, скорее всего, будут заполнены для вас из соединителя. Однако, как и в случае с описанием соединителя, вы должны предоставить подробное конкретное описание, чтобы помощник знал, когда следует вызывать конкретное действие. Описание помогает использовать более естественный языковой подход к выбору действия для выполнения. Например, если действие — "Показать папки сообщений", вы можете использовать:

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

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

3. После завершения этой страницы выберите Далее. Отображается страница Проверка параметров вашего действия.

4. Выберите Далее, чтобы продолжить.

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

   

5. Выберите другое действие и при необходимости повторите шаги настройки предыдущего действия.

   Или же выберите Далее. Откроется экран Просмотр, тестирование и публикация вашего действия.

   

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

Тестировать

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

Заметка

В настоящее время Copilot в Dynamics 365 for Customer Service не позволяет тестировать изнутри мастера создания действия соединителя. Когда эта функция станет доступной, вы сможете протестировать подключаемый модуль с этого экрана. На данный момент пользователи должны опубликовать подключаемый модуль, а затем они смогут проверить его работоспособность в Copilot в Dynamics 365 for Customer Service сразу после его включения с помощью администратора.

1. Выберите существующее подключение из раскрывающегося списка или выберите + Создать подключение, если у вас нет никакого подключения.

   При выборе + Создать подключение открывается мастер, в котором вы можете добавить данные для создания подключения. Закончив, вы можете выбрать новое соединение из раскрывающегося списка.

2. Закончив выбор соединения, выберите Проверить действие.

3. Когда вы увидите сообщение о том, что действие готово к тестированию, выберите Открыть для тестирования, чтобы открыть чат Copilot в новом окне. Откройте всплывающее меню, чтобы увидеть действие, и включите его.

   Действие отображается со значком мензурки под выбранным соединителем в формате Имя тестирования действия.

4. Теперь вы можете протестировать подключаемый модуль, попробовав запросы, которые, как вы ожидаете, будет использовать пользователь. Вы также можете использовать команду –developer on, чтобы получить дополнительную информацию о выполнении запроса. Как только вы будете удовлетворены результатами, вернитесь в окно Copilot Studio.

Публикация

1. Завершив тестирование, выберите Опубликовать.

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

2. Выберите Перейти на страницу сведений, чтобы просмотреть сведения об опубликованном соединителе.

   Заметка

   Теперь, когда ваш соединитель опубликован, администратор должен включить его, чтобы его можно было использовать в помощнике. Если вы не видите соединитель в Copilot, убедитесь, что соединитель включен через Microsoft Admin Center или на странице расширений Copilot. После правильного включения соединитель отобразится во всплывающем окне. При первом выполнении шаг может возникнуть задержка до 24 часов.

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

   

4. При необходимости измените номер версии и выберите, должно ли решение быть управляемым или неуправляемым.

   • Управляемый означает, что вам не придется вносить дальнейшие изменения в решение.
   • Неуправляемый означает, что вы хотите внести изменения в решение в целевой среде.

5. По завершении вы видите зеленое сообщение с возможностью Загрузить решение, которое сохраняется в виде ZIP-файла в вашей системе.

   Заметка

   Вам не обязательно выбирать Опубликовать на панели решений.

6. Вернитесь на страницу Действия/Расширения Copilot в Copilot Studio и выберите Импорт решения в целевой среде.

   

7. Найдите и выберите ZIP-файл для экспортированного решения, затем выберите Далее, чтобы продолжить. В списке Действия/Расширения вы можете видеть появившийся соединитель.

Удалить действие соединителя

Если вам необходимо удалить действие соединителя, выполните следующую процедуру.

Найдите решение, используемое действием соединителя

Процедура удаления действия коннектора выполняется на портале Power Apps Maker. Однако вам необходимо решение, используемое для действия соединителя Copilot Studio.

1. Открыть Copilot Studio.

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

3. В разделе Copilots выберите Copilot, в котором было создано действие соединителя.

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

5. Выберите действие, которое вы хотите удалить, и запишите название решения.

   

Удалить соединитель в Power Apps портале Maker

1. Перейдите на портал Maker (https://make.powerapps.com) и выберите среду, которую вы использовали Copilot Studio для создания действий.

2. На панели навигации выберите Решения , чтобы просмотреть список решений в среде.

3. Найдите решение, которое вы использовали для создания действия, и выберите его.

   Вам представлен список объектов, связанных с решением.

4. Найдите действие соединителя, которое вы хотите удалить. Действие имеет тип AIPlugin.

   Совет

   Если вы не видите своего действия в решении, переведите действие из состояния черновика в состояние готово , опубликовав его.

5. Перед удалением действия необходимо удалить зависимость от таблицы AICopilot_AIPlugin . Сначала выберите Дополнительно>Показать зависимости.

   

   Отображаются зависимости для действия соединителя.

6. Для записи AICopilot_AIPlugin в списке зависимостей выберите Удалить.

   

7. Вернитесь к списку объектов и удалите действие, выбрав Удалить>Удалить из этой среды.

   

8. Удалите все операции типа AIPluginOperation в таблице, выбрав Удалить>Удалить из этой среды.

   

9. Вернитесь к Copilot Studio , чтобы убедиться, что действие удалено из представления Действия для второго пилота.

Заметка

Эта процедура удаляет плагин из списка Copilot. Однако это не приведет к удалению какого-либо соединения, созданного с источник данных.