Zainstaluj zestaw agenta Copilot

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.

Uwaga / Notatka

Zanim pobierzesz i zainstalujesz zestaw Copilot Agent, upewnij się, że spełniasz wszystkie wymagania.

Zainstaluj zestaw Copilot Agent Kit z Marketplace

Jeśli wolisz zainstalować Copilot Agent Kit z GitHub, przejdź do Install Copilot Agent Kit z GitHub.

Wdrożenie z Marketplace

Aby wdrożyć Copilot Agent Kit z Marketplace, wykonaj następujące kroki:

1. Wejdź do zestawu agentów Copilot w Marketplace.
2. Wybierz Zdobądź teraz.
3. W razie potrzeby zaloguj się.
4. W widoku Install Copilot Agent Kit wybierz środowisko, w którym chcesz wdrożyć zestaw Copilot Agent.
5. Przejrzyj terminy i oświadczenia. Jeśli zgadzasz się, zaznacz pola i wybierz pozycję Zainstaluj.

Rozpoczyna się instalacja Copilot Agent Kit.

Kroki po wdrożeniu (Marketplace)

Po zakończeniu instalacji wykonaj następujące kroki po wdrożeniu:

1. Zaloguj się do Power Apps.
2. Przejdź do Rozwiązania.
3. Wybierz rozwiązanie domyślne.
4. Wybierz pozycję Odwołania do połączeń.
5. Znajdź zestaw agenta Copilot - Dataverse i otwórz go do edycji.
6. 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.
7. Wybierz opcję Zapisz.
8. Wykonaj dalsze i opcjonalne kroki konfiguracji.

Zainstaluj zestaw Copilot Agent Kit z GitHub

Postępuj zgodnie z tymi krokami, aby zainstalować Copilot Agent Kit z GitHub. Jeśli wolisz instalować z Marketplace, przejdź do Install Copilot Agent Kit z 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 Copilot Agent Kit

Aby zainstalować zarządzane rozwiązanie Copilot Agent Kit:

1. Zaloguj się do Power Apps.
2. Wybierz środowisko, w którym chcesz zainstalować zestaw Copilot Agent.
3. Przejdź do Rozwiązania.
4. Wybierz pozycję Importuj rozwiązanie.
5. Wybierz przycisk Przeglądaj.
6. Wybierz plik CopilotStudioKit*_managed.zip.
7. Wybierz Dalej.
8. Po przejrzeniu informacji o rozwiązaniu wybierz pozycję Dalej.
9. Jeśli zostanie wyświetlony monit, utwórz wymagane połączenia i wybierz pozycję Importuj.
10. Pozostaw wartości raportu wskaźników KPI konwersacji bez zmian na razie. Te wartości można zaktualizować później.
11. Poczekaj na zakończenie operacji importowania.

Uaktualnianie istniejącego rozwiązania (GitHub)

Aby przejść do najnowszej wersji zestawu Copilot Agent, wykonaj następujące kroki:

1. Zaloguj się do Power Apps.
2. Wybierz środowisko, w którym chcesz ulepszyć zestaw Copilot Agent.
3. Przejdź do Rozwiązania.
4. Wybierz pozycję Importuj rozwiązanie.
5. Wybierz przycisk Przeglądaj.
6. Wybierz CopilotStudioKit*_managed.zip.
7. Wybierz Dalej. Power Apps rozpoznaje, że to uaktualnienie jest istniejącym rozwiązaniem zarządzanym.
8. Upewnij się, że chcesz uaktualnić istniejące rozwiązanie, wybierając pozycję Dalej.
9. Pozostaw wartości raportu wskaźników KPI konwersacji bez zmian na razie. Te wartości można zaktualizować później.
10. Wybierz Importuj.

Uwaga / Notatka

Podczas aktualizacji Copilot Agent Kit możesz napotkać następujący błąd: Rozwiązanie "Power CAT Copilot Agent Kit" nie zaimportował: ImportAsHolding nie powiódł się z wyjątkiem: Nie można usunąć atrybutu: cat_copilottestrunid z Entity: 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 konfiguracyjne mają zastosowanie niezależnie od tego, czy zainstalowałeś Copilot Agent Kit z Marketplace, czy z GitHub.

Wskazówka

Copilot Agent Kit zawiera kreator konfiguracji do konfiguracji odniesień do połączeń, zmiennych środowiskowych i przepływów chmurowych. Dowiedz się więcej, korzystając 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:

1. Zainstaluj zestaw Copilot Agent, opisany wcześniej w tym artykule.
2. Zaloguj się do Power Apps.
3. Przejdź do Rozwiązania.
4. Wybierz rozwiązanie domyślne.
5. Wybierz pozycję Odwołania do połączeń.
6. Znajdź referencję do połączenia Copilot Agent Kit - SharePoint i otwórz ją do edycji.
7. 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.
8. Wybierz opcję Zapisz.

Więcej informacji: Dowiedz się, jak konfigurować agentów w Copilot Agent 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.

