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

Добавление ответа агента с помощью конструктора форм (предварительная версия)

[Данная статья посвящена предварительному выпуску и может быть изменена.]

Добавьте компонент ответа агента в форму приложения на основе модели, которая может напрямую вызывать тему Microsoft Copilot Studio и отображать ответ пользователю. Он основан на executeEvent API агента и упрощает использование, не требуя нового пользовательского компонента. Неявный контекст приложения, страницы и записи доступен в Copilot Studio.

Этот компонент поддерживает следующие ответы от Copilot Studio:

  • Разметка
  • Адаптивная карточка
  • Изображения
  • Видеоролики

Внимание!

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

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

Для приложений на основе модели должен быть включен параметр среды Предоставление пользователям возможности анализировать данные с помощью чата на базе ИИ в приложениях на основе холста и на основе модели. Больше информации: Параметры среды Copilot

Добавление компонента ответа агента в форму

  1. Откройте конструктор форм для создания или редактирования формы. Дополнительные сведения: Создание формы или Редактирование формы

  2. В конструкторе форм выберите Компонент на панели команд.

  3. На панели Компоненты разверните узел Искусственный интеллект

  4. Перетащите Ответ агента на холст формы.

    Ответ агента на панели компонентов.

  5. В диалоговом окне Добавить ответ агента введите Имя события из темы в Copilot Studio в поле Статическое значение. Дополнительные сведения: Поиск имени события для темы в Copilot StudioНастройка имени события ответа агента

    Примечание.

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

  6. Выберите Сохранить и опубликовать на панели команд.

  7. Откройте форму в приложении на основе модели, чтобы протестировать компонент.

    Примечание.

    При предварительном просмотре конструктора форм отображается предупреждение "Ответ агента доступен только при воспроизведении приложения", так как предварительный просмотр в реальном времени пока не поддерживается.

Поиск имени события для темы в Copilot Studio

  1. Откройте тему в Copilot Studio и найдите узел Триггер.

  2. Убедитесь, что выбран тип триггера Происходит пользовательское событие клиента или Получено событие.

  3. В узле Триггер выберите Изменить.

    Триггер пользовательского события клиента Copilot Studio.

  4. В области Свойства действия "При событии" скопируйте значение строкового свойства Имя события, которое будет передано из компонента ответа агента. Дополнительные сведения: Изменение триггера для темы

    Область свойства триггера по событию Copilot Studio.

Доступ к контексту приложения

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

Переменная Описаниен
Global.PA__Copilot_Model_PageContext.pageContext.id.guid Идентификатор записи таблицы в основной форме
Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName Логическое имя таблицы на главной странице
Global.PA__Copilot_Model_PageContext.pageContext.pageName Имя главной страницы
Global.PA__Copilot_Model_PageContext.pageContext.pageType Тип главной страницы
Global.PA__Copilot_Model_AppUniqueNameContext.appUniqueNameContext.appUniqueName Уникальное имя приложения на основе модели

Специальные возможности

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

Ограничения

Следующие свойства компонентов в настоящее время не поддерживается:

  • Label
  • Скрыть метку
  • Скрыть на телефоне
  • Заблокировать
  • Только для чтения
  • Ширина компонента
  • Высота компонента
  • Привязать к столбцу таблицы

Компонент не поддерживает передачу дополнительного контекста в MCS. Если требуется дополнительный контекст, создайте пользовательский PCF и используйте API агента executeEvent

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

Вопросы и ответы об API-интерфейсах агента и компоненте "Ответ агента"

executeEvent API агента

Обзор конструктора управляемых моделью форм
Добавление, настройка, перемещение или удаление компонентов в форме