Добавление действий для бота, используя Power Automate

Выберите версию Power Virtual Agents, которую вы используете, здесь:

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

Вы вызываете потоки изнутри тем, как дискретные узлы Вызов действия. Вы можете использовать потоки, которые уже были созданы в вашей среде Power Apps, или вы можете создать поток изнутри холстов разработки Power Virtual Agents.

Важно!

Чтобы использовать потоки внутри Power Virtual Agents, они должны соответствовать следующим требованиям:

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

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

Создание нового потока из холста разработки Power Virtual Agents

  1. Перейдите на страницу тем для бота, которого вы хотите редактировать.

  2. Откройте холст разработки для темы, из которой вы хотите вызвать поток.

  3. Выберите кнопку плюс (+) под существующим узлом, чтобы добавить новый узел.

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

    Создание нового потока Power Automate.

При использовании параметра Создать поток открывается стартовый шаблон потока на портале Power Automate в отдельной вкладке.

Шаблон потока Power Automate.

Примечание

Портал Power Automate автоматически открывается в той же среде, что и бот (с использованием тех же учетных данных пользователя).

Этот шаблон является примером потока, который может использоваться ботами. Чтобы быть подходящим для ботов, поток Power Automate требует специального триггера Power Virtual Agents и действия ответа:

  • Триггер потока: Power Virtual Agents

    Триггер Power Virtual Agents.

  • Действие ответа: Power Virtual Agents

    Отклик Power Virtual Agents.

Входные и выходные параметры

Не существует верхнего предела количества входных или выходных параметров потока Power Automate для бота. Боты могут использовать следующие типы входов и выходов с потоками Power Automate:

  • Номер
  • String
  • Boolean

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

  • Объект
  • Дата
  • Метка времени
  • List [String]
  • List [Number]
  • List [Boolean]
  • List [Object]
  • List [Date]
  • List [Timestamp]

Примечание

Бот может получить до 1 МБ данных от потока Power Automate в одном действии. Не существует верхнего предела максимального размера данных, которые бот может передать потоку Power Automate.

Входные параметры

Чтобы указать поток для приема входных параметров от бота, выберите параметр Добавить вход в пользовательском интерфейсе Триггер Power Virtual Agents, затем выберите тип — string, number или boolean.

Типы входных триггеров Power Virtual Agents.

Например, вы можете выбрать Текст и Число ,чтобы добавить следующие входные параметры в поток:

  • String_Input типа string
  • Number_Input типа number

Входы триггера Power Virtual Agents.

Выходные параметры

Чтобы вернуть боту выходные параметры, которые могут быть типа string, number или boolean, выберите параметр Добавить выход в пользовательском интерфейса Ответ Power Virtual Agents, затем выберите тип выходного параметра.

Выходные типы ответов Power Virtual Agents.

Например, вы можете выбрать Текст и Число ,чтобы добавить следующие выходные параметры в поток и назначить их возвращаемые значения.

  • String_Output типа string
  • Number_Output типа number

Выходные параметры ответов Power Virtual Agents.

В этом примере создается полностью функциональный поток, который принимает два параметра: stringи number, и возвращает их в бот в качестве выходных данных.

Выберите Сохранить, чтобы сохранить новый поток.

Шаблон потока Power Automate — Сохранить.

Ваш поток сохранен в Решении по умолчанию на вкладке Решения на портале Power Automate.

Шаблон потока Power Automate — решение по умолчанию.

Потоки, созданные из холста разработки Power Virtual Agents, сразу же доступны для бота

Все потоки, созданные из холстов разработки Power Virtual Agents, сохраняются в Решении по умолчанию в Power Automate. Они могут быть использованы вашими ботами немедленно.

В Power Virtual Agents теперь вы можете увидеть этот новый поток в списке доступных действий при использовании Узла вызова действия на холсте разработки.

Новый поток отображается в средстве выбора действий.

При желании можно переместить поток из решения по умолчанию в другое решение

Чтобы быть доступными для ваших ботов, потоки должны храниться в решении в Power Automate. Если вы не хотите использовать Решение по умолчанию для этого, вы можете переместить свои потоки в другое решение.

Перемещение потока в новое или существующее решение:

  1. На портале Power Automate перейдите на вкладку Решения, где вы можете увидеть доступные решения. Используйте любое из существующих решений или создайте новое решение для своих потоков.

  2. Для создания нового решения выберите Создать решение.

    Создание решения.

  3. Дайте вашему новому решению имя, выберите Издатель CDS по умолчанию в поле Издатель, введите номер Версии, затем выберите Создать.

    Сохранение нового решения.

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

    Добавление существующего меню.

  5. На странице Добавить существующий поток выберите вкладку Из решений, затем выберите свой поток. Выберите Добавить, чтобы добавить свой поток в решение.

    Добавление потока в решение.

    Чтобы переместить поток из вкладки Мои потоки в решение, выберите параметр Внешние решения. Выберите Добавить, чтобы добавить свой поток в решение.

    Добавление потока из внешних решений.

Изменение потока на портале Power Automate

