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

Użyj zmiennych jako parametrów wejściowych i wyjściowych, aby przekazać informacje między przepływami agenta a agentami Microsoft Copilot Studio.

Ważne

Agent może odbierać tylko 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 Copilot Studio obsługują następujące typy parametrów wejściowych i wyjściowych dla przepływów agentów:

  • Numer
  • Ciąg
  • logiczny

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

  • Obiekt
  • Data
  • Sygnatura czasowa
  • Lista [ciąg]
  • Lista [liczba]
  • Lista [Boolean]
  • 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 Echo message.

  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. Dla 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 narzędzie.

  8. Na karcie Akcje podstawowe wybierz pozycję Nowy przepływ agenta. Karta projektanta przepływu agenta otwiera się z początkowym szablonem przepływu obsługiwanego przez agenta. Przepływ obejmuje dwie czynności: Gdy agent wywołuje przepływ oraz Odpowiedź dla agenta.

  9. Wybierz pozycję Publikuj, aby zapisać przepływ przed wprowadzeniem jakichkolwiek zmian. Po pomyślnym utworzeniu przepływu zostanie wyświetlone powiadomienie.

  10. Wybierz pozycję Wróć do agenta, aby powrócić do tematu. Nowy węzeł Akcja jest dodawany do tematu dla przepływu.

  11. Wybierz Zapisz, aby zakończyć dodawanie przepływu jako narzędzia dla agenta.

Edytowanie szczegółów przepływu

  1. W węźle Akcja w przepływie wybierz łącze Wyświetl szczegóły przepływu, aby powrócić do przepływu agenta.

  2. Na karcie Przegląd przepływu zmodyfikuj szczegóły przepływu, zastępując nazwę Parametr echa. Wybierz pozycję Zapisz.

  3. Wróć na kartę Projektant.

Dodaj parametr wejściowy do przepływu

  1. Wybierz wyzwalacz Kiedy agent wywołuje przepływ i wybierz Dodaj dane wejściowe.

  2. Wybierz Tekst i wprowadź nazwę String_Input.

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

Dodaj parametr wyjściowy do przepływu

  1. Wybierz Odpowiedz na agenta jako akcję odpowiedzi, a następnie wybierz Dodaj wyjście.

  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 Zapisz wersję roboczą, a następnie Opublikuj. Copilot Studio powiadamia, gdy przepływ agenta zostanie opublikowany.

  5. Wybierz pozycję Wróć do agenta, aby powrócić do edytora tematów agenta. Nowy przebieg działania został dodany do tematu.

Wywołaj przepływ z tematu

  1. Wybierz nowy węzeł akcji.

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

    Zrzut ekranu węzła akcji, który wywołuje przepływ „Echo parametru”.

  3. Dodaj węzeł Komunikat.

  4. 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.

  5. Wybierz pozycję Zapisz.

  6. Przetestuj swojego agenta.

    Zrzut ekranu przedstawiający konwersację agenta.

Powiązana zawartość

  • Last updated on