Łączniki pomocnika i akcje — omówienie (wersja zapoznawcza)

Artykuł
12/09/2024

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

Jak to działa?

Po zalogowaniu się do Copilot Studio programu możesz uzyskać dostęp do określonych agentów na podstawie licencji skojarzonej z Twoimi poświadczeniami. Lista dostępnych agentów zależy od tych uprawnień. Jeśli nie widzisz agent, który chcesz przedłużyć, zweryfikuj swoje poświadczenia. Spróbuj także połączyć się z samym agent lub spróbuj wyzwolić wszelkie zadania, które muszą wystąpić, aby przygotować agent do użycia. Przykłady można znaleźć w sekcjach szczegółowo opisjących sposób tworzenia.

Twórca zaczyna od wybrania pomocnika, którego funkcjonalność chce rozszerzyć:

Agenci niestandardowi
Microsoft 365 Agenci Copilot i Copilot
Inni pomocnicy, do których mają oni dostęp w swojej organizacji

Wybierz agent do rozszerzenia, wybierając Agenci w menu głównym, a następnie wybierając z listy agentów niestandardowych i agentów Copilot.

Wyświetlanie istniejących działań dla agent

Po wybraniu agent możesz wyświetlić akcje aktualnie dostępne dla agent w panelu konfiguracji/tworzenia dla agent.

Aby wyświetlić istniejące akcje dla agent, wybierz kartę Akcje na stronie agent.

Zostanie wyświetlona lista dostępnych działań.

Tworzenie własnego nowego działania

Możesz także tworzyć własne akcje.

Kroki zależą od typu agent:

Niestandardowy agent: Wybierz + Dodaj akcję.
Agent funkcji Copilot: Wybierz + Dodaj akcję.

Następnie możesz wybrać typ akcji z listy dostępnych opcji, aby rozpocząć proces rozszerzania agent o kolejne możliwości.

Copilot Studio prowadzi użytkownika przez kolejne kroki konfiguracji. Szczegóły kroków zależą od tego, czy rozszerzasz niestandardowy agent, czy agent funkcji Copilot.

Szczegółowe kroki konfiguracji oczną są opisane w dalszej części dokumentacji. Po zakończeniu użytkownik może opublikować akcję dla agent. Ta akcja jest teraz gotowa dla administratora do przejrzenia i zatwierdzenia. Po zatwierdzeniu akcja jest dostępna dla wszystkich użytkowników, którzy mają uprawnienia do jej używania, w ramach tej organizacji.

Copilot Studio oferuje wiele opcji ułatwiania i kompleksowego rozbudowy, takich jak:

Tworzenie: Utwórz rozszerzenie dla agent, co spowoduje utworzenie akcji.
Testowanie: sprawdź, czy akcja działa z Twoim agent, testując ją w trakcie procesu publikowania lub po jego zakończeniu.
Edytowanie: zapisywanie wersji roboczej akcji w toku lub edytowanie akcji i publikowanie wyników w celu ich użycia.
Eksportowanie/importowanie: należy podjąć zakończone działania i dystrybuować je do innych organizacji w firmie lub do własnych klientów, jeśli jesteś ISV. Można również wyeksportować pakiet, który zostanie przesłany do certyfikatów firmy Microsoft w celu udostępnić akcje w katalogu online.
Opinie: poinformuj użytkowników, że mają zamiar wprowadzić zmianę w danych i poproś o pozwolenie przed podjęciem działania, podaj karta do łatwego wyświetlania wyników, podaj przykładowe pytania, które użytkownicy mogą zadać agent.
Branding: do celów dystrybucji należy podać ikony i informacje dotyczące marki.

Notatka

Microsoft 365 Copilot można również rozszerzyć o agentów Copilot.

Co się dzieje po opublikowaniu akcji?

Po opublikowaniu akcji Twój agent Administrator musi przejrzeć i włączyć wtyczkę do użytku. Gdy Administrator włączy agent, musi również określić, które grupy użytkowników mają uprawnienia do korzystania z niego. Lokalizacja zarządzania uprawnieniami może się różnić w zależności od agent. Więcej informacji można znaleźć w dokumentacji administracyjnej. Po aktywowaniu dodatek plug-in pojawia się w środowisku, w którym został utworzony. Wtyczkę można również wyeksportować do użycia w innych agentach. Eksportowanie powoduje utworzenie pakietu, który można wdrożyć w innych środowiskach. W związku z tym nie trzeba ponownie tworzyć akcji dla każdego środowiska, w którym ma być używana.