Вы можете переименовать и изменить свой поток на портале Power Automate. Например, поток, который вы только что создали с помощью шаблона, может быть обновлен для предоставления прогноза погоды при вызове из бота.

  1. В Power Virtual Agents можно открыть поток с помощью ссылки Просмотр сведений о потоке потока в списке доступных действий при использовании Узла вызова действия на холсте разработки.

    Изменение потока из средства выбора действий.

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

    Изменение потока из узла действия.

    При использовании ссылки Просмотр сведений о потоке запускается портал Power Automate в отдельной вкладке браузера, и открывается поток на странице Сведения, где вы можете изменить его, используя команду Изменить.

    Отредактируйте свой поток, используя страницу сведений.

    Если вы хотите открыть поток на портале Power Automate, перейдите на вкладку Решения, а затем откройте решение вашего потока. Используйте меню Изменить потока, чтобы открыть поток для редактирования.

    Открытие потока для редактирования.

  2. Переименуйте поток на Получить прогноз погоды, затем добавьте следующие входные параметры потока в триггер Power Virtual Agents:

    • Город (строка)
    • Почтовый индекс (число)

    Добавить входные данных в поток.

  3. Выберите Добавить действие, чтобы создать новое действие под триггером Power Virtual Agents.

    Добавление действия потока.

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

    Добавление действия "Получить прогноз".

  5. Новый соединитель MSN Погода добавляется в поток. В поле Расположение выберите Добавить динамический контент. Выберите Город и Почтовый индекс в списке.

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

  6. В узле ответа Вернуть значения в Power Virtual Agents добавьте выходные параметры, которые вы хотите вернуть в бот. Сохраните свой поток.

    • day_summary (Стока)
    • location (Строка)
    • chance_of_rain (Число)

    Добавление динамических переменных в ответ потока.

Этот поток теперь готов к использованию в ваших ботах.

Вызовите поток Power Automate как действие из бота

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

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

Вызов потока из темы:

  1. В Power Virtual Agents перейдите на страницу тем для бота, которого вы хотите редактировать.

  2. Создайте новую тему и назовите ее Получить погоду.

  3. Добавьте следующие триггерные фразы:

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

    Создать новую тему.

  5. По умолчанию узел сообщения создан. Введите Я могу помочь вам с этим в узел, затем выберите плюс (+), чтобы добавить новый узел.

    Снимок экрана добавления узла.

  6. Добавьте два новых узла Задать вопрос, чтобы спросить пользователей о входных параметрах Город (Строка) и Почтовый индекс (число).

    Добавление вопросов для диалога темы.

  7. Выберите кнопку плюс (+) под узлами вопросов, чтобы добавить новый узел. В окне выбора узла выберите Вызов действия, затем выберите созданный ранее поток, который называется Получить прогноз погоды.

    Действие вызова.

  8. Сопоставьте входные блоки потока с выходными переменными из узлов вопросов. Город (текст) получает свое значение из переменной Var1 (text), а Почтовый индекс (число) получает свое значение из переменной Var2 (number).

  9. Под узлом потока добавьте узел Сообщение, затем введите сообщение, которое использует выходные данные потока. Например:

    Прогноз на сегодня для (x)location:{x}day_summary. Вероятность дождя {x}chance_of_rain%

    Введите переменные.

  10. Выберите Сохранить, чтобы сохранить тему.

Передача литеральных значений в поля ввода действия

В качестве альтернативы, если вы предпочитаете вводить литеральное значение для ввода действия вместо использования переменной в качестве ввода действия, вы можете ввести значение непосредственно в поле.

Передача литеральных значений в вводы действий.

Проверка вашего потока и темы

На панели Проверка чата начните разговор с ботом, введя триггерную фразу для тема, которая содержит поток.

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

Тестовый диалог.

Отключить асинхронные ответы из потоков

Power Virtual Agents не поддерживает потоки Power Automate, возвращающие значения асинхронно. При создании нового потока в Power Virtual Agents это поведение по умолчанию отключено.

Потоки, для которых включена функция асинхронного ответа, могут вызывать ошибку, когда ваш бот пытается запустить поток. Вместо запуска потока бот скажет: «Произошло что-то неожиданное. Мы изучаем это. Код ошибки: 3000».

Если вы включили асинхронный ответ, вам нужно отключить его, чтобы бот работал правильно при запуске потока:

Чтобы отключить асинхронный ответ

  1. Найдите и измените свой поток.

  2. В вашем потоке Power Automate найдите шаг Power Virtual Agents, который возвращает значения.

  3. Рядом с названием потока выберите три точки, а затем выберите Настройки.

    Откройте параметры шага.

  4. Задайте для Асинхронный ответ значение Выкл, а затем выберите Готово.

    Отключите асинхронный ответ.

Устранение неполадок с ботом

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

Предупреждение

Снимок содержит все содержимое вашего бота, которое может содержать конфиденциальную информацию.

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

    Сохранить моментальный снимок.

  2. В открывшемся окне выберите пункт Сохранить.

    Сохранение сообщения снимка.

  3. Содержимое бота и разговорная диагностика будут сохранены в ZIP-архиве, который называется DSAT.zip.

    Архив разговорной диагностики.

  4. Файл DSAT.zip содержит два файла: botContent.json и dialog.json.

    1. dialog.json содержит разговорную диагностику, включая подробные описания ошибок.

      Файл разговорной диагностики.

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

Вы можете помочь нам улучшить Power Virtual Agents, помечая проблемы командой Сообщить о проблеме на панели тестирования бота. Это отправляет ваш идентификатор беседы в Microsoft, который является уникальным идентификатором, который Microsoft использует для устранения проблемы разговора. Другая информация, например, информация из файла DSAT.zip, не отправляется, когда вы сообщаете о проблеме.

Отметить проблему.

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