Rozszerzenie Microsoft Copilot za pomocą akcji łącznika (wersja zapoznawcza)

Akcje łącznika umożliwiają zdefiniowanie łączników, które mogą być wywoływane z platform AI w Power Platform. W przypadku akcji łącznika należy zidentyfikować akcje, w których można używać w Copilot. Można również przechwytywać informacje wymagane w przypadku dużych modeli językowych w celu efektywnej identyfikacji i korzystania z dodatków plug-in, takich jak pola podsumowania i opisu.

Wymagania wstępne

Aby rozszerzyć możliwości pomocnika marki Microsoft za pomocą akcji łącznika, należy spełnić kilka wstępnych wymagań.

Ogólne wymagania wstępne

Dla wszystkich typów Copilot wymagane są poświadczenia na poziomie twórcy, licencja pomocnika i licencja Microsoft Teams.

Dynamics 365 Customer Service i Copilot dla działów sprzedaży — wymagania wstępne

Dla Copilot dla Dynamics 365 Customer Service i Copilot dla działów sprzedaży należy zalogować się do środowiska zawierającego usługę Copilot, którą chcesz rozszerzyć.

Wymagania wstępne usługi Copilot dla działów sprzedaży

• Klienci Salesforce muszą być zalogowani do swojego środowiska Dataverse. Środowisko to zwykle nosi nazwę msdyn_viva.
• Musisz zalogować się do Copilot dla działów sprzedaży przez Outlook co najmniej raz przed rozszerzeniem środowiska.

Dodaj akcję łącznika

Dodawanie akcji łącznika do pomocnika marki Microsoft obejmuje kilka kroków. W poniższych sekcjach przedstawiono wskazówki dotyczące dodawania akcji łącznika do Copilot dla Microsoft 365, Copilot dla działów sprzedaży i Copilot dla Dynamics 365 Customer Service.

Wybieranie środowiska Copilot i wybieranie akcji łącznika

1. Na stronie głównej wybierz Pomocnicy.

   

2. Na liście pomocników w lewej nawigacji wybierz pomocnika marki Microsoft, którego chcesz rozszerzyć.

   

   Zostanie wyświetlona strona omówienia usługi Copilot.

   

3. W zależności od wybranej usługi Copilot wybierz albo Akcje, albo Rozszerzenia. Można wyświetlić listę akcji, które już są obecne w Copilot.

4. Następnie wybierz opcję, aby rozszerzyć Copilot o akcję.

   W Copilot dla Microsoft 365 wybierz opcję Dodaj rozszerzenie, a następnie wybierz opcję Nowa akcja.

   W przypadku typów Copilot wybierz opcję Dodaj akcję.

   

   Zostanie wyświetlona lista wszystkich obsługiwanych typów dla Copilot.

   

5. Wybierz opcję Łącznik, aby rozszerzać przy użyciu akcji łącznika.

   Zostanie wyświetlona strona Wybierz swój łącznik. Zostanie wyświetlona lista dostępnych typów łączników do wyboru.

   Łączniki łączą pomocników z różnymi usługami. Lista zawiera wszystkie certyfikowane łączniki oferowane przez firmę Microsoft.

   W zależności od usługi Copilot lista może również zawierać wszystkie łączniki niestandardowe obecne w bieżącym używanym środowisku. Jest dostępny pasek wyszukiwania, który pomaga w wyszukiwaniu łącznika, którego chcesz użyć.

   Uwaga

   Obecnie nie można obecnie używać łączników niestandardowych do rozbudowy Copilot dla Dynamics 365 Customer Service.

Wybierz typ łącznika i zaznacz rozwiązanie

1. Znajdź typ łącznika przy użyciu paska wyszukiwania i zaznacz go.

   

   Zostanie wyświetlona strona Utwórz niestandardową akcję AI za pomocą swojego łącznika.