Aby użyć funkcji Inwentarz agenta:

1. Zainstaluj zestaw Copilot Agent, opisany wcześniej w tym artykule.
2. Zaloguj się do Power Apps.
3. Przejdź do Rozwiązania.
4. Wybierz rozwiązanie domyślne.
5. Wybierz pozycję Odwołania do połączeń.
6. Znajdź Copilot Agent Kit - Power Platform for Admins connection reference i otwórz go do edycji.
7. Upewnij się, że wszystkie wymagane pola są wypełnione, a wybrane połączenie jest prawidłowe.
8. Wybierz opcję Zapisz.
9. Znajdź Copilot Agent Kit - referencje do połączenia z Dataverse i otwórz je do edycji.
10. Upewnij się, że wszystkie wymagane pola są wypełnione, a wybrane połączenie jest prawidłowe.
11. Wybierz opcję Zapisz.

Włączanie przepływów

Uwaga / Notatka

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 chmurowe zawarte w Copilot Agent Kit, należy wykonać te kroki lub użyć Kreatora Konfiguracji.

1. Zainstaluj zestaw Copilot Agent, opisany wcześniej w tym artykule.
2. Zaloguj się do Power Automate.
3. Upewnij się, że środowisko z zestawem Copilot Agent jest wybrane.
4. Wybierz pozycję Rozwiązania.
5. Wybierz zestaw agenta Copilot.
6. Wybierz Przepływy w chmurze.
7. Upewnij się, że wszystkie przepływy są włączone (Stan = Włączone).
8. Włącz wszystkie przepływy, które nie są włączone, w następującej kolejności:
   1. Przepływy kończące się na Grandchild.
   2. Przepływy kończące się na Child.
   3. Pozostałe przepływy zgodnie z wymaganiami w dowolnej kolejności.

Załóż Compliance Hub

Aby skonfigurować Compliance Hub, postępuj zgodnie z instrukcjami w sekcji Konfiguracja i konfiguracja 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:

1. Zainstaluj zestaw Copilot Agent, opisany wcześniej w tym artykule.

2. Pobierz Conversation.KPIs.zip z repozytorium Power CAT Copilot Agent Kit GitHub.

3. Wyodrębnij zawartość pliku zip.

4. Otwórz plik Conversation KPIs.pbit w aplikacji Power BI Desktop.

5. 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 prefiksu https:// ).

   Jeśli okno dialogowe nie zostanie wyświetlone, wprowadź adres URL środowiska w Strona główna>Przekształć dane>Parametry edycji.

6. Odśwież dane i zaloguj się zgodnie z potrzebami.

7. Zapisz i opublikuj do obszaru roboczego.

8. Zanotuj nazwę raportu i nazwę obszaru roboczego.

9. Zaloguj się do Power BI.

10. 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.

11. Wybierz trzy kropki (...), a następnie Zobacz model semantyczny.

12. Otwórz Plik>Ustawienia.

13. Sprawdź, czy poświadczenia źródła danych nie mają problemów. Zaloguj się, aby rozwiązać wszelkie problemy.

14. 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.

1. Zaloguj się do Power Apps i wybierz środowisko, w którym zainstalowałeś Copilot Agent Kit.
2. Wybierz Rozwiązania>Rozwiązanie domyślne.
3. Wybierz opcję Zmienne środowiskowe.
4. Znajdź i wybierz Raport KPI konwersacji.
5. 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.
6. Wybierz opcję Zapisz.

Dowiedz się, jak konfigurować agentów w Copilot Agent Kit, w tym jak skonfigurować nowego agenta dla KPI Conversation.

Uzyskaj dostęp do aplikacji Copilot Agent Kit

Aby uzyskać dostęp do aplikacji Copilot Agent Kit:

1. Zaloguj się do Power Apps i wybierz środowisko, w którym zainstalowałeś Copilot Agent Kit.
2. Przejdź do obszaru Aplikacje.
3. Znajdź i wybierz Power CAT Copilot Agent Kit.
4. Wybierz Odtwórz.
5. (Opcjonalnie) Oznacz aplikację zakładką .

Udostępnij aplikację Copilot Agent Kit

Po potwierdzeniu pomyślnego uruchomienia aplikacji właściciel (lub administrator systemu, który zainstalował Kit) musi udostępnić aplikację Copilot Agent Kit zespołowi.

1. Zaloguj się do Power Apps.
2. Wybierz Aplikacje.
3. Wyszukaj "Copilot Agent Kit" i znajdź ten z kodem typu (nie z aplikacją modelową).
4. Wybierz trzy kropki (...), a następnie wybierz pozycję Udostępnij obok nazwy aplikacji.
5. Wyszukaj i dodaj użytkowników lub grupy zabezpieczeń, którzy potrzebują dostępu.
6. Wybierz pozycję Udostępnij , aby potwierdzić.

Dowiedz się więcej o udostępnianiu aplikacji Canvas w organizacji.

Następny krok

Konfigurowanie użytkowników i zespołów