Korzystanie z akcji z niestandardowymi pomocnikami (wersja zapoznawcza)

Można rozszerzyć możliwości pomocnika, dodając jedną lub więcej akcji. Akcje są używane przez pomocnika do automatycznego odpowiadania na użytkowników przy użyciu akcji generujących lub można dzwonić bezpośrednio z poziomu tematu.

[Ten artykuł stanowi wstępną wersję dokumentacji i może ulec zmianie.]

Typy akcji podstawowych

Po włączeniu trybu generowania pomocnik może automatycznie wybrać najbardziej odpowiednią akcję lub temat, aby zareagować na użytkownika w czasie wykonywania.

W trybie klasycznym pomocnik może używać tylko tematów do odpowiadania użytkownikowi. Można jednak projektować pomocnika w sposób jawny wywołujący akcje z poziomu tematów.

Akcje są oparte na jednym z następujących podstawowych typów akcji:

• Wstępnie utworzona akcja łącznika
• Niestandardowa akcja łącznika
• Przepływ w chmurze Power Automate
• Monity AI Builder
• Umiejętność Bot Framework

Ważne

Nie można używać akcji konwersacyjnych utworzonych w Copilot Studio jako akcji z niestandardowymi pomocnikami.

Każda akcja podstawowa zawiera dodatkowe informacje opisujące jego przeznaczenie, co pozwala pomocnikom na generowanie pytań za pomocą generatywnej AI. Pytania te są wymagane do wypełnienia danych potrzebnych do wykonania tej akcji. Dzięki temu nie trzeba ręcznie tworzyć węzłów zapytań, aby zebrać wszystkie potrzebne dane wejściowe, takie jak dane wejściowe przepływu, ponieważ są one obsługiwane w czasie wykonywania. Dane wejściowe są obsługiwane w czasie wykonywania.

Akcje mogą generować odpowiedź kontekstową na zapytanie użytkownika przy użyciu wyników akcji. Można też jawnie utworzyć odpowiedź na akcję.

Porada

Podczas używania wygenerowanych pytań z akcji należy poinformować użytkowników, że część rozmowy jest generowana przez AI.

Na przykład można dodać dodatkową wiadomość w części Początek konwersacji (temat systemowy). Ten temat określa komunikat wyświetlany użytkownikom po rozpoczęciu nowej konwersacji.

Dodaj akcję

1. Otwórz niestandardowy kod, wybierając w lewym okienku nawigacji pozycję Pomocnicy i wybierając pomocnika z listy.

2. Wybierz Akcje, aby wyświetlić akcje dla pomocnika.

3. Wybierz pozycję + Dodaj akcję.

4. W kreatorze Wybierz akcję (wersja zapoznawcza) wyszukaj akcję, której chcesz użyć, i zaznacz ją.

   Wyświetlana domyślna lista zawiera przepływy Power Automate Flows i niestandardowe łączniki dostępne w Twoim środowisku. Zawiera również powszechnie używane, wbudowane łączniki i Bot Framework Skills zarejestrowane wraz z pomocnikiem.

   

   Ważne

   Niektóre akcje utworzone z dodatków plug-in AI, takie jak monity dynamiczne i oparte na interfejsach API Dataverse, wymagają uwierzytelniania.

   

   W zależności od akcji połączenie jest skonfigurowane automatycznie, jak pokazano w przykładzie. Alternatywnie musisz skonfigurować połączenie, jeśli instrukcje zostaną podane w kreatorze. Po pomyślnym skonfigurowaniu połączenia wybierz opcję Dalej.

   

5. Możesz teraz sprawdzić i w razie potrzeby wprowadzić zmiany w konfiguracji akcji plug-in. Wybierz Zakończ, by dodać akcję do pomocnika.

   Wybierz Dalej.

Wywołaj akcję

Jeśli włączono akcje generatywne, akcja jest wywoływana automatycznie w odpowiedzi na odpowiednie zapytanie użytkownika.

Można też jawnie wywołać akcję z poziomu tematu.

Przetestuj swoją akcję

Wywołanie akcji

Pomocnik wybiera i uruchamia akcję na podstawie nazwy i opisu. Można generować wysokiej jakości opisy, korzystając z dedykowanego trybu śledzenia w celu zobaczenia akcji wybranych przez pomocnika na stronie akcji generujących.

Jeśli dodano element temat, można je przetestować, wprowadzając komunikat podobny do jednego z fraz wyzwalania dla tego temat.

