Eksportowanie i importowanie usług pomocniczych przy użyciu rozwiązań

Ważne

Możliwości i funkcje Power Virtual Agents są teraz częścią Microsoft Copilot Studio w wyniku znacznych inwestycji w generatywną AI i poprawioną integracje z Microsoft Copilot.

Niektóre artykuły i zrzuty ekranów mogą odwoływać się do Power Virtual Agents podczas aktualizowania dokumentacji i zawartości szkoleniowej.

Korzystając z rozwiązań, można eksportować i importować rozwiązania w celu przeniesienia pomocników do wielu środowisk.

Może to być przydatne w przypadku korzystania z różnych środowisk do różnych celów lub stosowania metodologii wdrażania z użyciem pierścieni. Na przykład może to być określone środowisko, w którym wewnętrznie testuje i sprawdzane są poprawność elementów, inne środowisko, w którym są testowani pomocnicy tylko dla podzestawu użytkowników, i ostateczne środowisko produkcyjne, w którym udostępniają pomocników klientom i użytkownikom końcowym.

Uwaga

Podczas eksportowania pomocnika komentarzy na poziomie tematu lub węzła nie można eksportować.

Wymagania wstępne

Ważne

Ten artykuł zawiera dokumentację usługi Microsoft Copilot Studio w wersji zapoznawczej i może ulec zmianie.

Funkcje w wersji zapoznawczej nie są przeznaczone do użytku w środowiskach produkcyjnych i mogą mieć ograniczoną funkcjonalność. Te funkcje są udostępniane przed oficjalnym wydaniem, dzięki czemu można szybciej uzyskać do nich dostęp i przekazać opinie na ich temat.

Jeśli kompilowany jest pomocnik gotowy do użycia w środowiskach produkcyjnych, zobacz temat Omówienie usługi Microsoft Copilot Studio.

Można przenosić pomocników między środowiskami , eksportując i importując je przy użyciu rozwiązań. Eksportowanie i importowanie pomocników może być przydatne, jeśli do różnych celów są stosowane różne środowiska lub jeśli użytkownik korzysta z plików wdrożeniowych. Na przykład może to być jedno środowisko, w którym wewnętrznie testuje i sprawdzane są poprawność elementów, w którym są testowani pomocnicy tylko dla podzestawu użytkowników, i ostateczne środowisko produkcyjne, w którym udostępniają pomocników klientom.

Fakty, które trzeba znać

  • Podczas eksportowania pomocnika komentarzy na poziomie tematu lub węzła nie można eksportować.

  • Usunięcie pomocnika z rozwiązania nie powoduje usunięcia jego składników z rozwiązania. Składniki należy usuwać oddzielnie.

    Ostrzeżenie

    Nie należy usuwać niezawiązanych pomocników, takich jak tematy pomocnika, bezpośrednio z portalu Power Apps, chyba że usunięto pomocnika z rozwiązania.

    Zmiany tematów należy wprowadzać wyłącznie w usłudze Copilot Studio. Usunięcie lub zmiana składników pomocnika w usłudze Power Apps spowoduje, że eksport i import zakończą się niepowodzeniem.

  • Nie można eksportować rozwiązań zarządzanych. Tworzone rozwiązanie domyślnie będzie niezarządzane. Jeśli zmienisz je na rozwiązanie zarządzane, nie będzie można go wyeksportować. Konieczne będzie utworzenie nowego rozwiązania.

  • Jeśli pomocnik zawiera dużą liczbę składników (na przykład ponad 250 tematów lub więcej niż 100 obiektów), wyeksportuj go przy użyciu klasycznych portali Power Apps.

Utwórz rozwiązanie do zarządzania eksportem i importem

