Twórz i udostępniaj kolekcje komponentów wielokrotnego użytku

Kolekcje komponentów umożliwiają twórcom tworzenie i udostępnianie elementów wielokrotnego użytku między agentami.

Korzystając z kolekcji, możesz:

• Możesz zarządzać, wyszukiwać i tworzyć kolekcje komponentów z paska bocznego w Copilot Studio bez konieczności otwierania agenta, co ułatwia znalezienie i ponowne wykorzystanie wspólnych elementów.
• Korzystaj z eksportu jednym kliknięciem i uproszczonego importu. Copilot Studio pakuje kolekcje w wersjonowane rozwiązania zarządzane i pozwala importować bezpośrednio z ustawień agenta, usprawniając doświadczenie twórców.
• Udostępniaj kolekcje członkom zespołu , jednocześnie kontrolując dostęp do edycji, umożliwiając bezpieczną współpracę i chroniąc podstawowe zasoby.
• Ogranicz kolekcję, aby mogła być używana tylko przez jej zamierzonego agenta ( agenta podstawowego), pomagając zespołom modularyzować dużych lub wrażliwych pilotów bez niezamierzonego ponownego użycia.
• Przetestuj, jak kolekcja zachowuje się w różnych agentach bezpośrednio z obszaru roboczego Kolekcje składników, przyspieszając iterację i zapewniając spójne wyniki.
• Zbieraj i udostępniaj nowsze typy łączników, w tym agentów podrzędnych, protokoły kontekstowe modelu, łączniki i przepływy.
• Usuń lub dostosuj zależności, aby rozdzielić zasoby i obsługiwać niezależne cykle wydawnicze w różnych zespołach.

Składniki agenta obejmują:

• topics
• wiedza
• narzędzia
• Agenci podrzędni
• Protokoły kontekstowe modelu
• connectors
• flows
• entities

Aby edytować kolekcję składników lub dodać kolekcję składników do agenta, musisz być osobą, która utworzyła kolekcję, albo użytkownikiem z rolą konfiguratora systemu lub administratora systemu. Gdy kolekcja składników jest dostępna dla agenta, wszyscy autorzy agentów mogą wyświetlać kolekcję i korzystać z niej, ale nie mogą zmieniać składników wewnątrz kolekcji. Dowiedz się więcej o konfigurowaniu zabezpieczeń użytkownika w środowisku.

Tworzenie kolekcji składników

Kolekcje składników można tworzyć bezpośrednio na stronie Ustawienia dla agenta lub na stronie Kolekcje składników . Po dodaniu składników z agenta do kolekcji składniki są przenoszone do kolekcji, a agent odwołuje się do składników w kolekcji.

Kolekcję można udostępnić innym agentom w środowisku lub wyeksportować ją w celu zaimportowania do innych środowisk.

Tworzenie kolekcji składników na podstawie agenta

1. Otwórz agenta zawierającego składniki, które chcesz udostępnić jako kolekcję składników.

2. Przejdź do Ustawienia i wybierz Składniki kolekcji.

3. Jeśli zamierzasz utworzyć pierwszą kolekcję składników w środowisku, wybierz pozycję Utwórz. W przeciwnym razie wybierz Nowe.

4. Wprowadź nazwę i opis kolekcji składników.

5. Wybierz Dalej.

6. Wybierz składniki, które chcesz dodać do kolekcji składników. Możesz użyć kategorii i pola wyszukiwania, aby zawęzić listę komponentów. Agentów podrzędnych można połączyć podczas przeglądania kolekcji.

   Wszystkie zależności składników są automatycznie wybierane i dodawane do kolekcji. Zależności można wykluczyć tylko wtedy, gdy ustawiono agenta podstawowego dla kolekcji składników.

   Agent podstawowy to agent, który jest właścicielem składników w kolekcji. Jeśli nie ustawisz agenta podstawowego, kolekcja składników jest własnością środowiska i dlatego musi mieć dostęp do zależności.

   Wskazówka

   Jeśli pliki zostały przekazane jako źródła wiedzy dla agenta, dodanie takich plików do kolekcji składników powoduje usunięcie ich z agenta źródłowego.
   Aby obejść ten problem, można przenieść takie pliki z kolekcji składników z powrotem do ich agenta źródłowego.

