Dodawanie zmiennych wejściowych i wyjściowych

Ważne

Możliwości i funkcje Power Virtual Agents są teraz częścią Microsoft Copilot Studio w wyniku znacznych inwestycji w generatywną AI i poprawioną integracje z Microsoft Copilot.

Niektóre artykuły i zrzuty ekranów mogą odwoływać się do Power Virtual Agents podczas aktualizowania dokumentacji i zawartości szkoleniowej.

Użyj zmiennych jako parametrów wejściowych i wyjściowych do przekazania informacji między przepływami Power Automate i pomocnikami Microsoft Copilot Studio.

Ważne

Pomocnik może otrzymać tylko 1 MB danych z przepływu w jednej akcji. Nie ma jednak ograniczeń dotyczących ilości danych, jakie może wysyłać pomocnik, ani liczby zmiennych, które może przekazać pomocnik.

W tym przykładzie zostanie utworzony przepływ z parametrem wejściowym i zwrócony do pomocnika jako parametr wyjściowy.

Wymagania wstępne

Obsługiwane typy parametrów

Pomocniki mogą używać następujących typów danych wejściowych i wyjściowych w przepływach Power Automate:

  • telefonu
  • String
  • Wartość logiczna

Następujące typy nie są obsługiwane:

  • Objekt
  • Date
  • Sygnatura czasowa
  • Lista [ciąg]
  • Lista [liczba]
  • Lista [wartość logiczna]
  • Lista [obiekt]
  • Lista [data]
  • Lista [znacznik czasu]

Tworzenie tematu i przepływu

  1. Przejdź do Strona tematów swojego pomocnika.

  2. Utwórz nowy temat o nazwie Komunikacie echa.

  3. Dodaj frazę wyzwalającą echo.

  4. Dodaj węzeł Pytanie i wprowadź komunikat Powiedz coś, a ja to powtórzę.

  5. Dla ustawienia Identyfikuj wybierz Cała odpowiedź użytkownika.

  6. Aby Zapisać odpowiedź jako, wybierz ikonę ołówka i zmień nazwę zmiennej na userResponse.

    Zrzut ekranu pokazujący węzeł pytania.

  7. Na kanwie tworzenia wybierz Dodaj węzeł (+). Wybierz Wywołaj akcję, a następnie wybierz Utwórz przepływ.

  8. W portalu Power Automate nazwij przepływ Parametr echa.

Dodaj parametry wejściowe do przepływu

  1. Wybierz Dodaj dane wejściowe w wyzwalaczu przepływu Microsoft Copilot Studio.

    Zrzut ekranu przedstawiający wyzwalacz przepływu Microsoft Copilot Studio i wyróżniony przycisk Dodaj dane wejściowe.

  2. Wybierz Tekst i wprowadź nazwę String_Input.

    Zrzut ekranu przedstawiający wejście wyzwalacza przepływu.

Dodaj parametry wyjściowe do przepływu

  1. W akcji odpowiedzi Zwróć wartości do Microsoft Copilot Studio wybierz Dodaj dane wyjściowe.

    Zrzut ekranu przedstawiający akcję odpowiedzi przepływu z wyróżnioną opcją Dodaj dane wyjściowe.

  2. Wybierz Tekst i wprowadź nazwę String_Output.

    Zrzut ekranu danych wyjściowych akcji odpowiedzi.

  3. Dla wartości String_Output wybierz zmienną String_Input.

    Zrzut ekranu parametru wejściowego wybranego jako wartość parametru wyjściowego.

  4. Wybierz pozycję Zapisz.

Wybierz zmienne w temacie pomocnika

  1. Na kanwie tworzenia Microsoft Copilot Studio wybierz opcję Dodaj węzeł (+), a następnie wybierz opcję Wywołaj akcję.

  2. Wybierz utworzony wcześniej przepływ pracy, Parametr echa.

  3. Dla String_Input(text) pobiera wartość z, wybierz opcję userResponse.

  4. Dodaj węzeł Komunikat. Wybierz Wstaw zmienną, a następnie wybierz opcję String_Output.

    Zrzut ekranu węzła akcji dla przepływu parametru echa.

  5. Przetestuj temat w okienku Test pomocnika.

    Zrzut ekranu przedstawiający konwersację pomocnika.

Opcjonalnie można użyć wartości literowych dla parametrów wejściowych

Alternatywnie, jeśli zamiast używać zmiennej jako parametru akcji wejściowej, możesz wpisać wartość bezpośrednio w polu „pobiera wartość z”.

Zrzut ekranu przedstawiający wartość literową przekazywaną jako parametr wejściowy.

Używanie zmiennych