Rozwiązania służą do eksportowania pomocników z jednego środowiska i importowania ich do innego. To rozwiązanie działa jako pomocników „nośnych”. W jednym rozwiązaniu można eksportować i importować wielu pomocników.

  1. W Copilot Studio tym celu należy otworzyć pomocnika, który ma być wyeksportowany.

  2. Przejdź do menu Ustawienia, wybierz szczegóły Pomocnik, a następnie opcję Eksportuj.

    Zrzut ekranu przedstawiający kartę szczegółów Pomocnik w Copilot Studio wyróżniony przycisk Eksportuj.

  3. Wybierz pozycję Przejdź do rozwiązań usługi Power Apps.

    Zrzut ekranu przedstawiający monit eksportowania pomocnika.

  4. W usłudze Power Apps na karcie Rozwiązania wybierz pozycję Nowe rozwiązanie.

    Zrzut ekranu strony rozwiązań Power Apps z wyróżnionym przyciskiem Nowe rozwiązania.

  5. Wprowadź następujące informacje dotyczące nowego rozwiązania:

    Pole opis
    Display name Nazwa wyświetlana na liście rozwiązań. Możesz ją później zmienić.
    Nazwa/nazwisko Unikatowa nazwa rozwiązania wygenerowana z obszaru Wyświetlana nazwa. Można ją edytować przed zapisaniem rozwiązania, ale po zapisaniu rozwiązania nie można jej zmienić.
    Wydawca Wybierz wydawcę domyślnego lub utwórz nowego. Zaleca się utworzenie wydawcy, którego można używać w sposób ciągły w środowiskach, w którym będzie używane rozwiązanie. Dowiedz się więcej o wydawcach rozwiązań.
    Wersja Wprowadź liczbę dla wersji rozwiązania. Numer wersji jest umieszczany w nazwie pliku podczas eksportowania rozwiązania.
  6. Wybierz pozycję Utwórz.

Dodawanie pomocnika do rozwiązania

  1. Stworzone rozwiązanie powinno być otwarte w Power Apps. Jeśli tak nie jest, wybierz je z listy rozwiązań.

  2. Wybierz pozycję Dodaj istniejący, a następnie wybierz pozycję Czatbot.

  3. Na liście Dodaj istniejące czatboty wybierz pomocnika lub pomocników, których chcesz wyeksportować, a następnie wybierz opcję Dodaj.

Uwaga

W przypadku Klasycznego czatbota:

Jeśli używasz umiejętności, usuń zmienną bieżącą wartość umiejętności, wybierając Usuń z tego rozwiązania.

Zrzut ekranu przedstawiający przycisk Usuń z tego rozwiązania.

Usunięcie pomocnika z rozwiązania nie powoduje usunięcia jego składników z rozwiązania. Komponenty należy usunąć oddzielnie.

Ostrzeżenie

Nie należy usuwać niezarządzanych pomocników (takich jak tematy pomocnika) bezpośrednio z portalu Power Apps, chyba że usunięto pomocnika z rozwiązania.

Zmiany tematów należy wprowadzać wyłącznie w portalu usługi Copilot Studio.

Usunięcie lub zmiana podskładników pomocnika w usłudze Power Apps spowoduje, że eksport i import zakończą się niepowodzeniem.

Eksportowanie rozwiązania z pomocnikiem

Wyeksportuj i zaimportuj pomocników, eksportując i importując rozwiązania zawierające je z jednego środowiska do innego.

Ważne

Jeśli pomocnik zawiera dużą liczbę składników (na przykład ponad 250 tematów lub więcej niż 100 obiektów), zobacz Eksportuj, używając klasyczne doświadczenie.

  1. W Power Apps na stronie Rozwiązania wybierz rozwiązanie zawierające pomocnika, a następnie wybierz opcję Eksportuj rozwiązanie.

    Zrzut ekranu przycisku eksportu rozwiązania w Power Apps.

  2. W okienku Przed wyeksportowaniem wybierz przycisk Dalej.

  3. Wprowadź lub wybierz następujące opcje:

    Opcja opis
    Numer wersji Usługa Copilot Studio automatycznie zwiększa wersję rozwiązania. Istnieje możliwość zaakceptowania wartości domyślnej lub wprowadzenia własnej.
    Eksportuj jako Wybierz typ pakietu Zarządzane lub Niezarządzane. Dowiedz się więcej o rozwiązaniach zarządzanych i niezarządzanych.
  4. Wybierz Eksportuj.

Wykonanie eksportu może potrwać kilka minut. Sprawdź komunikat o stanie w górnej części strony Rozwiązania. Po zakończeniu eksportu przeglądarka pobierze plik ZIP. Nazwa pliku ma format SolutionName_Version_ManagementType.zip, na przykład MyBotPublisher_1.0.0.0.1_Unmanaged.zip.

