Referencja komponentu w Agent Library w zestawie Copilot Agent Kit

Komponenty w Bibliotece Agentów to wielokrotnego użytku, gotowe kolekcje komponentów, które możesz dodać do dowolnego agenta Copilot Studio. Każdy komponent jest zapakowany jako osobna kolekcja komponentów, więc instalujesz tylko te potrzebne komponenty.

Ten artykuł jest źródłem referencyjnym dla poszczególnych komponentów. Aby uzyskać przegląd komponentów, jak przeglądać i instalować komponenty z zestawu oraz jak dodawać je do swojego agenta, zobacz Zarządzanie komponentami w Bibliotece Agentów.

Zrzut ekranu komponentów w Bibliotece Agentów w zestawie Copilot Agent.

Note

Biblioteka Agentów jest dostępna zarówno jako rozwiązanie zarządzane, jak i niezarządzane. Używaj zarządzanego rozwiązania, aby dodawać komponenty do swoich agentów bez żadnych modyfikacji. Niezarządzanego rozwiązania używaj tylko wtedy, gdy musisz edytować wewnętrzne elementy komponentów. Każdy komponent ma tylko jedną instancję w środowisku, więc każda edycja w temacie, promptie lub przepływie w Biblioteki Agentów dotyczy każdego agenta, który używa tego komponentu w tym samym środowisku.

Elementy w skrócie

Biblioteka Agentów zawiera następujące komponenty dostarczane w ich rozwiązaniach. Komponenty, które nie wymagają odniesień do połączeń, znajdują się w osobnym rozwiązaniu bazowym. Komponenty łączące wspólne złącze są grupowane razem.

Component collection Description Components Connections
Document Extraction Przekształca przesłane dokumenty w dane strukturalne za pomocą AI Builder. 1 prompt Dataverse
Content Synthesizer Shared AI Builder prompt, który syntetyzuje treści badawcze w sekcje oparte na dowodach z cytowaniami. 1 prompt Dataverse
Research Component Trzyetapowy pipeline AI, który syntetyzuje źródła internetowe w kompleksowy raport badawczy. 1 temat + 3 prompty (Etap 2 wywołuje Content Synthesizer) Dataverse
Komponent briefu wykonawczego Trzyetapowy pipeline AI, który generuje podsumowania zarządcze ukierunkowane na decyzje. 1 temat + 3 prompty (Etap 2 wywołuje Content Synthesizer) Dataverse
Asystent biletowy ServiceNow End-to-end zarządzanie incydentami ServiceNow z wykorzystaniem kart adaptacyjnych. 5 tematów + 1 powiązanie – odniesienie Dataverse, ServiceNow

Important

Pola oznaczone jako Nie dla Wymaganego mają wbudowane domyślne ustawienia i działają bez konfiguracji. Podaj wartość tylko po to, aby nadpisać domyślne zachowanie.

Prerequisites

Przed rozpoczęciem upewnij się, że zostały spełnione następujące wymagania wstępne:

  • Zainstaluj i skonfiguruj zestaw Copilot Agent Kit w środowisku Power Platform.
  • Zalogowany użytkownik ma przypisaną rolę CSK - Maker Security w Copilot Agent Kit do przeglądania i instalacji komponentów.
  • Środowisko Power Platform ma włączony Copilot Studio.
  • Zapewnij kredyty AI Builder dostępne w swoim środowisku (wymagane dla komponentów opartych na promptach).
  • Dla ServiceNow Ticket Assistant miej instancję ServiceNow z dostępem do API REST oraz skonfigurowanym połączeniem ServiceNow w Power Platform. Dowiedz się więcej w ustawieniach Service Principal w ServiceNow.

Document Extraction

Property Value
Typ Prompt AI Builder (TaskDialog)
Category Pozyskiwanie i integracja danych
Interaction model Tool-initiated. Agent orchestrar wywołuje to narzędzie, gdy intencje użytkownika zgadzają się z opisem narzędzia.

Ekstracja dokumentów przekształca przesłane dokumenty w dane strukturalne. Wykorzystuje prompt AI Builder do parsowania i wyodrębniania kluczowych pól na podstawie konfigurowalnego schematu.

Kiedy użyć: Przetwarzanie faktur, przegląd umów, cyfryzacja formularzy lub każda sytuacja wymagająca pobierania ustrukturyzowanych informacji z dokumentów nieustrukturyzowanych.

