Eksportowanie i importowanie botów przy użyciu rozwiązań (wersja zapoznawcza)

[Ten temat pochodzi ze wstępnej wersji dokumentacji i może ulec zmianie.]

Można eksportować i importować boty przy użyciu rozwiązań, co umożliwia przenoszenie botów w wielu środowiskach.

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. Możesz mieć na przykład określone środowisko, w którym wewnętrznie testujesz i weryfikujesz boty, inne środowisko, w którym testujesz boty tylko podzbioru użytkowników, oraz ostateczne środowisko produkcyjne, w którym udostępniasz boty klientom i użytkownikom końcowym.

Uwaga

Boty można importować i eksportować tylko za pomocą aplikacji internetowej Power Virtual Agents. Funkcja nie jest dostępna w aplikacji Power Virtual Agents w aplikacji Microsoft Teams.

Wymagania wstępne

Ważne

Te funkcje są dostępne w wersji zapoznawczej, co oznacza, że są udostępnione przed wersją z ogólną dostępnością, aby można było je przetestować i ocenić, a następnie przekazać opinie firmie Microsoft.

Wersje zapoznawcze mogą używać ograniczonej lub innej ochrony prywatności, zabezpieczeń lub zgodności niż wersje komercyjne. Z tego względu nie są przeznaczone do używania z żadnymi danymi klientów, danymi osobowymi lub innymi danymi, które podlegają niektórym wymaganiom zgodności — „aktywnymi” lub produkcyjnymi. Wszelkie użycie rzeczywistych danych odbywa się na wyłączne ryzyko użytkownika i to on ponosi wyłączną odpowiedzialność za powiadamianie użytkowników końcowych o tym, że nie powinni zamieszczać poufnych informacji podczas korzystania z wersji zapoznawczej.

Te wersje zapoznawcze i cała pomoc techniczną, którą Microsoft zdecyduje się świadczyć, będą udostępniane „w stanie takim, jakim są”, „ze wszystkimi usterkami” i bez gwarancji.

Dodawanie bota do rozwiązania

Rozwiązania służą do eksportowania botów z jednego środowiska i importowania ich do innego. Rozwiązanie jest traktowany jako „nośnik” dla botów i można zaimportować wiele botów w jednym rozwiązaniu. W rozwiązaniu musi znajdować się przynajmniej jeden bot, aby poprawnie eksportować i importować go do innego środowiska.

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

  1. Zaloguj się do bota Power Virtual Agents, którego chcesz eksportować.

  2. Wybierz Ustawienia i wybierz opcję Ustawienia ogólne.

    Zrzut ekranu pokazujący wyróżnioną ikonę koła zębatego (ustawienia)

  3. W obszarze Eksportuj/importuj bota wybierz opcję Przejdź do rozwiązań Power Apps.

    Link do centrum administracyjnego usługi Power Platform z usługi Power Virtual Agents

  4. Zaloguj się do usługi Power Apps i wybierz Nowe rozwiązanie. Wprowadź informacje dotyczące poszczególnych pól opisanych w tej tabeli, a następnie wybierz pozycję Utwórz.

    Wyróżniony przycisk Nowe rozwiązanie

    Pole Opis
    Nazwa wyświetlana Nazwa wyświetlana na liście rozwiązań. Możesz ją później zmienić.
    Nazwisko Unikatowa nazwa rozwiązania. Jest generowana przy użyciu wartości wprowadzonej w polu Nazwa wyświetlana. Można ją edytować przed zapisaniem rozwiązanie, ale po zapisaniu rozwiązania nie można jej zmienić.
    Wydawca Można wybrać wydawcę domyślnego lub utworzyć nowego wydawcę. 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. Aby uzyskać więcej informacji, przejdź do omówienia wydawcy rozwiązania.
    Wersja Wprowadź liczbę dla wersji rozwiązania. To jest ważne tylko w przypadku eksportowania rozwiązania. Numer wersji będzie umieszczany w nazwie pliku podczas eksportowania rozwiązania.

Jeśli nie widzisz sekcji Eksportuj/importuj bota w Ustawieniach, musisz zaktualizować swojego bota. Wybierz pozycję Uaktualnij bota. Powinno to potrwać kilka minut.

Ważne

Wykonaj te kroki, jeśli nie widzisz opcji Eksportuj/importuj bota na stronie Ustawienia Power Virtual Agents.

Nowo utworzone boty nie wymagają uaktualnienia i nie wyświetlają opcji uaktualniania.

Zrzut ekrany z wyróżnionym przyciskiem uaktualniania bota

Uwaga

Może się pojawić powiadomienie „Uaktualnianie trwa dłużej niż oczekiwano. Nie musisz wykonywać żadnej czynności”. Jeśli po 10 minutach okaże się, że powiadomienie nie znika, spróbuj odświeżyć przeglądarkę. Możesz kontynuować pracę z botem bez utraty aktualizacji.