2. Wpisz nazwę i opis łącznika.

   Nazwa łącznika musi być unikatowa. Domyślnie zostanie przyjęta nazwa typu wybranego łącznika. Aby zagwarantować, że jest to unikatowa nazwa, a użytkownik chce ją później włączyć, powinien dodać więcej informacji definiujących. Warto uwzględnić w opisie typy akcji, które zezwalają na to, na przykład „Usługa poczty e-mail — umożliwia pobieranie i tworzenie wiadomości.”

   

   Opis może zostać podany, jeśli znajduje się w wybranym łączniku. Opis jest używany przez pomocnika w celu określenia, kiedy to działanie może zostać użyte do uzyskania odpowiedzi na żądanie użytkownika. Utwórz opis tak szczegółowy, jak to możliwe. Podaj konkretne informacje na podstawie terminów, których użytkownicy mają używać podczas wywoływania akcji. Aby kontynuować przykład usługi poczty e-mail, można dołączyć coś takiego:

   „Usługa poczty e-mail umożliwia pobieranie list istniejących wiadomości, pobieranie folderów przechowywania wiadomości, tytuły list wiadomości i folderów, pobieranie wiadomości, aktualizowanie tytułów wiadomości i bezpieczeństwo wiadomości, ustawianie priorytetu wiadomości.”

   Opis pozwala Copilot korzystać z akcji bez wyraźnej instrukcji, co pozwala na bardziej naturalny język.

3. W obszarze Rozwiązanie na liście rozwijanej zostaną wyświetlone wszystkie rozwiązania dostępne w bieżącym środowisku. Wybierz rozwiązanie, które chcesz zastosować. Więcej informacji na temat tego, jakie rozwiązania są dla nich korzystne i dlaczego są dla Ciebie są one korzystne, można znaleźć w pojęciach rozwiązań.

   

   Jeśli preferowane rozwiązanie lub wybrany łącznik znajduje się już w rozwiązaniu, to rozwiązanie zostanie automatycznie zaznaczone. Można wybrać rozwiązanie lub pozostawić puste. Jeśli pole rozwiązania pozostanie puste, zostanie utworzone rozwiązanie z nazwą akcji i wydawcą domyślnym. Przechowywanie akcji w rozwiązaniu umożliwia łatwe przenoszenie jej w środowiskach.

   Uwaga

   W tym przypadku rozwiązanie domyślne lub rozwiązanie domyślne CDS nie będzie widzieć jako opcji, ponieważ zaleca się posiadanie niestandardowego rozwiązania do łatwego zarządzania. Więcej informacji znajdziesz w temacie Rozwiązanie domyślne a rozwiązanie niestandardowe.

4. Wybierz rozwiązanie i wybierz Dalej.

   Zostanie wyświetlona strona Wybierz i skonfiguruj akcję wtyczki. Ta strona pokaże wszystkie akcje dostępne do dodania do łącznika. Można wybrać i skonfigurować dowolne akcje, które mają być wsparciem dla pomocnika, jedna za jednym razem. Jest dostępny pasek wyszukiwania, który pomaga w wyszukiwaniu akcji, którą chcesz wybrać. Nie istnieje ograniczenie maksymalnej liczby akcji, które można wybrać dla łącznika.

   

Dodaj akcje do łącznika

Następnie należy wybrać jedną z dostępnych akcji, które należy dodać do łącznika.

Uwaga

Łączniki mogą wykonać tylko te akcje, które zostały tutaj wybrane i skonfigurowane. Jeśli akcja nie jest wymieniona na liście, nie jest dostępna. Z poziomu Kreatora akcji nie można dodawać ani usuwać akcji Copilot Studio z łącznika.

1. Wybierz akcję, aby kontynuować. Dla wybranej akcji zostanie wyświetlona strona Konfigurowanie swojej akcji wtyczki.

   