Jak działa ekstrakcja dokumentów

  1. Użytkownik przesyła dokument do rozmowy agenta.
  2. Komponent przetwarza dokument za pomocą AI Builder.
  3. Komponent zwraca wyodrębnione dane jako strukturalne wyjście, które możesz przechowywać, wyświetlać lub przekazywać do dalszych przepływów.

Dane wejściowe do ekstrakcji dokumentów

Name Display name Required Description
DocumentContent Document Content Yes Pełny tekst z pliku lub wklejonej zawartości.
ExtractionSchema Extraction Schema Yes Kluczowe pola do wyodrębnienia z zawartości dokumentu. Na przykład schemat faktur może zawierać pola takie jak nazwa, numer faktury i data.

Wyjścia Ekstrakcji Dokumentów

Wszystkie wyjścia promptów AI Builder są zwracane.

Content Synthesizer

Property Value
Typ Prompt AI Builder (TaskDialog)
Category Generowanie i transformacja treści
Interaction model Module. Wywoływane przez potok nadrzędny (komponent badawczy lub komponent briefu wykonawczego) jako etap syntezy 2. Można go też używać jako samodzielnego narzędzia.

Content Synthesizer przekształca surowe wyniki wyszukiwania w uporządkowaną, opartą na dowodach sekcję badawczą z cytowaniami w tekstie. To wspólny silnik syntezy używany zarówno przez pipeline Research Component, jak i Executive Brief Component. Można go również dodać do dowolnego agenta jako samodzielne narzędzie do syntezy treści na żądanie.

Kiedy użyć: Każdy scenariusz wymagający syntezy wielu dokumentów źródłowych w spójną, opartą na cytowaniach narrację, zarówno jako część wieloetapowego pipeline'u, jak i jako samodzielne narzędzie do generowania treści.

Jak działa syntezator treści

  1. Potok nadrzędny (lub agent) przekazuje prompt badawczy, surowe wyniki wyszukiwania oraz opcjonalne instrukcje stylu.
  2. Prompt integruje wnioski ze wszystkich źródeł według tematu. Nie podsumowuje źródła po źródle.
  3. Dowody opierają się na dostarczonej treści, zawierającej konkretne dane takie jak liczby, procenty, daty i nazwane podmioty.
  4. Wyjściem jest obiekt JSON zawierający zsyntetyzowaną sekcję znaczeń oraz tablicę wyodrębnionych cytowań.

Wejścia syntezatora treści

Name Display name Required Typ Description
Content Content Yes Automatic Wyniki badań Markdown generowane na podstawie zapytania użytkownika, wykorzystywane jako wejście do syntezy treści. Oczekiwany format obejmuje Title:, Source:, oraz Content: bloki.
ResearchPrompt Research Prompt Yes Automatic Pytanie lub zapytanie badawcze użytkownika. Cała treść opiera się na tym celu.

Wyjścia z Syntezatora Treści

Prompt zwraca obiekt JSON z dwoma polami:

Field Typ Description
SectionContentMarkdown String Pełna sekcja syntezatorów w markdown. Uporządkowane według tematów z nagłówkami, kluczowymi wnioskami, kluczowymi wnioskami oraz stopką pewności/świeżości.
Citations Array Lista cytowanych źródeł w "Title - URL"formie . Każdy wpis odpowiada znacznikowi w [n] sekcji wpisowej.

Struktura wyjściowa syntezatora treści

Sekcja syntezatorowa podąża za następującą strukturą:

  • Otwarcie: Rozpoczyna się najważniejszymi ustaleniami i zapowiedźmi kluczowych tematów.
  • Sedno: Uporządkowane według tematów (nie według źródła), z oznaczeniami przypisywania i [n] cytowań w tekstie, pogrubionymi oznaczeniami wyszukiwania klucza oraz [CHART SUGGESTION] opcjonalnymi znacznikami.
  • Kluczowe wnioski: Trzy do pięciu zwięzłych, praktycznych punktów punktowych.
  • Stopka: ocena pewności (od wysokiego do niskiego), aktualność danych oraz zauważalne luki.

Research Component