Jeśli ostrzeżenie będzie nadal wyświetlane za kilka dni, utwórz wniosek o pomoc techniczną, podając identyfikator bota. Administratorzy mogą użyć funkcji pomocy i wsparcia technicznego w centrum administracyjnym platformy Power Platform, aby utworzyć wniosek o pomocą techniczną.

Ostrzeżenie o czasie koniecznym do zakończenia uaktualniania

Dodawanie bota do rozwiązania

  1. Wybierz rozwiązanie, do którego chcesz dodać bota.

  2. Wybierz pozycję Dodaj istniejący i wybierz opcję Czatbot.

    Wyróżnione menu Dodaj istniejący

  3. Na panelu Dodawanie istniejących czatbotów wybierz bota (lub boty), które chcesz wyeksportować. Wybierz Dodaj.

    Czatbot wybrany na liście botów

  4. W obszarze filtra w górnym menu wybierz opcję Czatbot, aby wyświetlić bot (lub boty) dodany do rozwiązania. Wybranie nazwy bota spowoduje jego otwarcie w portalu usługi Power Virtual Agents.

  5. Jeśli bot nie ma umiejętności, nie musisz wykonywać tego kroku.

    Jeśli bot ma umiejętności, należy dodać odpowiednie zmienne środowiskowe w rozwiązaniu. Każda umiejętność ma dwie zmienne środowiskowe: AppID i manifestURL.

    1. Wybierz rozwiązanie, do którego chcesz dodać bota.

    2. Wybierz pozycję Dodaj istniejący i wybierz opcję Zmienne środowiskowe.

    3. Na panelu Dodawanie istniejących zmiennych środowiskowych wybierz zmienne środowiskowe dla umiejętności swojego bota. Każda umiejętność ma dwie zmienne środowiskowe. W kolumnie Nazwa wyświetlana zmiennych środowiskowych zostanie wyświetlona nazwa bota w nawiasach kwadratowych. Na przykład Nazwa umiejętności bota [Nazwa bota].

      Lista umiejętności wybranych do wyeksportowania

    4. Wybierz zmienne środowiskowe umiejętności bota.

    5. Wybierz pozycję Dalej, aby dodać je do rozwiązania.

Uwaga

Usunięcie bota z rozwiązania nie powoduje usunięcia jego składników z rozwiązania. Usuwanie składników powinno być wykonane oddzielnie.

Ostrzeżenie

Nie należy usuwać żadnych niezarządzanych podskładników czatbota (takich jak tematy bota) bezpośrednio z portalu usługi Power Apps, chyba że usunięto bot z rozwiązania.

Zmiany tematów należy wprowadzać wyłącznie w portalu usługi Power Virtual Agents.

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

Eksportowanie i importowanie botów

Eksportowanie i importowanie botów polega na wyeksportowaniu i zaimportowaniu zawierających je rozwiązań z jednego środowiska do innego.

Eksportowanie rozwiązania z botem

  1. Z listy rozwiązań wybierz rozwiązanie zawierające bota do wyeksportowania. Wybierz Eksportuj.

    Przycisk Eksportuj

    Uwaga

    Nie można eksportować rozwiązań zarządzanych. Tworzone rozwiązanie domyślnie nie będzie zarządzane. Po zmianie na rozwiązanie zarządzane nie będzie można go eksportować i trzeba będzie utworzyć nowe rozwiązanie.

    Jeśli w bocie jest duża liczba składników (na przykład ponad 250 tematów lub ponad 100 encji), wyeksportuj bota przy użyciu portalu klasycznego Power Apps.

    Przełączanie do widoku klasycznego

  2. Wybierz opcję Dalej na panelu Przed wyeksportowaniem.

  3. Zostanie wyświetlony panel Eksportuj to rozwiązanie. Wprowadź lub wybierz jedną z następujących opcji, a następnie wybierz Eksportuj:

    Opcja Opis
    Numer wersji Power Virtual Agents powoduje automatyczne zwiększenie wersji rozwiązania podczas wyświetlania bieżącej wersji. Istnieje możliwość zaakceptowania wersji 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.

Wykonanie eksportu może potrwać kilka minut. Po zakończeniu tej operacji plik zip zostanie pobrany za pomocą przeglądarki internetowej. Plik będzie mieć następujący format: SolutionName_Version_ManagementType.zip.

Importowanie rozwiązania z botem

Uwaga

