Eksportuj i importuj agentów przy użyciu rozwiązań

Agentów można eksportować i importować przy użyciu rozwiązań, aby umożliwić przenoszenie agentów między wieloma środowiskami.

Najpierw utwórz rozwiązanie niestandardowe i dodaj do niego agenta. Następnie wyeksportuj rozwiązanie wraz ze swoim agentem i zaimportuj je do innego środowiska. Możesz również uaktualnić lub zaktualizować rozwiązanie za pomocą agenta oraz usunąć warstwę niezarządzaną z zarządzanego agenta.

Aby uzyskać więcej informacji na temat Eksploratora rozwiązań w programie Copilot Studio, zobacz View i zarządzaj rozwiązaniami w programie Copilot Studio.

Uwaga / Notatka

Nie można eksportować komentarzy na poziomie tematu lub węzła podczas eksportowania agenta.

Wymagania wstępne

• Aby korzystać z tej funkcji, musisz mieć co najmniej rolę zabezpieczeń Konfigurator systemu. Dowiedz się więcej o konfigurowaniu zabezpieczeń użytkownika w środowisku.
• Zapoznaj się z pojęciami dotyczącymi rozwiązań, zgodnie z opisem w temacie Solution concepts i Tworzenie rozwiązań i zarządzanie nimi w programie Copilot Studio.

Fakty, które trzeba znać

• Nie można eksportować rozwiązań zarządzanych.

  • Tworzone rozwiązanie domyślnie będzie niezarządzane. Jeśli zmienisz rozwiązanie na rozwiązanie zarządzane, nie będzie można go wyeksportować. Musisz utworzyć nowe rozwiązanie.

• Nie wszystkie składniki i właściwości agenta są uwzględniane.

  • Instrukcje agenta (główny monit) są uwzględniane.

    Jednak niektóre składniki, takie jak tematy niestandardowe i źródła wiedzy, mogą nie być uwzględniane, jeśli są przechowywane jako oddzielne zasoby lub tabele usługi Dataverse, w zależności od sposobu ich tworzenia lub połączenia.

  • Niektóre właściwości bota nie są przenoszone, w tym:

    • Identyfikator konwersacji
    • Identyfikator bota usługi CDS
    • Identyfikator środowiska
    • Komentarze na poziomie tematu lub na poziomie węzła

    Zaimportowanemu agentowi może brakować niektórych elementów, na przykład ikona agenta oraz szczegóły kanału są puste.

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

  Ostrzeżenie

  Nie usuwaj składników agentów niezarządzanych, takich jak tematy agentów, bezpośrednio z rozwiązania, chyba że usuniesz również agenta z rozwiązania.

  Zmiany w tematach należy wprowadzać tylko w ramach standardowego procesu tworzenia w interfejsie użytkownika programu Copilot Studio. Usunięcie lub zmiana składników agenta bezpośrednio z rozwiązania powoduje niepowodzenie eksportu i importu.

• Nie możesz wyeksportować rozwiązania zawierającego agenta z okresami (.) w nazwie każdego z jego tematów.

Utwórz rozwiązanie niestandardowe i dodaj agenta

1. Aby utworzyć nowe rozwiązanie w eksploratorze rozwiązań Copilot Studio, wykonaj kroki opisane w Tworzenie rozwiązań i zarządzanie nimi w Copilot Studio.

2. Utworzone rozwiązanie zostanie otwarte automatycznie. Jeśli się nie pojawi, wybierz go z listy rozwiązań.

3. Wybierz pozycję Dodaj istniejącą, a następnie wybierz pozycję Agent, a następnie ponownie wybierz pozycję Agent .

4. Na liście Dodaj istniejących agentów wybierz agentów , których chcesz wyeksportować, a następnie wybierz pozycję Dodaj.

Uwaga / Notatka

W przypadku Klasycznego czatbota:

Jeśli korzystasz z umiejętności, usuń zmienną środowiskową Bieżąca Wartość dla umiejętności, poprzez wybranie Usuń z tego rozwiązania.

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

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

W przypadku dodawania składników, takich jak tematy lub przepływy, do agenta w programie Copilot Studio, należy je również dodać do agenta w rozwiązaniu niezarządzanym przed eksportem.

1. Otwórz Eksplorator rozwiązań w programie Copilot Studio.

2. Wybierz rozwiązanie, które zawiera Twojego agenta.

3. W okienku Obiekty zlokalizuj agenta w obszarze Agenci.

4. Wybierz trzy kropki (⋮), wybierz Zaawansowane, a następnie Dodaj wymagane obiekty.

Zapoznaj się z instrukcjami i wymaganiami w dokumentacji Power Apps, aby dodać istniejący składnik do rozwiązania.

Dodaj niestandardowe złącza do swojego rozwiązania

Jeśli Twój agent używa niestandardowych konektorów, postępuj zgodnie z instrukcjami w sekcji Utwórz własne złącza w rozwiązaniach i poznaj znane ograniczenia.

Important

Najpierw musisz zaimportować niestandardowe konektory, a następnie referencję połączenia z rozwiązaniem agenta.

Dodawanie przepływów Power Automate