2. Podaj nazwę i opis swojej akcji. W tym przypadku nazwa nie musi być unikatowa. Najprawdopodobniej te wartości zostaną wypełnione przez łącznik. Jednak tak jak w przypadku opisu lącznika zaleca się podanie szczegółowego opisu, dzięki czemu pomocnik wie, kiedy ma wywoływać określoną akcję. Opis pomaga zapewnić bardziej naturalny język podejścia do wybierania akcji do wykonania. Jeśli na przykład akcja to „Wymień foldery wiadomości”, można użyć:

   „Foldery komunikatów listy umożliwiają uzyskiwanie listy wszystkich folderów wiadomości dostępnych w usłudze poczty e-mail. Ta akcja pobiera wszystkie foldery, umieszcza je w widoku listy i zwraca je do użytkownika”.

   Opis akcji udostępnia kontekstowe foldery wiadomości: "foldery wiadomości listy", "pobierz", "wszystko", "odzyskać", "lista", "usługa poczty e-mail", "zwrot", "foldery" i "widok". Pomocnik może używać tych kontekstów do określenia, kiedy akcja jest odpowiednią czynnością na żądanie użytkownika.

3. Po zakończeniu pracy na tej stronie wybierz przycisk Dalej. Zostanie wyświetlona strona Przejrzyj parametry akcji.

4. Wybierz Dalej, aby kontynuować.

   Ta akcja spowoduje powrót do strony Wybierz i skonfiguruj akcję wtyczki. Można zobaczyć wybraną nową akcję.

   

5. Wybierz inną akcję i w razie potrzeby powtórz poprzednie kroki konfiguracji akcji.

   Alternatywnie wybierz opcję Dalej. Zostanie wyświetlony ekran przeglądu, testowania i publikowania akcji.

   

   Na stronie Przegląd, testowanie i publikowanie akcji są wyświetlane szczegółowe informacje o wszystkich krokach konfiguracyjnych do tej chwili. Można je przejrzeć, a następnie przetestować działanie przed opublikowaniem.

Przetestuj

Po skonfigurowaniu akcji łącznika można ją teraz przetestować.

Uwaga

Obecnie Copilot w Dynamics 365 for Customer Service nie umożliwia testowania z poziomu kreatora tworzenia akcji połączenia. Kiedy ta funkcja stanie się dostępna, możesz przetestować dodatek plug-in z tego ekranu. Teraz użytkownicy muszą opublikować dodatek plug-in, a następnie mogą sprawdzić, czy jest funkcjonalny w programie Copilot w Dynamics 365 for Customer Service bezpośrednio po włączeniu go przez administratora.

1. Wybierz istniejące połączenie z listy rozwijanej lub wybierz +Nowe połączenie, jeśli nie masz połączenia.

   Po wybraniu opcji + Nowe połączenie zostanie otwarty kreator, w którym można dodać szczegóły w celu utworzenia połączenia. Po ich wybraniu nowe połączenie możesz wybrać z listy rozwijanej.

2. Po wybraniu połączenia wybierz opcję Akcja testowa.

3. Jeśli zobaczysz komunikat, że akcja jest gotowa do przetestowania, wybierz opcję Otwórz, aby przetestować, aby otworzyć czat Copilot w nowym oknie. Otwórz menu wysuwane, aby wyświetlić akcję i przełącz ją.

   Akcja jest wyświetlana z ikoną zlewki pod wybranym łącznikiem z nazwą formatu Nazwa Test-Akcja.

4. Teraz można przetestować dodatek, próbując monity, które mają być użycia przez użytkownika. Tego polecenia można również użyć polecenia –developer on w celu uzyskania dodatkowych informacji o wykonaniu monitów. Gdy wyniki będą satysfakcjonują, wróć do okna Copilot Studio.

Publikowanie

1. Po zakończeniu testowania wybierz opcję Publikuj.

   Zostanie wyświetlona strona przedstawiająca łącznik w ramach procesu ich publikacji. Po zakończeniu zostanie wyświetlona strona wskazująca, że łącznik został opublikowany.

2. Możesz kliknąć stronę Przejdź do szczegółów, aby wyświetlić szczegółowe informacje o opublikowanym łączniku.

   Uwaga

   Po opublikowaniu łącznika musi on zostać włączony przez administratora, aby można było go używać w pomocniku. Jeśli nie widzisz łącznika w pomocniku, upewnij się, że jest on włączony za pośrednictwem centrum administracyjnego Microsoft lub strony rozszerzeń pomocników. Po prawidłowym włączeniu łącznik pojawi się w wysuwanym oknie. Ten krok może mieć opóźnienie do 24 godzin przy pierwszym uruchomieniu.