Na tym zrzucie ekranu można zobaczyć przetestowaną akcję zrzutów ekranu:

Jeśli akcję dodano do temat, można je przetestować, uruchamiając temat z odpowiednią frazą uruchamianą.

Konfigurowanie danych wejściowych i wyjściowych dla akcji

Wprowadzanie zmian w konfiguracji akcji

Istnieje wiele sposobów konfigurowania akcji. Na ostatnim kroku kreatora akcji, o nazwie Przegląd i zakończ, można wprowadzić zmiany w konfiguracji akcji, klikając opcję Edytuj obok odpowiedniej sekcji.

Szczegóły akcji

Tutaj możesz skonfigurować szczegóły swojej akcji, w tym Nazwa wyświetlana modelu i Opis modelu. Zazwyczaj nazwa i opis zostały wstępnie wypełnione na podstawie wybranej akcji.

Właściwości wyświetlana nazwa i Opis dla poszczególnych danych wejściowych ułatwiają zrozumienie celu wprowadzania danych, wygenerowanie użytkownikowi odpowiednich pytań i rozpoznawanie poprawnej wartości w odpowiedzi użytkownika. Na przykład są to domyślne nazwy i opis parametru wejściowego lokalizacji łącznika MSN Weather.

• Nazwa: lokalizacja
• Opis: lokalizacja zapytanie wyszukiwania. Prawidłowe dane wejściowe to miejscowość, region, województwo, kraj, punkt orientacyjny, kod pocztowy oraz długość i szerokość geograficzna

Gdy użytkownik zapyta o lokalizację, tworzy pytanie podobne do W jakiej lokalizacji chcesz sprawdzić lokalizację? Można wprowadzić kod pocztowy, miasto, region, stan, kraj, punkty orientacyjne lub kod pocztowy.

Możesz także zmienić opcję Zidentyfikuj jako na określony typ encji, w zależności od zbieranych danych wejściowych, co może pomóc pomocnikowi w dokładnym wyodrębnieniu wartości danych wejściowych z odpowiedzi użytkownika.

Domyślnie każde wejście jest ustawione na Dynamicznie wypełniaj najlepszą opcją. Pomocnik próbuje wypełnić wartość na podstawie dostępnego kontekstu, na przykład wyodrębniając wartość z wiadomości użytkownika. Jeśli nie zostanie znaleziona odpowiednia wartość, pomocnik generuje prośbę o podanie wartości przez użytkownika. Zamiast pytać użytkownika, możesz zastąpić dane wejściowe wartością. Aby zastąpić, zmień w menu rozwijanym Jak pomocnik wypełni te dane wejściowe? na Ustaw wartość, a następnie wprowadź wartość, której chcesz użyć. Wartość ta może być literałem, istniejącą zmienną lub formułą Power Fx.

W celu kontroli zachowania pomocnika podczas pytania o wartość lub sprawdzania poprawności odpowiedzi użytkownika można skonfigurować dodatkowe ustawienia danych wejściowych.

Dane wyjściowe

Domyślnie akcja jest skonfigurowana w taki sposób, aby automatycznie generowała odpowiedź kontekstową dla użytkownika na podstawie zapytania i wyniku akcji. Na przykład, jeśli użytkownik zapyta: „Jaka jest aktualna temperatura w Londynie?”, zostanie wygenerowana kontekstowa odpowiedź przy użyciu GPT, np. „Aktualna temperatura w Londynie to 9 stopni Celsjusza”.

Można także wybrać autora określonej odpowiedzi dotyczącej akcji, która ma zostać zwrócona. Podobnie jak w edytorze potwierdzania można wstawić odwołania z akcji do zmiennych wyjściowych, używając selektora zmiennych, jak pokazano w tym przykładzie.

Wywoływanie akcji z poziomu tematu

Można jawnie wywołać akcję z poziomu temat, podobnie jak w przypadku wywoływania innych typów akcji, takich jak Przepływy Power Automate. W zależności od przypadku użycia możesz użyć swojego przepływu jako części szerszego temat, który wykorzystuje więcej węzłów. Podobnie jak w przykładzie przykładu z jedną akcją, dodanie węzła z jedną akcją do temat może być potrzebne.

Wywoływanie akcji z poziomu tematu:

1. W programie Copilot Studio przejdź do strony Tematy dotyczącej pomocnika, którego chcesz edytować.

