Udostępnij za pośrednictwem


Użyj zmiennych wejściowych i wyjściowych do przekazania informacji

Używaj zmiennych jako parametrów wejściowych i wyjściowych do przekazywania informacji między przepływami Power Automate i Copilot Studio agentami.

Ważne

Agent może odbierać do 1 MB danych z przepływu usługi w ramach jednej akcji. Nie ma jednak ograniczeń co do ilości danych, które agent może wysłać, ani liczby zmiennych, które agent może przekazać.

W tym przykładzie utworzysz przepływ z parametrem wejściowym i zwrócisz go do agenta 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 strony Tematy swojego agenta.

  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.

Wybieranie zmiennych w temacie agenta

  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 Agent testowy .

    Zrzut ekranu przedstawiający konwersację agenta.

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.