Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Copilot Agent Kit to otwartoźródłowy zestaw narzędzi do testowania i oceny agentów Copilot Studio. Ułatwia to na przykład definiowanie przypadków testowych, symulowanie zapytań użytkowników i weryfikowanie odpowiedzi agenta. Ten artykuł zawiera szczegółowe instrukcje dotyczące instalacji zestawu z Marketplace lub GitHub, wraz z krokami po wdrożeniu i opcjami konfiguracji.
Note
Zanim pobierzesz i zainstalujesz zestaw Copilot Agent Kit, upewnij się, że spełniasz wszystkie wymagania wstępne.
Zainstaluj zestaw Copilot Agent Kit z witryny Marketplace
Jeśli wolisz zainstalować agenta funkcji Copilot Kit z GitHuba, przejdź do Zainstaluj agenta funkcji Copilot Kit z GitHuba.
Wdrożenie z Marketplace
Aby wdrożyć Copilot Agent Kit z witryny Marketplace, wykonaj następujące kroki:
- Przejdź do zestawu Copilot Agent Kit w Marketplace.
- Wybierz Zdobądź teraz.
- W razie potrzeby zaloguj się.
- W widoku Zainstaluj agenta funkcji Copilot Kit wybierz środowisko, w którym chcesz wdrożyć agenta funkcji Copilot Kit.
- Przejrzyj terminy i oświadczenia. Jeśli zgadzasz się, zaznacz pola i wybierz pozycję Zainstaluj.
Rozpoczyna się instalacja pakietu Copilot Agent Kit.
Kroki po wdrożeniu (Marketplace)
Po zakończeniu instalacji wykonaj następujące kroki po wdrożeniu:
- Zaloguj się do Power Apps.
- Przejdź do Rozwiązania.
- Wybierz rozwiązanie domyślne.
- Wybierz pozycję Odwołania do połączeń.
- Znajdź zestaw agenta Copilot - Dataverse i otwórz go do edycji.
- Upewnij się, że wszystkie wymagane pola są wypełnione, a wybrane połączenie jest prawidłowe. Utwórz nowe połączenie z usługą Dataverse zgodnie z potrzebami.
- Wybierz Zapisz.
- Wykonaj dalsze i opcjonalne kroki konfiguracji.
Zainstaluj Copilot Agent Kit z GitHub
Wykonaj poniższe kroki, aby zainstalować Copilot Agent Kit z serwisu GitHub. Jeśli wolisz zainstalować z witryny Marketplace, przejdź do Zainstaluj Copilot Agent Kit z witryny Marketplace.
Pobierz najnowszą wersję usługi GitHub
Pobierz najnowszą wersjęzarządzanego rozwiązania dla Power CAT Copilot Agent Kit.
Zainstaluj zarządzany plik ZIP pakietu Copilot Agent Kit
Aby zainstalować zarządzane rozwiązanie Copilot Agent Kit:
- Zaloguj się do Power Apps.
- Wybierz środowisko, w którym chcesz zainstalować Copilot Agent Kit.
- Przejdź do Rozwiązania.
- Wybierz pozycję Importuj rozwiązanie.
- Wybierz przycisk Przeglądaj.
- Wybierz plik CopilotStudioKit*_managed.zip.
- Wybierz Dalej.
- Po przejrzeniu informacji o rozwiązaniu wybierz pozycję Dalej.
- Jeśli zostanie wyświetlony monit, utwórz wymagane połączenia i wybierz pozycję Importuj.
- Pozostaw wartości raportu wskaźników KPI konwersacji bez zmian na razie. Te wartości można zaktualizować później.
- Poczekaj na zakończenie operacji importowania.
Uaktualnianie istniejącego rozwiązania (GitHub)
Aby uaktualnić Copilot Agent Kit do najnowszej wersji, wykonaj następujące kroki:
- Zaloguj się do Power Apps.
- Wybierz środowisko, w którym chcesz zaktualizować pakiet Copilot Agent Kit.
- Przejdź do Rozwiązania.
- Wybierz pozycję Importuj rozwiązanie.
- Wybierz przycisk Przeglądaj.
- Wybierz CopilotStudioKit*_managed.zip.
- Wybierz Dalej. Power Apps rozpoznaje, że to uaktualnienie jest istniejącym rozwiązaniem zarządzanym.
- Upewnij się, że chcesz uaktualnić istniejące rozwiązanie, wybierając pozycję Dalej.
- Pozostaw wartości raportu wskaźników KPI konwersacji bez zmian na razie. Te wartości można zaktualizować później.
- Wybierz Importuj.
Note
Podczas aktualizacji Copilot Agent Kit możesz napotkać następujący błąd: Rozwiązanie „Power CAT Copilot Agent Kit” nie zostało zaimportowane: operacja ImportAsHolding zakończyła się niepowodzeniem z powodu wyjątku: Nie można usunąć atrybutu: cat_copilottestrunid z encji: cat_CopilotTestRun, ponieważ atrybut nie jest polem niestandardowym.
Ten problem jest znany i badany. Aby obejść ten problem, przeprowadź uaktualnienie przed jego zastosowaniem. Dowiedz się więcej w temacie Uaktualnianie lub aktualizowanie rozwiązania.
Dalsze i opcjonalne kroki konfiguracji
Te kroki konfiguracji mają zastosowanie niezależnie od tego, czy zainstalowano pakiet Copilot Agent Kit z witryny Marketplace, czy z serwisu GitHub.
Wskazówka
Copilot Agent Kit zawiera kreator konfiguracji do konfigurowania odwołań do połączeń, zmiennych środowiskowych i przepływów w chmurze. Dowiedz się więcej o korzystaniu z Setup Wizard.
Konfigurowanie synchronizacji programu SharePoint
Poniższe kroki są opcjonalne i wymagane tylko w przypadku planowania korzystania z funkcji synchronizacji programu SharePoint . Te wartości można ustawić w dowolnym momencie przed użyciem funkcji.
Wskaż połączenie z SharePoint do źródłowej witryny SharePoint. Wskaż adres URL usługi Dataverse na wystąpienie usługi Dataverse dla docelowych agentów niestandardowych, gdzie synchronizowana jest zawartość.
Można wykonać następujące kroki lub użyć Kreatora konfiguracji, aby skonfigurować odwołanie do połączenia SharePoint.
Aby użyć funkcji synchronizacji programu SharePoint:
- Zainstaluj Copilot Agent Kit, opisany wcześniej w tym artykule.
- Zaloguj się do Power Apps.
- Przejdź do Rozwiązania.
- Wybierz rozwiązanie domyślne.
- Wybierz pozycję Odwołania do połączeń.
- Znajdź referencję do połączenia Copilot Agent Kit - SharePoint i otwórz ją do edycji.
- Upewnij się, że wszystkie wymagane pola są wypełnione, a wybrane połączenie jest prawidłowe. Utwórz nowe połączenie z programem SharePoint zgodnie z potrzebami.
- Wybierz Zapisz.
Więcej informacji: Dowiedz się, jak konfigurować agentów w agencie funkcji Copilot Kit, w tym jak skonfigurować nowego agenta do synchronizacji plików.
Konfigurowanie spisu agentów
Poniższe kroki są opcjonalne i wymagane tylko w przypadku planowania korzystania z funkcji Spis agenta . Te wartości można ustawić w dowolnym momencie przed użyciem funkcji.
Odwołania do połączeń w rozwiązaniu kontrolują widoczność agentów. Chociaż możesz używać innych kont, użyj tych uprawnień, aby uzyskać pełną widoczność.
- Copilot Agent Kit - Power Platform for Admins pobiera listę środowisk w dzierżawie. Wymaga uprawnień na poziomie administratora platformy Power Platform.
- Copilot Agent Kit – Dataverse zbiera informacje o agentach ze środowisk. Wymaga uprawnień na poziomie administratora systemu do wszystkich środowisk.
Możesz postępować zgodnie z tymi krokami lub użyć kreatora konfiguracji , aby skonfigurować odniesienia do połączeń Agent Inventar.
Po skonfigurowaniu referencji do połączeń konfigurujesz zakres środowiska, typy agentów, grupy środowiskowe, opcje magazynu oraz harmonogram synchronizacji z Inventarza Agentów. Dowiedz się więcej w temacie Konfigurowanie spisu agentów.
Aby użyć funkcji Inwentarz agenta:
- Zainstaluj Copilot Agent Kit, opisany wcześniej w tym artykule.
- Zaloguj się do Power Apps.
- Przejdź do Rozwiązania.
- Wybierz rozwiązanie domyślne.
- Wybierz pozycję Odwołania do połączeń.
- Znajdź odwołanie do połączenia Copilot Agent Kit - Power Platform for Admins i otwórz je do edycji.
- Upewnij się, że wszystkie wymagane pola są wypełnione, a wybrane połączenie jest prawidłowe.
- Wybierz Zapisz.
- Znajdź referencję połączenia Copilot Agent Kit - Dataverse i otwórz ją do edycji.
- Upewnij się, że wszystkie wymagane pola są wypełnione, a wybrane połączenie jest prawidłowe.
- Wybierz Zapisz.
Włączanie przepływów
Note
Jeśli planujesz używać synchronizacji programu SharePoint, skonfiguruj synchronizację programu SharePoint przed włączeniem powiązanych przepływów (nazwy zaczynają się od synchronizacji programu SharePoint).
Aby włączyć przepływy w chmurze zawarte w zestawie Copilot Agent Kit, wykonaj te kroki albo użyj Kreatora konfiguracji.
- Zainstaluj zestaw Copilot Agent Kit, opisany wcześniej w tym artykule.
- Zaloguj się do Power Automate.
- Upewnij się, że wybrane jest środowisko z pakietem Copilot Agent Kit.
- Wybierz Rozwiązania.
- Wybierz Copilot Agent Kit.
- Wybierz Przepływy w chmurze.
- Upewnij się, że wszystkie przepływy są włączone (Stan = Włączone).
- Włącz wszystkie przepływy, które nie są włączone, w następującej kolejności:
- Przepływy kończące się na Grandchild.
- Przepływy kończące się na Child.
- Pozostałe przepływy zgodnie z wymaganiami w dowolnej kolejności.
Załóż Compliance Hub
Aby skonfigurować Compliance Hub, wykonaj kroki opisane w artykule Set up and configure Copilot Agent Kit Compliance Hub. Compliance Hub wymaga Inventarza Agenta.
Konfigurowanie wbudowanego pulpitu nawigacyjnego kluczowych wskaźników konwersacji
Wykonaj następujące kroki tylko wtedy, gdy planujesz używać osadzonego pulpitu wskaźników KPI dla konwersacji.
Podczas wykonywania tych kroków zanotuj następujące wartości:
- Nazwa obszaru roboczego
- Identyfikator GUID obszaru roboczego
- Nazwa raportu
- Identyfikator GUID raportu
Publikowanie raportu
Aby opublikować raport wskaźników KPI konwersacji:
Zainstaluj zestaw Copilot Agent Kit, jak opisano wcześniej w tym artykule.
Pobierz Conversation.KPIs.zip z repozytorium Power CAT Copilot Agent Kit GitHub.
Wyodrębnij zawartość pliku zip.
Otwórz plik Conversation KPIs.pbit w aplikacji Power BI Desktop.
Wprowadź adres URL usługi Dataverse jako adres URL środowiska w wyświetlonym oknie dialogowym i wybierz pozycję Załaduj (na przykład
org3c23948.crm.dynamics.com, bez prefiksuhttps://).Jeśli okno dialogowe nie zostanie wyświetlone, wprowadź adres URL środowiska w Strona główna>Przekształć dane>Parametry edycji.
Odśwież dane i zaloguj się zgodnie z potrzebami.
Zapisz i opublikuj do obszaru roboczego.
Zanotuj nazwę raportu i nazwę obszaru roboczego.
Zaloguj się do Power BI.
Otwórz opublikowany raport i zanotuj identyfikator GUID obszaru roboczego i identyfikator GUID raportu w adresie URL.
W przypadku publikowania w obszarze "Mój obszar roboczy" identyfikator GUID obszaru roboczego to
00000000-0000-0000-0000-000000000000.Wybierz trzy kropki (...), a następnie Zobacz model semantyczny.
Otwórz Plik>Ustawienia.
Sprawdź, czy poświadczenia źródła danych nie mają problemów. Zaloguj się, aby rozwiązać wszelkie problemy.
Przejdź do pozycji Odśwież i ustaw harmonogram odświeżania.
Aktualizowanie zmiennej środowiskowej raportu
Aby skonfigurować osadzony pulpit wskaźników KPI rozmów, zaktualizuj powiązaną zmienną środowiskową za pomocą prawidłowych identyfikatorów. Możesz wykonać te kroki lub użyć Kreatora Konfiguracji.
- Zaloguj się do Power Apps i wybierz środowisko, w którym zainstalowano Copilot Agent Kit.
- Wybierz Rozwiązania>Rozwiązanie domyślne.
- Wybierz opcję Zmienne środowiskowe.
- Znajdź i wybierz Raport KPI konwersacji.
- Zastąp symbole zastępcze w wartości domyślnejnazwą obszaru roboczego, identyfikatorem GUID obszaru roboczego, nazwą raportu i wartościami identyfikatora GUID raportu zanotowanych podczas procesu publikowania.
- Wybierz Zapisz.
Dowiedz się, jak konfigurować agentów w Copilot Agent Kit, w tym jak skonfigurować nowego agenta dla wskaźników KPI konwersacji.
Uzyskaj dostęp do aplikacji Copilot Agent Kit
Aby uzyskać dostęp do aplikacji Copilot Agent Kit:
- Zaloguj się do Power Apps i wybierz środowisko, w którym zainstalowano Copilot Agent Kit.
- Przejdź do obszaru Aplikacje.
- Znajdź i wybierz Power CAT Copilot Agent Kit.
- Wybierz Odtwórz.
- (Opcjonalnie) Oznacz aplikację zakładką .
Udostępnij aplikację Copilot Agent Kit
Po sprawdzeniu, że aplikacja uruchamia się prawidłowo, właściciel (lub administrator systemowy, który zainstalował Kit) musi udostępnić zespołowi aplikację Copilot Agent Kit.
- Zaloguj się do Power Apps.
- Wybierz Aplikacje.
- Wyszukaj „Copilot Agent Kit” i znajdź ten z typem Kod (nie aplikację opartą na modelu).
- Wybierz trzy kropki (...), a następnie wybierz pozycję Udostępnij obok nazwy aplikacji.
- Wyszukaj i dodaj użytkowników lub grupy zabezpieczeń, którzy potrzebują dostępu.
- Wybierz pozycję Udostępnij , aby potwierdzić.
Dowiedz się więcej o udostępnianiu aplikacji Canvas w organizacji.