Importowanie rozwiązania z pomocnikiem

  1. Wybierz środowisko Power Apps, w którym chcesz zaimportować dane pomocnika.

    Zrzut ekranu przedstawiający wybieranie środowiska Power Apps.

  2. Na stronie Rozwiązania upewnij się, że nie wybrano żadnych rozwiązań, i wybierz opcję Importuj rozwiązanie.

    Zrzut ekranu strony rozwiązań Power Apps z wyróżnionym przyciskiem Importuj rozwiązania.

  3. W okienku Importowanie rozwiązania wybierz opcję Przeglądaj, wybierz plik .zip zawierający rozwiązanie ze pomocnikiem, a następnie wybierz przycisk Dalej.

  4. Wybierz Importuj.

  5. Poczekaj kilka minut na zakończenie importu. Przejrzyj wyniki, a następnie wybierz Zamknij.

    Jeśli importowanie nie powiodło się, wybierz pozycję Pobierz plik dziennika, aby pobrać plik XML zawierający szczegółowe informacje o tym, co spowodowało niepowodzenie importu. Najczęstszym powodem niepowodzenia importu jest to, że rozwiązanie nie zawierało niektórych wymaganych składników.

  6. Jeśli dla pomocnika włączono uwierzytelnianie użytkownika, należy go ponownie skonfigurować.

  7. W okienku Obiekty wybierz pozycję Czatbot. Następnie wybierz nazwę pomocnika, aby otworzyć pomocnika w portalu Copilot Studio.

    Zrzut ekranu przedstawiający listę pomocników i środowisk w programie Copilot Studio.

    Można także otworzyć bezpośrednio Copilot Studio, a następnie otworzyć pomocnika w środowisku, do którym został on zaimportowany.

Ważne

Dodawanie składników do pomocnika w rozwiązaniu niestandardowym

Jeśli do pomocnika dodasz składniki, takie jak tematy lub przepływy, musisz je także dodać do pomocnika w Copilot Studio w rozwiązaniu niezarządzanym.

  1. Otwórz rozwiązanie w portalu Power Apps.

  2. Wybierz pozycję Czatboty, a następnie wybierz ze swojej listy pomocnika.

  3. Wybierz pozycję Polecenia (), wybierz pozycję Zaawansowane, a następnie wybierz pozycję +Wybierz wymagane obiekty.

    Zrzut ekranu przedstawiający opcję dodawania wymaganych komponentów w menu Polecenia w Power Apps.

Uaktualnianie lub aktualizowanie rozwiązania za pomocą pomocnika

Dowiedz się, jak uaktualniać lub aktualizować rozwiązanie.

Usuwanie warstwę niezarządzanej z zarządzanego pomocnika

Rozwiązania zarządzane i niezarządzane istnieją na różnych poziomach w środowisku usługi Microsoft Dataverse. Aby dowiedzieć się więcej, przejdź do tematu Warstwy rozwiązania.

Gdy edytujesz składnik zarządzany, na przykład temat lub przepływ, otrzymuje warstwę niezarządzaną „Aktywny”. Aby wyświetlić najnowsze aktualizacje po wdrożeniu rozwiązania, musisz usunąć tę warstwę.

Użyj opcji Zobacz warstwy rozwiązania, aby wyświetlić wszystkie rozwiązania, których częścią jest dany składnik. Jedno „aktywne” rozwiązanie jest również widoczne nad wszystkimi innymi rozwiązaniami, jeśli zmodyfikowano coś bezpośrednio.

  1. Otwórz rozwiązanie w portalu Power Apps.

  2. Wybierz pozycję Czatboty, a następnie wybierz ze swojej listy pomocnika.

  3. Wybierz pozycję Polecenia (), wybierz pozycję Zaawansowane, a następnie wybierz pozycję Zobacz warstwy rozwiązania.

    Zrzut ekranu przedstawiający opcję wyświetlania warstw rozwiązania w menu Polecenia w Power Apps.

  4. Na stronie Warstwy rozwiązania wybierz warstwę niezarządzaną, a następnie wybierz pozycję Usuń warstwę niezarządzaną.