Co najmniej jeden bot musi już znajdować się w nowym lub istniejącym środowisku, do których ma zostać zaimportowany bot. Dzięki temu podczas importowania bota środowisko ma poprawną konfigurację.

  1. W górnym menu wybierz nazwę środowiska i wybierz środowisko, do którego chcesz zaimportować bota.

    Wybrany selektor środowiska

  2. Przejdź do karty Rozwiązania i na pasku poleceń wybierz pozycję Importuj.

    Wyróżniony przycisk importu

  3. W oknie Wybieranie pakietu rozwiązania wybierz opcję Wybierz plik i znajdź plik zip zawierający rozwiązanie, które ma zostać zaimportowane z botem.

  4. Wybierz Dalej.

  5. Informacje dotyczące rozwiązania są wyświetlane. Wybierz Importuj.

  6. Konieczne może być poczekanie chwili na zakończenie importu. Przejrzyj wyniki, a następnie wybierz Zamknij.

    Jeżeli import nie jest pomyślny, zobaczysz raport pokazujący wszystkie błędy lub ostrzeżenia, które zostały przechwycone. Wybierz Pobierz plik dziennika, aby przechwycić szczegółowe informacje o przyczynie niepowodzenia importu w pliku XML.

    Najczęstszą przyczyną niepowodzenia importu jest to, że rozwiązanie nie zawierało niektórych wymaganych składników. Na przykład możesz nie mieć uaktualnionych botów w środowisku.

  7. Po zaimportowaniu otwórz zaimportowane rozwiązanie. Korzystając z menu filtru w górnym menu, wybierz pozycję Zmienna środowiskowa. Wprowadź wartości w sposób opisany w sekcji Dodawanie bota do rozwiązania.

  8. Jeśli bot zawiera dowolne z następujących elementów, należy je skonfigurować po zaimportowaniu po raz pierwszy:

    • Przepływy usługi Power Automate: skonfiguruj wszystkie połączenia przepływu za pierwszym razem. Podczas aktualizowania przepływu nie jest konieczne ponowne konfigurowanie połączeń przepływu dla kolejnych importów bota.

      W przypadku importowania rozwiązania zawierającego bota, który korzysta z usługi Power Automate, gdy wszystkie nowe przepływy są zawarte w tej operacji importu, należy odwiedzić portal usługi Power Virtual Agents i wybrać bota.

    • Umiejętności: dodaj wartości zmiennych środowiskowych umiejętności.

    • Uwierzytelnianie użytkowników końcowych: skonfiguruj uwierzytelnianie użytkownika końcowego w bocie, aby mógł one podejmować akcje w imieniu tego użytkownika. Bota można skonfigurować przy użyciu dowolnego dostawcy tożsamości OAuth2, takiego jak usługa Azure Active Directory (Azure AD), konto Microsoft lub serwis Facebook.

    • Przekazanie obsługi klienta: skonfiguruj usługi zewnętrzne, które przekazują eskalacje od bota do agenta ludzkiego.

    • Obsługa wielokanałowa: skonfiguruj kanały zewnętrzne, takie jak Facebook, oraz wewnętrzne usługi inne niż Power Virtual Agents, takie jak Microsoft Teams:

  9. Użyj menu filtru i wybierz opcję Czatbot. Następnie można wybrać nazwę bota w celu otwarcia bota w portalu Power Virtual Agents. Możesz również przejść bezpośrednio do portalu i otworzyć zaimportowanego bota w obszarze środowiska, do którego go zaimportowano.

    Lista botów i środowisk w usłudze Power Virtual Agents

Ważne

Musisz opublikować nowo zaimportowanego bota, zanim będzie można go udostępnić.

Uaktualnianie lub aktualizowanie rozwiązania za pomocą czatbota

Jeśli dodasz nowe komponenty bota (takie jak nowe tematy lub przepływy) do swojego bota w portalu PVA, będziesz również musiał zaktualizować te zmiany w bocie w docelowym środowisku. Aby to zrobić, należy dodać składniki do rozwiązania niezarządzanego, wybierając Dodaj wymagane składniki w menu ... obok nazwy bota.

Zrzut ekranu przedstawiający opcję Dodaj składniki wymagane w menu Więcej

Bywają takie sytuacje, kiedy trzeba zainstalować aktualizację istniejącego rozwiązania zarządzanego. Więcej informacji na ten temat można znaleźć w artykule dotyczącym uaktualniania lub aktualizowania rozwiązania.

Usuwanie warstwę niezarządzanej z zarządzanego czatbota

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

Składnik zarządzany (np. temat lub przepływ) otrzymuje podczas edycji niezarządzaną warstwę „Aktywne”, co oznacza, że po wdrożeniu rozwiązania nie będą widoczne najnowsze zmiany.

Aby wyświetlić najnowsze aktualizacje, należy usunąć niezarządzaną warstwę „Aktywne”.

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 użytkownik zmodyfikował coś bezpośrednio.

  1. Wybierz opcję Zobacz warstwy rozwiązań z menu kontekstowego ... obok nazwy składnika.

    Opcja Zobacz warstwy rozwiązania

  2. Na stronie Warstwa rozwiązania, wybierz niezarządzaną warstwę, a następnie wybierz Usuń warstwę niezarządzaną, aby usunąć warstwę.