Więcej informacji na temat importowania i eksportowania akcji można znaleźć w części Eksportowanie rozwiązań.

Opublikowane akcje można również przesłać do firmy Microsoft w celu uzyskania certyfikatów. Certyfikacja jest wykonywana za pomocą Centrum partnerów i obejmuje przegląd akcji i certyfikatów firmy Microsoft. Następnie pojawia się w katalogu akcji, w którym wszyscy użytkownicy mogą Copilot Studio również używać do rozszerzania swoich agentów.

Więcej informacji na temat certyfikacji znajdziesz w następujących dokumentach:

Rozszerzanie niestandardowego agent za pomocą akcji

Aby rozszerzyć niestandardowy agent za pomocą akcji, zobacz Używanie akcji z agentami niestandardowymi (wersja zapoznawcza).

Rozszerzanie agent funkcji Copilot za pomocą akcji

Copilot Studio Umożliwia szybkie i łatwe tworzenie operacji za pomocą kreatora krok po kroku, który prowadzi użytkownika przez cały proces.

Może służyć do rozszerzania agentów Copilot marki Microsoft lub agentów niestandardowych. Po wybraniu agent, który chcesz rozszerzyć, przeprowadzi Cię przez szereg kroków, aby utworzyć akcję.

Kreator zapyta, czy:

Wybierz typ procedury obsługi/źródła, której chcesz użyć
Dostarczenie informacji uwierzytelnienia w razie potrzeby dla wybranego typu programu obsługi/źródła
Wybierz działania składnika, które chcesz uwzględnić w działaniu
Zdefiniuj parametry wejściowe i wyjściowe dla każdego działania składnika
Zapewniają one inne, ulepszone możliwości, takie jak:
- Okno dialogowe wyrażania zgody użytkownika
- Adaptacyjne karty do wyświetlania wyników oraz pytania dotyczące rozpoczynania rozmowy
- Informacje o znakach marki do certyfikatów

Po zakończeniu tych kroków można opublikować akcji. Administrator następnie sprawdzić akcji i aktywować go. Po aktywowaniu akcji można korzystać z niego w swojej organizacji, wdrożyć go w innych organizacjach lub przesłać do Microsoft w celu uzyskania certyfikatów, aby udostępnić go ogółowi społeczeństwa.

Składniki działania

Akcje utworzone w Copilot Studio mogą mieć różne składniki, które są łączone w celu utworzenia akcji do użycia w agentach.

Programy obsługi i źródła zawartości
Uwierzytelnianie
Działania składnika
Dane wejściowe i wyjściowe
Ulepszone funkcje (zgodę użytkownika, startowe rozmowy, karty adaptacyjne, brandowanie, zarządzanie rozwiązaniami)

Programy obsługi i źródła zawartości — typy akcji

Dostępnych jest wiele programów obsługi wejściowych i źródeł zawartości, które mogą służyć jako podstawa do obsługi dodatków plug-in. W Copilot Studio te źródła są nazywane akcjami. Typowe dla tych typów akcji jest podstawowa struktura komunikacji ze źródłem podczas przesyłania zapytań. Dostępne są poniższe typy akcji:

Konwersacyjny: Wbudowana Microsoft Copilot Studio akcja konwersacyjna umożliwia rozszerzenie zachowania agent. Możesz tworzyć nowe możliwości, które nie są natywnie w Microsoft 365 Copilot, takie jak wywoływanie określonego interfejsu API, stosowanie zaawansowanej logiki biznesowej lub uzyskiwanie dostępu do źródeł danych, które wymagają konfiguracji poza Microsoft 365 dostępem Copilot. Zdolności te są skonfigurowane podobnie do wbudowanego standardowego tematu w Copilot Studio.
Łączniki: akcje łącznika są używane w Microsoft Dataverse w celu łączenia się z innymi źródłami danych. Po utworzeniu łącznik zawiera określone akcje składnika, które mogą być używane z łącznikiem. Można używać łączników lub łączników niestandardowych certyfikowanych przez Microsoft utworzonych w organizacji lub dzierżawie. Łączniki niestandardowe umożliwiają dodatek plug-in pobieranie i aktualizowanie danych ze źródeł zewnętrznych uzyskiwanych za pośrednictwem interfejsów API. Łączniki umożliwiały dostęp do danych z popularnych systemów przedsiębiorstwa, takich jak Salesforce czy Zendesk, MailChimp i GitHub. Łączniki są często używane przez twórców tych łączników w Power Apps i przepływach.
Przepływy: Microsoft Power Automate przepływy w chmurze mogą być wywoływane z agent w celu wykonywania działań, pobierania informacji i automatyzacji procesów w innych aplikacjach i źródłach danych za pomocą łączników. Przepływy można wywoływać z poziomu czatu # Microsoft 365 Copilot w celu wykonywania akcji lub pobierania informacji w środowisku użytkownika końcowego.
Monity: szablony monitów AI utworzone w celu dostosowania generowania zawartości tekstowej w stosunku do wprowadzania danych przez użytkownika. Te szablony mogą być używane w różnych scenariuszach, takich jak podsumowanie, elementy akcji, opinie lub wyodrębnianie encji, tłumaczenie tekstu i wiele więcej. Dodatkowo można dodać własne dane Dataverse do źródła wiedzy i uzyskać odpowiedzi na pytania służbowe. Monity umożliwiają użytkownikom użycie naturalnych, zwykłych języków w celu uzyskania odpowiedzi i wykonywania akcji w programie Microsoft Copilot. Używają języka naturalnego (NLU) do poznania zamiarów użytkownika i mapowania go na skojarzony z nim fragment informacji, danych lub działań.

Wybierz typ nowej akcji

Nie każdy typ akcji jest dostępny dla każdego agent funkcji Copilot marki Microsoft:

Funkcja	Microsoft 365 Copilot	Microsoft 365 Copilot dla działów sprzedaży	Microsoft 365 Copilot dla Usług
Konwersacyjna	Dostępna	Niedostępny	Niedostępny
Łącznik	Dostępna	Dostępna	Dostępna
Monit	Dostępna	Niedostępny	Dostępna
Flow	Dostępna	Niedostępny	Niedostępny

W tym celu można tworzyć i konfigurować akcje w Copilot Studio. Można także tworzyć i edytować niektóre typy akcji w Power Apps. Więcej informacji o Tworzeniu monitu (wersja zapoznawcza) w Power Automate lub Power Apps.

Uwierzytelnianie

Aby móc korzystać ze źródeł zawartości, należy zdefiniować uwierzytelnianie źródła. Źródła wymagają konkretnych typów uwierzytelnienia. Po wybraniu zawartości źródło wyświetla monity potrzebne do uwierzytelnienia.

Oto kilka przykładów:

Brak uwierzytelniania: MSN Łącznik pogodowy. Ta akcja łącznika pobiera tylko publiczne dane i nie ma bezpiecznej zawartości. W rezultacie łącznik łącznika łącznika będzie otwierany do użycia bez poświadczeń.
Akcje przepływu: przepływy w chmurze korzystają z połączenia i ustawień połączenia skonfigurowanych podczas tworzenia.
Akcje łącznika: jeśli do uzyskiwania dostępu do serwera źródło danych jest stosowana jego metoda uwierzytelniania wbudowana w łącznik. Nie trzeba go konfigurować podczas instalacji, ale konieczne jest podanie poświadczeń przed przetestowaniem lub użyciem połączenia.
Akcja monitu: użycie Teams lub tożsamości Power Apps. Monit należy udostępnić odpowiednim użytkownikom lub grupom.
Akcje rozmowy: akcje rozmowy nie wymagają żadnego uwierzytelniania we własnym zakresie. Jednak do wywołania akcji łącznika można użyć akcji rozmowy, w którym to przypadku jest wywoływany mechanizm uwierzytelniania łącznika.