7. Wybierz Dalej.

8. Przejrzyj zawartość kolekcji, a następnie wybierz pozycję Utwórz.

Tworzenie kolekcji składników na poziomie środowiska

1. Na pasku bocznym zaznacz trzy kropki (...), a następnie wybierz Kolekcje komponentów.

2. Wybierz pozycję Dodaj nowe, a następnie wybierz pozycję Kolekcja składników.

3. Wprowadź nazwę i opis kolekcji składników.

4. Wybierz Zakończ.

5. Połącz agenta zawierającego składniki, które chcesz udostępnić, z nową kolekcją składników.

6. Dodaj składniki z wybranego agenta do kolekcji.

Łączenie agenta z kolekcją składników

1. Na pasku bocznym zaznacz trzy kropki (...), a następnie wybierz Kolekcje komponentów.

2. Wybierz kolekcję, którą chcesz połączyć z agentem.

3. W sekcji Połączeni agenci wybierz pozycję Dodaj agenta. Wybierz agenta, z którym chcesz się połączyć, a następnie Dodaj.

   Do kolekcji składników można dodać dowolne składniki z połączonych agentów. Wszyscy połączeni agenci mogą również używać dowolnych składników z tej kolekcji.

Dodawanie składników z agenta do kolekcji

1. Na pasku bocznym zaznacz trzy kropki (...), a następnie wybierz Kolekcje komponentów.

2. Wybierz kolekcję, do której chcesz dodać komponenty.

3. Połącz agenta zawierającego składniki, których chcesz ponownie użyć w kolekcji, jeśli jeszcze tego nie zrobiono.

4. W sekcji Dodawanie składników wybierz opcję Dodaj od agenta.

   Uwaga / Notatka

   Jeśli nie połączono żadnych agentów z kolekcją składników, opcja dodawania składników z agenta nie będzie dostępna.

5. Wybierz żądanego agenta i wybierz Dalej.

6. Wybierz składniki, które chcesz dodać do kolekcji składników. Możesz użyć etykiet kategorii i pola Wyszukaj komponenty , aby zawęzić listę komponentów.

7. Wybierz Dalej.

8. Przejrzyj zawartość kolekcji, a następnie wybierz pozycję Dodaj do kolekcji.

Ustawianie agenta podstawowego dla kolekcji składników i wykluczanie zależności

Można ustawić pojedynczego agenta jako agenta podstawowego dla kolekcji składników. Twórcy mają możliwość wybrania agenta podstawowego, jeśli chcą, aby tylko jeden określony agent korzystał z kolekcji składników.

Jeśli kolekcja ma wielu połączonych agentów, nie można ustawić agenta podstawowego. Najpierw należy odłączyć wszystkich innych agentów.

Po ustawieniu agenta podstawowego można również wykluczyć zależności podczas dodawania składników z tego agenta. Dzięki temu można tworzyć mniejsze kolekcje składników, które nie zawierają wszystkich zależności, co może być przydatne, gdy chcesz udostępnić tylko określone składniki.

1. Na pasku bocznym zaznacz trzy kropki (...), a następnie wybierz Kolekcje komponentów.

2. Wybierz kolekcję, dla której chcesz ustawić agenta podstawowego.

3. W sekcji Powiązani agenci zaznaczcie trzy kropki (...) obok agenta, a następnie wybierzcie Ustaw agenta głównego.

   

   Ważne

   Jeśli kolekcja ma wielu połączonych agentów, opcja ustawienia agenta podstawowego nie jest dostępna. Dla każdego agenta innego niż ten, którego chcesz ustawić jako podstawowego, wybierz pozycję Rozłącz od agenta.

Aby wykluczyć zależności podczas dodawania składników z agenta podstawowego:

1. Wybierz pozycję Dodaj z agenta w kolekcji składników.

2. Wybierz agenta podstawowego, a następnie wybierz przycisk Dalej.

3. Wybierz składniki, które chcesz dodać do kolekcji składników. Wyczyść pole wyboru Uwzględnij zależności komponentów.