W przypadku używania przepływów i zmiennych środowiskowych dodaj wymagane obiekty dla przepływów i zmiennych środowiskowych.

1. Otwórz Eksplorator rozwiązań w programie Copilot Studio.

2. Wybierz rozwiązanie, które zawiera Twojego agenta.

3. W panelu Obiekty znajdź swoje workflow.

4. Wybierz trzy kropki (⋮), wybierz Zaawansowane, a następnie Dodaj wymagane obiekty.

Dodawanie zmiennych środowiskowych

Aby dodać zmienne środowiskowe, postępuj zgodnie z tymi krokami:

1. Otwórz Eksplorator rozwiązań w programie Copilot Studio.

2. Wybierz rozwiązanie, które zawiera Twojego agenta.

3. Jeśli rozwiązanie nie ma zmiennych środowiskowych, wybierz pozycję Dodaj istniejące, wybierz pozycję Więcej, a następnie wybierz pozycję Zmienna środowiskowa.

   1. Wybierz wymagane zmienne środowiskowe.

   2. Wybierz Dalej a następnie Dodaj.

4. Jeśli rozwiązanie ma już wszystkie zmienne środowiskowe, wybierz trzy kropki (⋮), wybierz pozycję Zaawansowane, a następnie wybierz pozycję Dodaj wymagane obiekty , aby upewnić się, że rozwiązanie ma wszystkie zależności.

Dostosowywanie komponentów do rozwiązań zarządzanych

Aby dostosować składniki w rozwiązaniu zarządzanym, zobacz Wyświetlanie i edytowanie właściwości zarządzanych tabeli.

Upewnij się, że Twoje środowisko pozwala na personalizację przed importem zarządzanych rozwiązań. Sprawdź, czy Twoje środowisko nie blokuje personalizacji ani rozwiązań niezarządzanych. Dowiedz się więcej w Zablokowane niezarządzane personalizacje w Dataverse.

Eksportuj rozwiązanie z Twoim agentem

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

Aby wyeksportować rozwiązanie za pomocą agenta, wykonaj następujące kroki:

1. Otwórz Eksplorator rozwiązań w programie Copilot Studio.

2. Na liście rozwiązań niezarządzanych wybierz rozwiązanie zawierające agenta.

3. Wybierz Eksportuj rozwiązanie. Podobnie jak w środowisku Power Apps dla opcji eksportowania rozwiązań, po prawej stronie pojawi się okienko Zanim wyeksportujesz.

4. Pozostałe kroki są takie same jak w przypadku eksportowania rozwiązań w Power Apps. Aby zakończyć eksportowanie rozwiązania, postępuj zgodnie z instrukcjami i wymaganiami w dokumentacji Power Apps.

Important

Jeśli Twój agent ma dużą liczbę składników (na przykład ponad 250 tematów lub ponad 100 encji), zapoznaj się z opcjami eksportu w klasycznej wersji interfejsu.

Zaimportuj rozwiązanie z agentem

Aby zaimportować rozwiązanie z agentem do innego środowiska, wykonaj następujące kroki:

1. W środowisku docelowym otwórz Eksplorator rozwiązań w programie Copilot Studio.

2. Wybierz Importuj rozwiązanie. Podobnie jak w doświadczeniu Power Apps związanym z importowaniem rozwiązań, pojawi się okienko Importuj rozwiązanie po prawej stronie.

3. Pozostałe kroki są takie same jak w przypadku importowania rozwiązań w Power Apps. Aby zakończyć importowanie rozwiązania postępuj zgodnie z instrukcjami i wymaganiami w dokumentacji Power Apps.

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 niektórych wymaganych składników.

1. W eksploratorze rozwiązań wybierz nowe, zaimportowane rozwiązanie z listy.

2. W okienku Obiekty, wybierz Agenci. Następnie wybierz nazwę agenta, aby otworzyć agenta w programie Copilot Studio na nowej karcie.

3. Ponownie skonfiguruj uwierzytelnianie użytkownika dla agenta.

Important

• Musisz opublikować nowo zaimportowanego agenta, zanim będzie można go udostępnić.
• Zanim ikona agenta pojawi się wszędzie, może minąć do 24 godzin.

Eksportowanie i importowanie agentów utworzonych w aplikacji Teams

W Microsoft Teams można eksportować i importować agentów między poszczególnymi zespołami przy użyciu aplikacji Power Apps Teams.

Jeśli na przykład eksportujesz bota z zespołu Teams (zespołu A), a następnie zaimportujesz go do zespołu B, nie musisz tworzyć go od podstaw dla zespołu B.

Postępuj zgodnie z instrukcjami w temacie Eksportowanie dostosowań z Dataverse for Teams.

Wybierając dostosowania do wyeksportowania, wybierz agenta, którego chcesz wyeksportować. Użyj filtru w okienku bocznym, aby wyświetlić tylko agentów dla określonego zespołu.

Agent jest zapisywany w folderze Pobrane na komputerze.

Aby zaimportować dane w usłudze Teams, postępuj zgodnie z instrukcjami w temacie Importowanie dostosowań do usługi Dataverse for Teams.

Agent będzie teraz wyświetlany w aplikacji Copilot Studio w usłudze Teams w zespole, do którego został zaimportowany.