Property Value
Typ Temat + 3 prompty AI Builder + wyszukiwanie w sieci
Category Analiza danych i wgląd
Interaction model Tool-initiated. Trzyetapowy pipeline: planowanie badań, synteza treści, finalizacja raportu.

Research Component syntezuje informacje z wielu źródeł w kompleksowy raport badawczy. Wykorzystuje trzyetapowy pipeline AI do planowania, badania i gromadzenia wyników.

Kiedy użyć: analizy konkurencyjnej, badań rynku, przeglądu polityki lub dowolnego scenariusza wymagającego skonsolidowanego spojrzenia na wiele źródeł informacji.

Jak działa komponent badawczy

  1. Użytkownik podaje pytanie badawcze lub temat.
  2. Etap 1 (Planer Badań): Tworzy uporządkowany plan badawczy z sekcjami i zapytaniami.
  3. Etap 2 (Syntezator treści): Przeszukuje źródła internetowe dla każdej sekcji i generuje treści z cytowaniami.
  4. Etap 3 (Report Finalizer): Łączy wszystkie sekcje i cytowania w dopracowany raport.
  5. Ostateczny raport jest wyświetlany w linii w rozmowie.

Wkłady komponentów badawczych

Name Display name Required Description
ResearchPrompt Research Prompt Yes Główny temat lub przedmiot badań, taki jak "Przegląd rynku pojazdów elektrycznych."
AdditionalInstructions Additional Instructions No Opcjonalny kontekst, taki jak obszary fokusowe lub ograniczenia. Domyślnie ustawia się "Rozpocznij z wyraźnym celem badawczym", jeśli pusto.
InstructionsForInformationCompiler Instrukcje dotyczące kompilatora informacji No Kontroluje styl i długość każdej zsyntetyzowanej sekcji. Domyślnie ustawia się na "Prosty styl, maksymalnie 200 słów", jeśli jest puste.
InstructionsForReportFinalizer Instrukcje dotyczące finalizera raportu No Kontroluje, jak składany jest końcowy raport. Domyślnie syntezuje wszystkie sekcje w spójny raport.

Wyniki komponentów badawczych

Komponent wyświetla raport w linii rozmowy.

Komponent briefu wykonawczego

Property Value
Typ Temat + 3 prompty AI Builder + wyszukiwanie wewnętrzne/webowe
Category Generowanie i transformacja treści
Interaction model Tool-initiated. Trzyetapowy pipeline: planowanie strategiczne, synteza wglądów, krótka finalizacja.

Komponent Executive Brief generuje zwięzłe, ukierunkowane na decyzje podsumowania na podstawie złożonych danych wejściowych. Wykorzystuje trzyetapowy pipeline AI do planowania, syntezy wniosków i tworzenia dopracowanego briefu wykonawczego.

Kiedy użyć: Przygotowanie do posiedzeń zarządu, aktualizacje statusu projektu, kwartalne przeglądy biznesowe lub dowolny scenariusz wymagający dopracowanego podsumowania dla interesariuszy.

Jak działa komponent Executive Brief

  1. Użytkownik podaje krótki temat lub pytanie.
  2. Etap 1 (Planer Brief Executive): Tworzy strategiczny plan badawczy z obszarami badawczymi.
  3. Etap 2 (Insight Synthesizer, zasilany Content Synthesizerem): Przeszukuje wewnętrzne i internetowe źródła dla każdego obszaru oraz wyodrębnia kluczowe fakty i cytowania.
  4. Etap 3 (Brief Finalizer): Zbiera wszystkie spostrzeżenia i cytowania w dopracowany brief executive.
  5. Brief jest wyświetlany w linii dialogu.

Wkłady komponentu Executive Brief

Name Display name Required Description
ResearchPrompt Research Prompt Yes Krótki temat lub pytanie, takie jak "Strategia adopcji AI dla firm średniej półki."
AdditionalInstructions Additional Instructions No Opcjonalny kontekst firmy, obszary zainteresowania lub ograniczenia.

Wyniki komponentu Executive Brief

Komponent ten wyświetla w rozmowie instrukcje wykonawcze.

Asystent biletowy ServiceNow

Property Value
Typ 5 tematów + złącze ServiceNow + karty adaptacyjne
Category Wykonanie akcji i integracja systemu
Interaction model Conversation-initiated. Agent kieruje się do odpowiedniego tematu na podstawie intencji użytkownika. Każdy temat wykorzystuje karty adaptacyjne do zbierania wymaganych pól.