Każde źródło ma już zdefiniowane akcje składnika, ale podczas konfiguracji można wybrać akcje składnika, których chcesz użyć. Można wybrać dowolną liczbę działań składnika do użycia ze źródłem. Na przykład, w przypadku danego źródła treści można wykonać następujące czynności:

Pobierz listę użytkowników
Dodaj nowego użytkownika
Aktualizowanie szczegółów użytkownika
Usuwanie użytkownika

Jeśli akcje są dostępne w źródle, procedura obsługi może przeprowadzać dowolne akcje.

Uwaga

Każda akcja składnika jest dostępna dla jego użytkowników. Nie możesz mieć uprawnień opartych na roli dla określonej akcji w jej ramach. Jeśli na przykład masz rozszerzenie umożliwiające pobieranie listy rekordów, aktualizację zamówienia, utworzenie zamówienia i anulowanie zamówienia, każdy użytkownik z uprawnieniami do tego rozszerzenia może podjąć dowolne z tych działań. Jeśli konieczne jest segmentowe uzyskiwanie dostępu do określonych akcji, należy utworzyć różne rozszerzenia z różnymi akcjami z odpowiednimi rolami zabezpieczeń przypisanymi do każdego z dodatków plug-in.

Dane wejściowe i wyjściowe

Działania wejściowe i wyjściowe są specyficzne dla akcji i zawierają wszystkie dostępne opcje wprowadzania danych dla akcji oraz definiują wyniki, które mają być zwracane. Te parametry są dostarczane przez źródło zawartości (łączniki itp.) i nie można ich dodać ani usunąć. Można jednak zaktualizować opisy, aby lepiej zrozumieć dane wejściowe i produkty. Są wyświetlane w ramach konfiguracji w celu zapewniają widoczność informacji, które muszą być uwzględnione w zapytaniu i jakie elementy są zwracane.

Funkcje zaawansowane

Ulepszone funkcje są dostępne podczas konfigurowania rozszerzeń dla niektórych typów agent.

Funkcje zaawansowane zawierają:

Rozwiązania
Zgoda użytkownika
Elementy rozpoczynające konwersację
Karty adaptacyjne
Testowanie

Nie wszystkie ulepszone funkcje są dostępne w każdym typie agent.

Rozwiązania

Rozwiązania są konieczne dla zarządzania cyklem aplikacji. Jeśli akcja zostanie zapisana w rozwiązaniu, można łatwo przenieść ją w środowiskach. Domyślnie system wybiera najbardziej odpowiednie rozwiązanie na podstawie preferowanego rozwiązania lub rozwiązania, w którym znajdują się składniki łącznika. Można również zmienić rozwiązanie. Jeśli nie określisz rozwiązania dla akcji, system automatycznie tworzy rozwiązanie w czasie wykonywania.

Tworzenie akcji

Dowiedz się więcej o rozwiązaniach w podstawowe informacje o Zarządzaniu cyklem życia aplikacji (ALM) Microsoft Power Platform.

Włącz zgodę użytkownika na działanie, jeśli chcesz, aby agent monitował użytkowników o potwierdzenie przed wykonaniem działania. Ta opcja pomaga zapobiegać niezamierzonym działaniom, które mogą mieć wpływ na dane.

Najlepsze rozwiązania:

W przypadku akcji tylko do pobierania danych (pobieranie, pobieranie, lista i tak dalej) wyłącz zgodę użytkownika. Takie akcje jedynie pobierają zestaw danych i wyświetlają go. Nie narzucają one ryzyka związanego z danymi.
W przypadku innych akcji (tworzenie, aktualizacja, usuwanie, dodawanie, usuwanie i tak dalej) włącz zgodę użytkownika. Takie akcje mogą dodawać lub zmieniać dane w systemie, dlatego warto monitować użytkowników o potwierdzenie przed podjęciem działania. W tym celu zawsze możesz zmienić ustawienia wyrażania zgody użytkownika dotyczące dodatków plug-in.

Elementy rozpoczynające konwersację