2. Utwórz nowy temat i nadaj mu nazwę Pobieranie pogody.

3. Dodaj następujące Frazy wyzwalające:

   • czy będzie padać
   • dzisiejsza prognoza
   • pobieranie pogody
   • jaka jest pogoda

   

4. Wybierz pozycję Nowy węzeł (+), a następnie wybierz pozycję Wywołaj akcję. Przejdź do karty Akcje dodatków plug-in (wersja zapoznawcza), a następnie wybierz utworzoną wcześniej akcję Pobierz prognozę.

   

5. Węzeł Akcji typu plug-in (wersja zapoznawcza) jest teraz dodawany do tematu.

   

6. Wybierz pozycję Zapisz.

Zastępowanie danych wejściowych podczas wywoływania akcji wtyczki z tematu

Domyślnie przy uruchamianiu akcji pomocnik tworzy dla użytkownika pytania o wypełnienie wymaganych informacji. W niektórych przypadkach może być jednak konieczne zastąpienie jednego lub kilku danych wejściowych i podanie jawnej wartości zamiast zadawanie użytkownikowi pytania. Możesz zastąpić w konfiguracji działania wtyczki w ciągu sekcji Wejścia. Można też zastąpić wartości tylko wtedy, gdy akcja jest używana z określonego temat:

1. Wybierz opcję Ustaw wartość na węźle i wybierz dane wejściowe, które chcesz zastąpić.

   

2. Wprowadź wartość wejściową, wpisując wartość, wybierając zmienną lub używając formuły.

   

Po zastąpieniu tych danych wejściowych pomocnik nie poprosi użytkownika o podanie wartości.

Włącz uwierzytelnianie w celu logowania w akcjach AI

Niektóre akcje, tworzone na podstawie akcji AI, wymagają poprawnego działania uwierzytelniania, na przykład monitu dynamicznego lub innych, które wywołują interfejs API Dataverse.

Akcje są zawsze uruchamiane w środowisku uruchomieniowym Microsoft Copilot w kontekście użytkownika końcowego i nie można ich uruchomić, jeśli uwierzytelnianie nie zostanie włączone. Obsługiwane są dwa typy uwierzytelniania:

1. Przejdź do właściwości akcji łącznika.

2. W obszarze Uwierzytelnianie użytkownika końcowego wybierz opcję Uwierzytelnianie autora Copilot.

3. Opublikuj i przetestuj sposób pracy w okienku testowym pomocnika lub w wybranym kanale.

   

Korzystanie z akcji przepływu z poświadczeniami użytkownika końcowego

Akcje przepływu można skonfigurować w taki sposób, aby używać poświadczeń użytkownika końcowego. Użycie przepływu w obsługiwanym kanałie nie wymaga specjalnej konfiguracji w oknie dialogowym pomocnika, a użytkownicy końcowi mogą zarządzać połączeniami w danym dostępnym przepływie.

Uwierzytelnianie akcji na podstawie dodatków plug-in w bibliotece

Po utworzeniu na podstawie dodatków plug-in AI akcje wymagają uwierzytelniania, aby działało poprawnie. Jest to najbardziej widoczne w przypadku akcji opartych na monitach lub innych nazwach interfejsów API Dataverse. Akcje oparte na dodatkach są zawsze uruchamiane w kontekście użytkownika końcowego i nie można ich uruchomić, jeśli uwierzytelnianie nie zostanie włączone. Obsługiwane są dwa typy uwierzytelniania:

• Zintegrowane uwierzytelnianie (Teams i Power Apps): tej metody uwierzytelniania można użyć, aby opublikować pomocnika w kanale Teams. Ta metoda działa również w przypadku aplikacji wbudowanych w każdą aplikację Power Platform, która korzysta z tokenów wbudowanych przy użyciu standardu PPAPI.

• Uwierzytelnianie ręczne (identyfikatory innych firm): ta metoda uwierzytelniania obejmuje konfigurację połączenia Tożsamości Microsoft Entra.

Aby utworzyć połączenie z ręcznym uwierzytelnianiem:

1. Konfigurowanie aplikacji Tożsamości Microsoft Entra.

2. Ustaw ręczne uwierzytelnienie dla pomocnika Copilot Studio.

3. Zezwól swojej aplikacji na korzystanie z delegowania do pobrania tokenu w imieniu użytkownika. Pamiętaj o dodaniu wszelkich niezbędnych zakresów.