ServiceNow Ticket Assistant zapewnia kompleksowe zarządzanie incydentami ServiceNow bezpośrednio od agenta Copilot Studio. Zawiera pięć tematów obejmujących cały cykl życia incydentu.

Kiedy korzystać: z help desku IT, samoobsługi pracowników lub dowolnego scenariusza związanego z zarządzaniem incydentami ServiceNow.

ServiceNow obejmował tematy

Topic Description
Create Incident Zbiera krótki opis, szczegółowy opis, wpływ i pilność za pomocą adaptacyjnej karty, a następnie tworzy incydent w ServiceNow.
Check Status Akceptuje numer incydentu (na przykład ) INC0010002i zwraca stan, priorytet, daty oraz opis.
Resolve/Close Incident Aktualizuje stan incydentu (Rozwiązany, Zamknięty, Anulowany, Wstrzymany, W trakcie) o kod rozwiązania i notatki.
Zdobądź najnowsze incydenty Automatycznie pobiera do 10 ostatnich incydentów dla zalogowanego użytkownika. Nie jest wymagana żadna reakcja.
Next Actions Po zakończeniu operacji ServiceNow wyświetla menu nawigacyjne, przechodząc do innych tematów ServiceNow lub ogólnej rozmowy.

Note

Tematy ServiceNow wykorzystują adaptacyjne karty do zbierania bezpośrednich danych użytkowników w rozmowie. Nie są wymagane żadne dane wejściowe na poziomie narzędzi.

ServiceNow prerequisites

Ten komponent jest dostarczany w osobnym rozwiązaniu (CopilotStudioKit_ServiceNow_Components), ponieważ wymaga referencji połączenia ServiceNow podczas importu. Zanim zaimportujesz to rozwiązanie, upewnij się, że masz:

  • Instancja ServiceNow z dostępem do API REST.
  • Połączenie skonfigurowane w Power Platform for ServiceNow. Podczas importu rozwiązania jesteś proszony o skonfigurowanie tego.
  • Odpowiednie uprawnienia użytkownika ServiceNow do potrzebnych operacji.

Konfiguracja zasady serwisu ServiceNow

Aby skonfigurować połączenie ServiceNow Power Platform z użyciem Microsoft Entra ID, postępuj zgodnie z instrukcjami z Jak skonfigurować połączenie ServiceNow Power Platform z użyciem Microsoft Entra ID.

Jak działa Asystent Biletowy ServiceNow

  1. Użytkownik wyraża intencję (na przykład: "Muszę utworzyć zgłoszenie" lub "Jaki jest status INC0012345?").
  2. Odpowiedni temat jest wyzwalany i prezentuje adaptacyjną kartę do zebrania wymaganych danych.
  3. Komponent wywołuje API ServiceNow przez złącze i zwraca wynik.
  4. Po zakończeniu operacji temat Następne Działania przedstawia opcje dla kolejnego kroku.

Create incident

Tworzy nowy incydent ServiceNow poprzez zebranie danych od użytkownika i przesłanie ich do ServiceNow przez łącznik.

Kiedy korzystać: z help desku IT, samoobsługi pracowników lub w każdej sytuacji, w której użytkownicy muszą zgłaszać nowe incydenty bezpośrednio z rozmowy.

Utwórz przepływ incydentów

  1. Użytkownik wyraża zamiar wywołania incydentu, na przykład "Muszę utworzyć zgłoszenie na zepsuty laptop."
  2. Karta adaptacyjna zbiera wymagane szczegóły dotyczące incydentów.
  3. Komponent wywołuje API ServiceNow, aby utworzyć incydent i zwraca potwierdzenie z numerem incydentu.
  4. Prezentowane jest menu Następne Akcje , dzięki czemu użytkownik może kontynuować kolejną operację ServiceNow.

Tworz wejścia incydentalne za pomocą adaptacyjnej karty

Field Required Description
ShortDescription Yes Krótki opis problemu
Description No Szczegółowy opis problemu
Impact Yes Poziom wpływu na biznes (1-Wysoki, 2-Średni, 3-Niski)
Urgency Yes Poziom pilności (1-Wysoki, 2-Średni, 3-Niski)

