Добавление входных и выходных переменных

  • Статья

Внимание

Возможности и функции Power Virtual Agents теперь являются частью Microsoft Copilot Studio после значительных инвестиций в генеративный искусственный интеллект и расширенную интеграцию с Microsoft Copilot.

Некоторые статьи и снимки экрана могут ссылаться на Power Virtual Agents, пока мы обновляем документацию и учебные материалы.

Используйте переменные в качестве входных и выходных параметров для передачи информации между потоками Power Automate и помощниками Microsoft Copilot Studio.

Важно

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

В этом примере вы создадите поток с входным параметром и вернете его помощнику в качестве выходного параметра.

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

Поддерживаемые типы параметров

Помощники могут использовать следующие типы входов и выходов с потоками Power Automate:

  • Число
  • String
  • Логический

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

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

Создание темы и потока

  1. Перейдите на Страницу тем для вашего помощника.

  2. Создайте новую тему с именем Эхо-сообщение.

  3. Добавьте фразу-триггер эхо.

  4. Добавьте узел Вопрос и введите сообщение Скажите мне что-нибудь, и я отвечу вам.

  5. Для параметра Идентификация выберите Весь ответ пользователя.

  6. Для параметра Сохранить ответ как выберите значок карандаша и переименуйте переменную в userResponse.

    Снимок экрана узла вопроса.

  7. На холсте разработки выберите Добавить узел (+). Выберите Вызвать действие, затем выберите Создать поток.

  8. На портале Power Automate назовите поток Параметр эхо.

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

  1. В триггере потока Microsoft Copilot Studio выберите Добавить входные данные.

    Снимок экрана: триггер потока Microsoft Copilot Studio с выделенным пунктом «Добавить входные данные».

  2. Выберите Текст и введите имя String_Input.

    Снимок экрана входного параметра триггера потока.

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

  1. В действии ответа Возвращать значения в Microsoft Copilot Studio выберите Добавить выходные данные.

    Снимок экрана действия ответа потока с выделенным пунктом «Добавить выходные данные».

  2. Выберите Текст и введите имя String_Output.

    Снимок экрана выходного параметра действия ответа.

  3. Для значения параметра String_Output выберите переменную String_Input.

    Снимок экрана входного параметра, выбранного в качестве значения выходного параметра.

  4. Выберите Сохранить.

Выберите переменные в теме помощника

  1. На холсте разработки Microsoft Copilot Studio выберите Добавить узел (+), затем выберите Вызвать действие.

  2. Выберите поток, который вы создали ранее, Параметр эха.

  3. Для пункта String_Input(text) получает значение из выберите userResponse.

  4. Добавьте узел Сообщение. Выберите Вставить переменную, затем выберите String_Output.

    Снимок экрана узла действия для потока «Параметр эха».

  5. Протестируйте свою тему на панели Тестирование помощника.

    Снимок экрана разговора с помощником.

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

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

Снимок экрана литерального значения, переданного в качестве входного параметра.

Использование переменных