4. Wybierz Dalej.

5. Przejrzyj zawartość kolekcji, a następnie wybierz pozycję Dodaj do kolekcji.

Udostępnianie kolekcji składników

Kolekcję składników można udostępnić innym użytkownikom w organizacji i określić, czy mają oni uprawnienia osoby przeglądającej, czy edytującej . Aby uzyskać więcej informacji na temat ról uprawnień dla użytkowników Copilot Studio, zobacz Kontrolowanie sposobu udostępniania agentów.

1. Na pasku bocznym zaznacz trzy kropki (...), a następnie wybierz Kolekcje komponentów.

2. Wybierz kolekcję, którą chcesz udostępnić.

3. Na górnym pasku menu wybierz pozycję Udostępnij.

4. W panelu udostępniania wprowadź imiona i nazwiska lub adresy e-mail innych osób, którym chcesz udostępnić kolekcję komponentów. Dla każdego użytkownika określ role uprawnień (Przeglądający lub Edytujący).

Importowanie i eksportowanie kolekcji

Kolekcje można eksportować, aby można je było importować do innych środowisk. Po wyeksportowaniu kolekcji staje się ona zarządzana. Aby wyeksportować kolekcję bez zarządzania nią, zobacz Używanie rozwiązań dla złożonych kolekcji.

Aby wyeksportować kolekcję:

1. Na pasku bocznym zaznacz trzy kropki (...), a następnie wybierz Kolekcje komponentów.

2. Otwórz kolekcję, którą chcesz wyeksportować.

3. Na górnym pasku menu wybierz pozycję Eksportuj.

Rozpocznie się eksport i pojawi się pasek powiadomień. Gdy eksport jest gotowy, powiadomienie zmieni się, aby uwzględnić link do pobrania kolekcji jako pliku .zip.

Aby zaimportować kolekcję:

1. W programie Copilot Studio upewnij się, że wybrano środowisko, w którym chcesz zaimportować kolekcję:

   

2. Otwórz agenta, którego chcesz połączyć z kolekcją, a następnie wybierz pozycję Ustawienia na górnym pasku.

3. Wybierz pozycję Kolekcje składników w menu bocznym, a następnie wybierz pozycję Importuj rozwiązanie.

4. W wyświetlonym panelu wybierz opcję Przeglądaj pliki , a następnie wybierz wyeksportowaną kolekcję.

5. Szczegóły kolekcji są pokazane. Możesz wykluczyć kroki i przepływy wtyczki w sekcji Ustawienia zaawansowane .

   Wskazówka

   Jeśli spróbujesz zaimportować kolekcję do tego samego środowiska, z którego została wyeksportowana, zostanie wyświetlony komunikat o błędzie. Upewnij się, że znajdujesz się w środowisku docelowym, które nie zawiera kolekcji.

6. Wybierz Dalej. Panel importu się zamyka, a komunikat informuje, że kolekcja została pomyślnie zaimportowana.

Korzystaj z rozwiązań dla złożonych kolekcji

Za pomocą rozwiązań można również eksportować składniki agenta z jednego środowiska i importować je do innego. Rozwiązanie pełni rolę nośnika dla komponentów. W jednym rozwiązaniu można eksportować i importować wiele składników agenta.

Ogólnie rzecz biorąc, należy używać rozwiązań dla złożonych kolekcji składników. Jeśli na przykład kolekcja ma łączniki lub zmienne środowiskowe.

Tworzenie rozwiązania

1. Przejdź do strony Rozwiązania.

2. Wybierz pozycję Nowe rozwiązanie.

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

   • Nazwa wyświetlana: nazwa wyświetlana na liście rozwiązań. Możesz ją później zmienić.
   • Nazwa: unikatowa nazwa rozwiązania wygenerowana na podstawie nazwy wyświetlanej. Rozwiązanie można zmienić tylko przed zapisaniem.
   • Wydawca: Wybierz wydawcę domyślnego lub utwórz nowego wydawcę. Należy rozważyć utworzenie jednego wydawcy i spójne korzystanie z niego we wszystkich środowiskach rozwiązania. Dowiedz się więcej o wydawcach rozwiązań.
   • Wersja: Wprowadź numer dla wersji rozwiązania. Numer wersji jest umieszczany w nazwie pliku podczas eksportowania rozwiązania.