Tworzenie wyjść incydentów

Komunikat potwierdzający z wyświetlonym numerem incydentu wyświetlanym w linii.

Sprawdź status incydentu

Pobiera najnowszy status i szczegóły istniejącego incydentu ServiceNow.

Sprawdź przepływ statusu incydentu

  1. Użytkownik pyta o incydent, na przykład: "Jaki jest status INC0010002?"
  2. Karta adaptacyjna zbiera numer zdarzenia.
  3. Komponent zadaje zapytanie ServiceNow i zwraca szczegóły incydentu.

Sprawdzaj dane statusu zdarzenia przez kartę adaptacyjną

Field Required Description
IncidentNumber Yes Numer zdarzenia, który warto sprawdzić, na przykład .INC0010002

Sprawdź wyjścia statusu incydentu

Field Description
IncidentNumber Identyfikator incydentu
State Obecny stan incydentu
Priority Priority level
CreatedDate Kiedy doszło do zdarzenia
LastUpdatedDate Kiedy incydent został ostatnio zmodyfikowany

Rozwiązanie lub zamknięcie incydentu

Aktualizuje stan istniejącego incydentu ServiceNow na Rozwiązane, Zamknięte, Anulowane, Wstrzymane lub W trakcie trwania, wraz ze szczegółami rozwiązania.

Rozstrzygnij lub zamkń przepływ incydentu

  1. Użytkownik wyraża zamiar rozwiązania lub zamknięcia incydentu, na przykład "Zamknąć zgłoszenie INC0010002."
  2. Karta adaptacyjna zbiera numer zdarzenia, stan celu, kod rozdzielczości oraz notatki dotyczące rozstrzygnięcia.
  3. Komponent aktualizuje incydent w ServiceNow i zwraca potwierdzenie.

Rozwiązywanie lub zamknięcie warunków wstępnych incydentów

Instancja ServiceNow z dostępem do API REST i połączeniem ServiceNow w Power Platform.

Rozwiązywanie lub zamykanie wejść incydentów za pomocą karty adaptacyjnej

Field Required Description
IncidentNumber Yes Numer incydentu do aktualizacji
State Yes Stan docelowy (Rozwiązany, zamknięty, anulowany, wstrzymany, w trakcie trwania)
ResolutionCode Yes Kategoria rozwiązywania, taka jak Solved Remotely lub Solved by Caller
ResolutionNotes Yes Opis rozdzielczości

Rozstrzygnięcie lub zamknięcie wyjść incydentów

Komunikat potwierdzający z aktualizowanym stanem incydentu wyświetlanym w linii.

Sprawdź najnowsze incydenty

Pobiera i wyświetla do 10 ostatnich incydentów ServiceNow dla obecnego użytkownika. Nie są potrzebne pola wejściowe. Komponent automatycznie korzysta z poczty e-mail zalogowanego użytkownika.

Kiedy użyć: Gdy użytkownicy chcą szybkiego przeglądu swoich ostatnich lub otwartych incydentów.

Uzyskaj przepływ ostatnich incydentów

  1. Użytkownik pyta o swoje incydenty, na przykład "Pokaż moje ostatnie incydenty."
  2. Komponent zapytuje ServiceNow o do 10 ostatnich incydentów pasujących do e-maila zalogowanego użytkownika.
  3. Szczegóły incydentu są wyświetlane bezpośrednio w rozmowie.

Otrzymuj dane o ostatnich incydentach

None. Komponent automatycznie korzysta z e-maila zalogowanego użytkownika.

Otrzymuj wyniki ostatnich incydentów

Field Description
IncidentNumber Identyfikator incydentu
State Obecny stan incydentu
Priority Priority level
ShortDescription Krótki opis problemu
CreatedDate Kiedy doszło do zdarzenia
LastUpdatedDate Kiedy incydent został ostatnio zmodyfikowany

Note

Wszystkie komponenty ServiceNow zawierają menu nawigacyjne Następne Akcje , które pojawia się po każdej operacji, pozwalając użytkownikowi szybko przejść do innej akcji ServiceNow lub wrócić do ogólnej rozmowy.

Panel szczegółów komponentów

Gdy otwierasz komponent z Biblioteki Agentów w Copilot Agent Kit, panel szczegółów pokazuje opis komponentu, kategorię, zmienne wejściowe i wyjściowe oraz używaną technologię.