Przystawka rozmowy umożliwia tworzenie często używanych pytań wyświetlanych jako przyciski, które można klikać. Początkowe rozmowy są wykonywane natychmiast. Pokazują także typy zapytań, które mogą być używane. Te przykłady mogą pomóc użytkownikom w samodzielnie większej liczby zapytań, korzystając z udanego środowiska językowego. Przystawki rozmowy są ustawiane na poziomie dodatków plug-in i są opcjonalne. Można je edytować w dowolnym momencie.

Używanie elementów rozpoczynających konwersację

Karty adaptacyjne

Karty adaptacyjne to opcjonalny składnik skonfigurowany na poziomie akcji. W dowolnym momencie można je dodać lub zmodyfikować, edytując dodatek plug-in. Karty adaptacyjne zapewnić alternatywny sposób wyświetlania wyników z zapytania agent.

Konfiguruj kartę adaptacyjną

Karty adaptacyjne są w dwóch typach:

Ustawienie domyślne: podstawowa karta adaptacyjna, która może mieć tytuł, pochłonienie, treść i przycisk przekierowujący użytkownika do lokalizacji adresu URL. Udostępnia bardziej stylizowany widok i dzwoni do działania.
Niestandardowe: niestandardowe karty adaptacyjne są tworzone poza kreatorem i można je przekazać do włączenia w dodatków plug-in. Karty można dostosowywać i używać wielu pól, wielu przycisków i innych opcji. W Projektancie kart adaptacyjnych można utworzyć kartę niestandardową i wyeksportować ją jako plik do przekazania.

Podczas konfigurowania domyślnej karty adaptacyjnej należy wybrać ścieżkę główną. Ścieżka główna to segment pliku źródło danych konfiguracyjnym serwera i obejmuje wszystkie pola, które można wybrać, aby zdefiniować tytuł lub treść. Plik źródłowy może mieć wiele ścieżek głównych, a wszystkie dostępne ścieżki można wybrać. Po wybraniu ścieżki głównej można z list wybrać żądany tytuł i treść.

Określanie ścieżki katalogu głównego

Każda karta adaptacyjna pokazuje zwrócone wartości, a następnie zawiera listę odwołań użytych podczas kompilowania wyniku. Karty adaptacyjne umożliwiają również użytkownikowi określenie układu widoku odwołania. Ten układ pokazuje odniesienia użyte w zapytaniu, aby uzyskać więcej informacji. Może pokazywać tytuł, adres URL i podtytuł. Są to również listy rozwijane, które można wypełnić w zależności od wybranej ścieżki głównej.

Definiowanie układu widoku odwołania

Uwaga

Podczas przekazywania niestandardowego szablonu karta adaptacyjnego w kreatorze nie są dostępne żadne możliwości edycji, ponieważ karta niestandardowy powinien już zawierać wszystkie pola, przyciski i zmapowane wartości, które mają być używane przez agent. Żadne pole pozostawione puste w szablonie domyślnym nie jest wyświetlane w karta adaptacyjnym w agent.

Testowanie

W przypadku akcji łącznika producent może przetestować nową dodatek plug-in Microsoft 365, ładując dodatek plug-in. Ta opcja pojawia się na ekranie sprawdzenia akcji. Zostanie wyświetlony monit użytkownika o wybranie lub utworzenie połączenia, a następnie utworzenie załadowanej po stronie testowej wersji dodatku plug-in, która jest dostępna w środowisku Microsoft 365. Ta wersja testowa nie jest widoczna na zewnątrz i nie jest publikowana do zatwierdzenia przez administratora. Jest on dostępny tylko dla autora w celu weryfikacji, czy wtyczka działa zgodnie z oczekiwaniami.

Testowanie działania

Użyj akcji w Microsoft 365 Copilot

Użytkownicy końcowi w dzierżawie mogą używać akcji konwersacyjnych i sztucznej inteligencji w swoich czatach za pomocą Microsoft 365 Copilot, jeśli:

Administrator dzierżawy Microsoft 365 wdroży aplikacje Copilot Studio w centrum administracyjnym Microsoft 365.
Power Platform Twoja administrator środowiska włączyła ustawienie "Microsoft 365 Copilot" w Power Platform centrum administracyjnym
Użytkownik końcowy umożliwia nawiązanie połączenia z poziomu czatu za pomocą Microsoft 365 Copilot.