4. Wybierz pozycję Utwórz.

Dodawanie kolekcji składników do rozwiązania

1. Przejdź do strony Rozwiązania i otwórz żądane rozwiązanie, jeśli jeszcze go nie ma.

2. Wybierz pozycję Dodaj istniejącą, wskaż pozycję Agent, a następnie wybierz pozycję Kolekcja składników.

   Zostanie wyświetlony panel pokazujący wszystkie dostępne kolekcje komponentów.

3. Wybierz kolekcje składników, które chcesz wyeksportować, a następnie wybierz opcję Dodaj u dołu panelu.

Eksportowanie rozwiązania w celu udostępnienia kolekcji składników w innych środowiskach

Eksportowanie i importowanie kolekcji składników odbywa się poprzez eksportowanie i importowanie zawierających je rozwiązań z jednego środowiska do drugiego.

1. Przejdź do strony Rozwiązania.

2. Wybierz trzy kropki (⋮) dla rozwiązania zawierającego kolekcje komponentów, które chcesz wyeksportować, a następnie wybierz Eksport rozwiązania.

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

   • 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ądzany lub Niezarządzany. 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.

5. Po zakończeniu eksportu wybierz przycisk Pobierz, aby pobrać plik .zip.

   Nazwa pliku ma następujący format: SolutionName_Version_SolutionType.zip — na przykład ContosoSolution_1_0_0_1_managed.zip.

Importowanie rozwiązania w celu dodania kolekcji składników do środowiska

1. Przejdź do strony Rozwiązania.

2. Wybierz środowisko, do którego chcesz zaimportować kolekcję składników.

3. Wybierz Importuj rozwiązanie.

4. W panelu Importuj wybierz pozycję Przeglądaj, wybierz plik .zip zawierający rozwiązanie z kolekcją składników, a następnie wybierz przycisk Dalej.

5. Wybierz Importuj. Wykonanie importu może potrwać kilka minut. Sprawdź komunikat o stanie w górnej części strony Rozwiązania.

6. Poczekaj kilka minut na zakończenie importu.

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.

Dodawanie zaimportowanych kolekcji składników do agenta

Po zaimportowaniu kolekcji składników można jej używać w agentach.

1. Otwórz agenta, w którym chcesz użyć kolekcji składników.

2. Przejdź do Ustawienia i wybierz Składniki kolekcji.

3. Obok zaimportowanej kolekcji składników wybierz trzy kropki (...) i wybierz pozycję Dodaj do agenta.

   Zostanie wyświetlony komunikat z prośbą o potwierdzenie.

4. Wybierz Dodaj do agenta.

   Nazwa agenta jest wyświetlana w obszarze Aktywne dla tej kolekcji składników.

5. Przejrzyj składniki z zaimportowanej kolekcji i opublikuj agenta, aby udostępnić zmiany klientom.

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

Jeśli dodasz nowe składniki agenta do kolekcji składników w Copilot Studio, musisz je również dodać do każdego niezarządzanego rozwiązania, które odwołuje się do tej kolekcji składników.

1. Przejdź do strony Rozwiązania i otwórz rozwiązanie niezarządzane, które zawiera kolekcję składników do zaktualizowania.

2. W okienku Obiekty wybierz pozycję Kolekcje składników agenta.

3. Wybierz trzy kropki (⋮) dla kolekcji, którą chcesz zaktualizować, wskaż na Zaawansowane i wybierz Dodaj wymagane obiekty.

4. Wybierz pozycję OK.

   W okienku Obiekty można wybrać pozycję Składniki agenta, aby sprawdzić, czy są teraz wyświetlane oczekiwane składniki.

Otwórz Eksplorator rozwiązań

W Copilot Studio wybierz trzy kropki (...) na pasku bocnym, a następnie wybierz Rozwiązania.

W nowej karcie przeglądarki zostanie otwarta strona Rozwiązania.