Zrzut ekranu panelu szczegółów komponentu z opisem, wejściami, wyjściami i używaną technologią.

Aby zainstalować komponent i dodać go do przepływu pracy agenta, zobacz Zarządzanie komponentami.

Używaj komponentów z zarządzanym rozwiązaniem

Większość użytkowników korzysta z zarządzanego rozwiązania. Importowane komponenty są tylko do odczytu. Możesz dodać je do swoich agentów i używać bez ryzyka przypadkowej modyfikacji tematów, promptów czy przepływów.

Nawet bez edycji samych komponentów masz dwa sposoby kontrolowania zachowania: instrukcje agenta i domyślne dane narzędzi.

Agent instructions

Pole Instrukcje agenta Copilot Studio to podstawowy sposób kształtowania sposobu wykorzystania komponentów. Dzięki instrukcjom w języku naturalnym możesz kontrolować:

  • Gdy komponent jest wywoływany: Opisz scenariusze lub intencje użytkownika, które powinny wywołać każde narzędzie.
  • Jakie dane są przekazywane: Powiedz agentowi, jaki kontekst, zmienne lub historię rozmów ma uwzględnić.
  • Jak prezentowane są wyniki: Określ formatowanie, ton, działania następcze lub trasowanie po zwróceniu wyniku przez komponent.
  • Ogólna orkiestracja: Zdefiniuj kolejność operacji, gdy zaangażowanych jest wiele komponentów, na przykład: "Po zakończeniu badań wygeneruj brief wykonawczy na podstawie ustaleń."

Domyślne ustawienia narzędzi

Gdy dodajesz komponenty jako narzędzia, takie jak prompty AI Builder, możesz konfigurować parametry wejściowe bezpośrednio w Copilot Studio, nawet korzystając z zarządzania rozwiązaniami. Te dane pozwalają ustawić domyślne wartości bardziej szczegółowe niż to, co pozwalają uzyskać same instrukcje agenta. For example:

  • Zapewnij domyślne ExtractionSchema ustawienia dostosowane do dokumentów firmowych, takie jak pola faktury, takie jak imię i nazwisko, numer faktury i data.
  • Wypełnij AdditionalInstructions tekst zgodnie z preferowanym stylem pisania lub wymaganiami zgodnościowymi Twojej organizacji.

Domyślne wartości wejściowe są konfigurowane dla każdego agenta, dzięki czemu różni agenci mogą przekazywać różne wartości temu samemu współdzielonemu komponentowi.

Dostosuj komponenty za pomocą rozwiązania niezarządzanego

Jeśli musisz zmodyfikować wnętrze komponentów, na przykład zmienić logikę promptów, edytować przepływy tematów lub przełączyć złącza, musisz zaimportować rozwiązanie niezarządzane. To rozwiązanie daje pełny dostęp do edycji każdego tematu, promptu i flow w Bibliotece Agentów.

Important

Kolekcje komponentów są współdzielone w całym środowisku. Każdy komponent ma tylko jedną instancję w środowisku, więc każda edycja w temacie, promptie lub przepływie w Biblioteki Agentów dotyczy każdego agenta , który używa tego komponentu w tym samym środowisku. Zanim zmodyfikujesz komponent, upewnij się, że zmiana jest odpowiednia dla wszystkich użytkowników.

Do najczęstszych modyfikacji należą:

  • Modyfikuj prompty: Dostosuj prompty AI Builder do domeny i formatu wyjścia.
  • Zmień źródła danych: Skieruj komponenty do własnych tabel Dataverse, list SharePoint lub zewnętrznych konektorów.
  • Dostosuj tematy: Zaktualizuj przepływ rozmów tak, aby odpowiadały terminologii i procesom Twojej organizacji.
  • Aktualizuj frazy wyzwalające: Dodaj frazy wyzwalające, które odzwierciedlają naturalny sposób proszenia użytkowników.
  • Dodaj uwierzytelnianie: Konfiguruj uwierzytelnianie, jeśli komponenty potrzebują dostępu do danych specyficznych dla użytkownika.

Tip

Jeśli potrzebujesz innego zachowania dla różnych agentów, rozważ stworzenie kopii komponentu w osobnym rozwiązaniu zamiast edytowania współdzielonej instancji.