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 liczby zmiennych ani ilości danych, które agent może wysłać.

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

Agenci funkcji Copilot Studio obsługują następujące typy parametrów wejściowych i wyjściowych dla przepływów Power Automate:

  • telefonu
  • String
  • Wartość logiczna

Nie są obsługiwane następujące typy danych:

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

Utwórz temat i przepływ

  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. W polu Zapisz odpowiedź użytkownika jako zmień nazwę zmiennej na userResponse.

    Zrzut ekranu przedstawiający węzeł Pytanie, który zbiera odpowiedź użytkownika.

  7. Wybierz ikonę Dodaj węzeł pod węzłem Pytanie i wybierz Dodaj akcję.

  8. Na karcie Akcje podstawowe wybierz pozycję Nowy przepływ Power Automate.

  9. W obszarze Power Automate wybierz nazwę przepływu i zastąp ją ciągiem Echo parametru.

Dodawanie parametru wejściowego do przepływu

  1. Wybierz wyzwalacz Uruchom przepływ z przepływu Copilot i wybierz Dodaj parametry wejściowe.

  2. Wybierz Tekst i wprowadź nazwę String_Input.

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

Dodawanie parametru wyjściowego do przepływu

  1. Wybierz akcję Odpowiedz do Copilot, a następnie wybierz pozycję Dodaj dane wyjściowe.

  2. Wybierz Tekst i wprowadź nazwę String_Output.

    Zrzut ekranu przedstawiający parametr wyjściowy akcji odpowiedzi.

  3. Jako wartość wprowadź ukośnik (/) w polu, wybierz pozycję Wstaw zawartość dynamiczną, a następnie wybierz zmienną String_Input.

  4. Wybierz pozycję Zapisz.

Wywoływanie przepływu z tematu

  1. W Copilot Studio wybierz ikonę Dodaj węzeł pod węzłem Pytanie i wybierz Dodaj akcję.

  2. Na karcie Podstawowe akcje, wybierz utworzony wcześniej przepływ, Echo parametru.

  3. Ustaw parametr wejściowy przepływu na zmienną wyjściową z węzła Pytanie: String_Input (Ciąg) otrzymuje swoją wartość ze zmiennej userResponse.

    Zrzut ekranu węzła Akcja, który wywołuje przepływ

  4. Dodaj węzeł Komunikat.

  5. Wybierz Wstaw zmienną, a następnie wybierz opcję String_Output.

    Zrzut ekranu przedstawiający węzeł komunikatu, który odzwierciedla dane wejściowe użytkownika.

  6. Wybierz pozycję Zapisz.

  7. Przetestuj swojego agenta.

    Zrzut ekranu przedstawiający konwersację agenta.