3. Za pomocą rozwiązania można też łatwo przenieść łącznika z jednego środowiska do innego. W tym celu należy wybrać na stronie szczegółów Eksportowanie tego rozwiązania. Eksportowanie rozwiązania umożliwia wyeksportowanie łącznika.

   

4. W razie potrzeby zmień numer wersji i określ, czy rozwiązanie musi być Zarządzane, czy Niezarządzane.

   • Zarządzane oznacza, że nie należy wprowadzać dalszych zmian w rozwiązaniu.
   • Niezarządzane oznacza, że użytkownik chce wprowadzać zmiany do rozwiązania w środowisku docelowym.

5. Po ich zakończeniu zostanie wyświetlony zielony komunikat z opcją pobrania rozwiązania i zapisania go jako .zip w systemie.

   Uwaga

   Nie jest wymagane wybranie opcji Opublikuj w panelu rozwiązań.

6. Wróć do strony Copilot Akcje/Rozszerzenie w Copilot Studio i wybierz opcję Importuj rozwiązanie w środowisku docelowym.

   

7. Przeglądaj, aby wybrać plik .zip dla wyeksportowanego rozwiązania, i wybierz przycisk Dalej, aby kontynuować. Na liście zobaczysz łącznik na liście Akcje/Rozszerzenia.

Usuwanie akcji łącznika

Jeśli konieczne jest usunięcie akcji łącznika, należy wykonać poniższą procedurę.

Lokalizacja rozwiązania używanego przez działanie łącznika

Procedura usuwania akcji łącznika jest przeprowadzana w portalu Power Apps Maker Portal. Potrzebne jest jednak rozwiązanie zastosowane dla akcji łącznika w Copilot Studio.

1. Otwórz Copilot Studio.

2. Wybierz środowisko użyte do utworzenia akcji łącznika.

3. W sekcji Copiloty wybierz Copilota, dla którego utworzono akcję łącznika.

4. Wybierz zakładkę Działania, aby wyświetlić listę działań funkcji Copilot.

5. Wybierz działanie, które chcesz usunąć i zwróć uwagę na nazwę rozwiązania.

   

Usuwanie łącznika w Power Apps Maker Portal

1. Przejdź do Maker Portal (https://make.powerapps.com) i wybierz środowisko, którego używałeś w Copilot Studio do tworzenia akcji.

2. W panelu nawigacyjnym wybierz Rozwiązania, aby wyświetlić listę rozwiązań w środowisku.

3. Znajdź rozwiązanie użyte do utworzenia akcji i wybierz je.

   Zostanie wyświetlona lista pracowników powiązanych z rozwiązaniem.

4. Znajdź akcję łącznika, którą chcesz usunąć. Akcja jest typu AIPlugin.

   Porada

   Jeśli nie widzisz swojego działania w rozwiązaniu, przenieś działanie ze stanu wersji roboczej do stanu gotowe, publikując je.

5. Przed usunięciem akcji należy usunąć zależność od tabeli AICopilot_AIPlugin. Najpierw wybierz Zaawansowane>Pokaż zależności.

   

   Wyświetlane są zależności dla akcji łącznika.

6. Dla pozycji AICopilot_AIPlugin na liście zależności wybierz Usuń.

   

7. Wróć do listy obiektów i usuń akcję, wybierając Usuń>Usuń z tego środowiska.

   

8. Usuń wszystkie operacje typu AIPluginOperation w tabeli, wybierając Usuń>Usuń z tego środowiska.

   

9. Wróć do Copilot Studio, aby sprawdzić, czy działanie zostało usunięte z widoku Akcje dla Copilot.

Uwaga

Ta procedura usuwa wtyczkę z listy pomocników Copilot. Nie spowoduje to jednak usunięcia żadnego połączenia utworzonego ze źródłem danych.