Wdrożenie aplikacji Copilot Studio w centrum administracyjnym Microsoft 365 (admin)

Zaloguj się w centrum administracyjnym Microsoft 365 za pomocą konta administratora.
Rozwiń opcję Ustawienia w bocznym okienku nawigacji i wybierz Zintegrowane aplikacje.
Przejdź do karty Dostępne aplikacje i wybierz wpis Microsoft Copilot Studio. Zostanie otwarte okienko szczegółów aplikacji.
Wybierz pozycję Wdróż, aby włączyć aplikację w czatach za pomocą Microsoft 365 Copilot.

Wdrażanie aplikacji Copilot Studio

Administratorzy dzierżawcy mogą włączać i wyłączać:

Wyświetlanie akcji konwersacyjnych AI/temat oraz akcji Monit w aplikacji Microsoft 365 Chat za pomocą aplikacji „Copilot Studio”.
Wyświetlając akcje przepływu w aplikacji Microsoft 365 Chat za pomocą aplikacji „Power Automate”.
Akcje łącznika i akcje interfejsu API w aplikacji Microsoft 365 Chat za pomocą skojarzonych aplikacji (nazwa aplikacji będzie nazwą łącznika lub akcji). Ponadto w magazynie Teams są dostępne akcje niestandardowego łącznika, które użytkownicy mogą instalować.

Włączanie lub wyłączanie Microsoft 365 Copilot w Power Platform centrum administracyjnym (administrator)

Przejdź do centrum administracyjnego Power Platform przy użyciu konta administratora.
Wybierz pozycję Środowiska, a następnie wybierz środowisko z listy.
Wybierz Ustawienia.
W sekcji Produkt wybierz Funkcje
Znajdź ustawienie dla Microsoft 365 Copilot i przełącz wł. (lub wył.), aby umożliwić integrację pomocników Copilot z tego środowiska.
Przewiń w dół i wybierz Zapisz.

Ważne

W tym wydaniu istnieją pewne ograniczenia:

Integracja z Copilot Studio i Power Automate jest domyślnie włączona. Oznacza to, że wtyczki utworzone w Copilot Studio będą widoczne dla użytkowników w "Copilot Studio" lub "Power Automate", nawet jeśli administratorzy dzierżawy nie wdrożyli aplikacji dla użytkowników końcowych. Może się to zmienić w przyszłości.
Pamiętaj, że jako administrator możesz nadal blokować wyświetlanie wtyczek użytkownikom, blokując aplikację w Centrum administracyjnym Microsoft 365.
W przyszłości klienci mogą zarządzać ustawieniem integracji z Microsoft 365 Copilot na dużą skalę przy użyciu grup środowisk.

Włącz połączenie w Microsoft Copilot

Microsoft 365 Copilot użytkownicy końcowi muszą włączyć wtyczki, zanim zaczną ich używać na czacie. Dostępne dodatków plug-in można włączyć za pomocą menu dodatków plug-in lub portalu konfiguracji dodatków plug-in Power Platform.

Mogą dostać się do portalu, pytając o wtyczki na czacie z Microsoft 365 Copilot. Otrzymują krótkie podsumowanie dotyczące dodatków plug-in i łącze do portalu:

Zadawanie pytań dotyczących dodatków plug-in

Użytkownicy mogą też zadawać bezpośrednie pytania dotyczące połączeń danych lub sposobu wykonywania zadań między organizacyjnymi, na przykład mogą zadać:

Jak używać dodatków plug-in?
Więcej informacji o dodatkach plug-in Power Platform Copilot
Jak pobrać dane z systemu zewnętrznego?
Jak mogę pobierać dane z programu Salesforce?

Domyślnie akcje są widoczne i mogą być używane tylko w Microsoft 365 Copilot przez osobę, która je utworzyła.

Autor akcji może jednak udostępnić swoje pluginy w portalu, w którym je utworzył. Przykładowo możesz udostępnić monit AI Builder na stronie Monitów AI, wybierając pozycję Udostępnij dla monitu. To samo dotyczy przepływów Power Automate (ze strony Przepływy w Power Automate) lub łączników niestandardowych ze strony Łączniki niestandardowe.