Dodawanie programu SharePoint jako źródła wiedzy

Możesz użyć SharePoint jako źródła wiedzy, łącząc swojego agenta z adresem URL SharePoint lub listami SharePoint. W tym artykule przedstawiono pełną funkcjonalność integracji z SharePoint, dostępną po wybraniu opcji SharePoint w dialogu Dodaj wiedzę.

Notatka

• W oknie dialogowym Dodawanie wiedzy pojawią się dwie opcje programu SharePoint. Opcja programu SharePoint w sekcji przekazywania plików służy do przekazywania poszczególnych plików lub folderów programu SharePoint i umożliwia synchronizację plików. W tym artykule omówiono opcję programu SharePoint, która zapewnia pełną obsługę programu SharePoint w programie Copilot Studio.

• Aby uzyskać listę limitów i obsługiwanych funkcji programu SharePoint, zobacz Limity programu SharePoint aplikacji internetowej.

• Aby dodać poszczególne pliki lub foldery programu SharePoint, zobacz Dodawanie plików i folderów programu SharePoint.

Gdy używasz SharePoint jako źródła wiedzy, transkrypcje rozmów nie obejmują treści dokumentów źródłowych, które posłużyły do wyodpowiedzi generatywnych (pole search_results). Pytania i odpowiedzi są nadal uwzględnione.

• W przypadku agentów zakotwiczonych w źródłach wiedzy programu SharePoint Włączenie Work IQ zapewnia lepszą jakość pobierania wiedzy i odpowiedzi. Ta funkcja używa najnowocześniejszych wewnętrznego narzędzi do pobierania, które umożliwiają agentowi uzyskanie większej ilości kontekstu z większą precyzją. Jednak ze względu na zwiększoną złożoność systemu w przypadku niektórych użytkowników i zapytań mogą nieco wzrosnąć opóźnienia.

Gdy opublikujesz swojego agenta, połączenia korzystające z odpowiedzi generatywnych są wykonywane w imieniu użytkownika prowadzącego rozmowę z agentem. Agent korzysta z ustawień uwierzytelniania, które konfigurujesz. Domyślnie, agenty utworzone w Copilot Studio i w Microsoft Teams są automatycznie skonfigurowane do uwierzytelniania tożsamością Microsoft. Ta opcja działa w środowiskach takich jak Microsoft Teams, Power Apps i Microsoft 365 Copilot.

Notatka

Obecnie można używać odpowiedzi generatywnych z danymi SharePoint w czatach Microsoft Teams i nie wymagają uwierzytelniania ręcznego. Aby użyć tej metody dla wcześniej opublikowanego agenta, należy ponownie skonfigurować agenta tak, aby korzystał z Uwierzytelnianie za pomocą Microsoft, a następnie ponownie opublikować go w witrynie Microsoft Teams. Może minąć kilka godzin, zanim ta zmiana zacznie obowiązywać. Jeśli użytkownik jest w trakcie rozmowy i wydaje się, że zmiana nie weszła w życie, może wpisać „zacznij od nowa” na czacie, aby wymusić ponowne rozpoczęcie rozmowy z najnowszą wersją agenta. Zmiany te są teraz dostępne dla czatów Teams 1:1 pomiędzy użytkownikiem a agentem. Nie są one jeszcze dostępne dla czatów grupowych ani wiadomości na kanałach.

Jeśli chcesz użyć ręcznego uwierzytelnienia dla agenta, zobacz Zaawansowane scenariusze uwierzytelnienia.

Dodawanie witryn programu SharePoint jako źródła wiedzy

Gdy użytkownik zada pytanie, a agent nie ma tematu, którego można użyć jako odpowiedzi, agent przeszukuje adres URL i wszystkie ścieżki podrzędne. Na przykład adres URL taki jak contoso.sharepoint.com/sites obejmuje również podścieżki, takie jak contoso.sharepoint.com/sites/policies. Odpowiedzi generatywne podsumowują tę treść w ukierunkowanej odpowiedzi.

Aby dodać witrynę programu SharePoint jako źródło wiedzy, wykonaj następujące czynności:

1. Otwórz aplikację agenta.

2. Wybierz pozycję Dodaj wiedzę na stronach Przegląd lub Wiedza albo w węźle Właściwości generatywnych odpowiedzi.

3. W sekcji Polecane wybierz pozycję SharePoint.

   

4. Wprowadź URL SharePoint. Oddziel wiele adresów URL ręcznymi podziałami wierszy (użyj Shift + Enter). Aby użyć zmiennej zamiast statycznego adresu URL, wybierz ikonę wyboru zmiennej obok pola URL i wybierz zmienną Custom, System lub Environment.

5. Wprowadź nazwę i opis. Podaj szczegółowy opis, zwłaszcza jeśli generatywna AI jest włączony, ponieważ pomaga w orkiestracji generatywnej.

6. Wybierz Dodaj do agenta, aby zakończyć dodawanie źródła wiedzy.

Zaktualizuj link źródłowy, jeśli strona lub folder SharePoint zmieni nazwę

Jeśli zmienisz nazwę strony lub folderu SharePoint, którego używa źródło wiedzy, istniejący link źródłowy może przestać działać i spowodować lukę w uprawnieniach. W takim przypadku agent może nie uzyskać dostępu do bazy wiedzy.

Aby przywrócić dostęp:

1. Poproś administratora SharePoint o przyznanie odpowiednich uprawnień do przemianowanej lokalizacji oraz wygenerowanie nowego linku źródłowego.

2. Otwórz agenta i zaktualizuj źródło wiedzy SharePoint z nowo wygenerowanym linkiem.

Dodawanie list programu SharePoint jako źródła wiedzy

Listy programu SharePoint to popularny sposób przechowywania danych tabelarycznych. Zapewnia on szybki i łatwy dostęp do informacji. Agent może używać tych list jako źródła wiedzy. Dodając listę programu SharePoint jako źródło wiedzy, tworzysz połączenie w czasie rzeczywistym ze źródłem, więc najbardziej aktualne dane są używane na potrzeby zapytań i wnioskowania. Użytkownicy są uwierzytelniani przy użyciu poświadczeń programu SharePoint, co gwarantuje, że mają uprawnienia dostępu do danych, zanim agent poda odpowiedź.

1. Otwórz aplikację agenta.

2. Wybierz pozycję Dodaj wiedzę na stronach Przegląd lub Wiedza albo w węźle Właściwości odpowiedzi generatywnych.

3. W sekcji Wyróżnione lub w sekcji Prześlij plik wybierz SharePoint.

   

4. Wybierz pozycję Przeglądaj elementy, aby znaleźć żądaną listę, lub wprowadź adres URL określonej listy programu SharePoint.

   

5. Po wybraniu pozycji Przeglądaj elementy, okno dialogowe zostanie automatycznie wypełnione elementami w sekcjach Moje listy i Ostatnio używane listy. Moje listy wyświetla tylko listy utworzone w aplikacji Listy w programie SharePoint. Wszystkie inne listy są wyświetlane na listach Ostatnio używane listy. Jeśli nie widzisz potrzebnej listy, otwórz program SharePoint i przejdź do listy. Lista zostanie wtedy wyświetlona w obszarze Ostatnio używane listy.

   

   Jednocześnie można eksportować maksymalnie 10 list. Aby uzyskać najlepsze wyniki, użyj maksymalnie 10 list na agenta. Listy zawierające więcej niż 35 000 wierszy wpływają na jakość i opóźnienia.

   Każda lista jest dodawana do źródeł wiedzy agenta jako osobny element. Aby dodać więcej list do agenta, ponownie wykonaj te kroki i wybierz kolejne listy.

   Notatka

   Jeśli chcesz użyć listy programu SharePoint, którą Ci udostępniono, ale która nie jest wyświetlana w sekcji Ostatnio używane listy, wklej adres URL listy do pola wybierania adresu URL.

6. Po wybraniu żądanych list kliknij pozycję Potwierdź wybór.

7. Wprowadź nazwę i opis. Podaj szczegółowy opis, zwłaszcza jeśli generatywna AI jest włączony, ponieważ pomaga w orkiestracji generatywnej.

8. Wybierz Dodaj do agenta, aby zakończyć dodawanie źródła wiedzy.

Zaawansowane ustawienia scenariuszy

Domyślnie Copilot Studio wstępnie konfiguruje agentów do uwierzytelniania użytkowników przy użyciu uwierzytelniania Microsoft w celu uzyskania dostępu do źródeł SharePoint, gdy łączą się oni z agentem poprzez Microsoft Teams, Power Apps lub Microsoft 365 Copilot. Jeśli jednak jest konieczne ręczne skonfigurowanie uwierzytelniania, w celu uzyskania odpowiedzi generatywnych na potrzeby pracy ze źródłami danych SharePoint.

Ważne

Jeśli funkcja Ograniczone wyszukiwanieSharePoint jest włączona, korzystanie z SharePoint jest blokowane.

• Odpowiedzi generatywne ze źródeł SharePoint nie są dostępne dla użytkowników-gości w aplikacjach z obsługą logowania jednokrotnego.

• Aby uwierzytelnić swój agent, zobacz Uwierzytelnianie.

• Aby uzyskać instrukcje tworzenia wymaganej rejestracji usługi Microsoft Entra ID, zobacz Konfigurowanie uwierzytelniania użytkownika przy użyciu Microsoft Entra ID. Podczas tworzenia tej rejestracji użytkownik lub administrator musi określićSites.Read.All oraz Files.Read.All zakresy w rejestracji usługi Microsoft Entra ID.

• Wybranie Bez uwierzytelniania określa, że agent nie pobiera informacji z SharePoint.

• Po skonfigurowaniu uwierzytelniania zakresy kontrolują dostęp użytkowników. Określ Sites.Read.All i Files.Read.All w polu zakresy obok istniejących profile i openid wartości w Copilot Studio. Te zakresy nie dają użytkownikom zwiększonych uprawnień podczas korzystania z agent, ale zezwalają na ich dozwoloną zawartość z witryny zgodnie z SharePoint konfiguracją dla odpowiedzi generatywnych.

• SharePoint obsługuje następujących dostawców usługi uwierzytelniania w opcji Uwierzytelnij ręcznie:

  • Microsoft Entra ID
  • Microsoft Entra ID V2 z poświadczeniami federacyjnymi
  • Microsoft Entra ID V2 z certyfikatami
  • Microsoft Entra ID V2 z kluczami tajnymi klienta

• Program SharePoint nie obsługuje uwierzytelniania ręcznego przy użyciu ogólnego uwierzytelniania OAuth.

• Ta konfiguracja dotyczy tylko odpowiedzi generatywnych i nie ma zastosowania do łączników Power Platform.

Filtrowanie źródła programu SharePoint

Twórcy mogą wspomóc funkcjonowanie źródła wiedzy SharePoint agenta, określając parametry zapytania wyszukiwania. Te parametry zapytania definiują, co będzie wyszukiwane w źródle wiedzy. Można na przykład określić, że chcesz wyszukać tylko elementy, które zostały zmodyfikowane w ciągu ostatnich 6 miesięcy. Ten typ filtra należy skonstruować w następujący sposób:

Atrybut	Operator	Value
Modified on	on or after	X date

Tworzenie warunków filtrowania

Po dodaniu źródła wiedzy programu SharePoint można ustawić warunki wyszukiwania.

1. Na stronie Wiedza wybierz źródło programu SharePoint.

2. Wybierz ikonę menu Więcej (…) źródła programu SharePoint, a następnie wybierz opcję Edytuj.

3. Wybierz pozycję Ustawienia zaawansowane.

4. Skompiluj filtry, aby uwzględniać lub wykluczać informacje ze źródła wiedzy programu SharePoint. Filtr można oprzeć na jednym z następujących kryteriów:

   • Tytuł
   • Autor
   • Zmodyfikowany przez
   • Data modyfikacji

5. Wartość warunku można ustawić na jedną z następujących:

   • Wartość statyczna
   • Zmienna wejściowa, którą użytkownik podaje podczas konwersacji z agentem i która jest następnie zapisywana jako niestandardowa zmienna globalna
   • A Zmienna systemowa

6. Po zakończeniu konfigurowania filtrów wybierz Zapisz.

Więcej ustawień polepszających wyszukiwanie

Jeśli chcesz filtrować źródło programu SharePoint, wyłącz następujące ustawienia:

• Wyszukiwanie w sieci Web
• Na poziomie agenta ustawienie Użyj wiedzy ogólnej w ustawieniach generatywnej sztucznej inteligencji
• Na poziomie tematu ustawienie Zezwalaj AI na używanie własnej wiedzy ogólnej (wersja zapoznawcza) w węźle odpowiedzi generatywnych

Wyłączenie tych ustawień gwarantuje, że agent odpowie „brak odpowiedzi”, jeśli nie będzie mógł odnaleźć wyniku w wyfiltrowanym źródle wiedzy programu SharePoint.

Używanie zmiennych jako adresów URL

Używaj zmiennych w adresach URL publicznych stron internetowych lub źródeł wiedzy SharePoint, aby dynamicznie kontrolować zakres treści, z których korzysta Twój agent.

Zamiast tworzyć wiele źródeł wiedzy dla różnych scenariuszy, utwórz jedno źródło wiedzy i dodaj zmienną do adresu URL. W czasie wykonywania program Copilot Studio rozpoznaje zmienną i używa wynikowego adresu URL do ugruntowania.

Wsparcie zmiennych

Gdy dodajesz lub edytujesz adres URL publicznej strony internetowej lub źródła wiedzy SharePoint, możesz wstawić zmienną do pola URL.

Używanie zmiennej w celu:

• Dołączanie ścieżki do bazowego adresu URL

  https://www.contoso.com/{variable}

• Zastępowanie całego adresu URL

  {variable}

W środowisku uruchomieniowym zmienna zostaje przekształcona do wartości ciągu znaków. Źródło wiedzy jest ograniczone do rozwiązanego adresu URL.

Notatka

Używanie zmiennej zmienia adres URL używany do ugruntowania. Użycie zmiennej nie zmienia wymagań dotyczących struktury URL ani ograniczeń głębokości dla publicznych witryn internetowych.

Tworzenie i ustawianie zmiennej

Aby użyć zmiennej w publicznej witrynie internetowej lub w źródle wiedzy SharePoint:

1. Utwórz zmienną typu string z zakresem globalnym.

2. Ustaw wartość zmiennej za pomocą jednej z następujących opcji:

   • Dane wejściowe tematu
   • Właściwości profilu użytkownika, takie jak język
   • Zmienne środowiskowe
   • Przepływy agenta czy łączniki

3. Wstaw zmienną do pola URL, wybierając {{x}} (Wstaw zmienną).

4. Przetestuj agenta, aby potwierdzić, że zmienna zostanie rozpoznana pod oczekiwanym adresem URL.

Przykład: Zakres dla produktu

Możesz dostosować zakres wiedzy do różnych obszarów produktu w zależności od zapytania użytkownika.

1. Użyj tematu wejściowego, aby przechwycić nazwę produktu jako zmienną o nazwie Product.

2. Dodaj węzeł Ustaw wartość zmiennej po węźle Wyzwalacz, a następnie utwórz nową zmienną o nazwie ProductTable.

3. Użyj formuły Power Fx, aby zdefiniować i odwzorować nazwy produktów na ścieżki URL.

    Table(
        { Product: "Copilot", Path: "microsoft-365-copilot" },
        { Product: "Teams", Path: "microsoft-teams" },
        { Product: "Surface", Path: "surface" }
    )
   

4. Dodaj kolejny węzeł Ustaw wartość zmiennej i użyj go do utworzenia nowej globalnej zmiennej typu ciąg o nazwie GlobalProductURL.

5. W ustawieniu Do wartości wybierz pozycję Formuła i użyj funkcji Power Fx, aby wykonać wyszukiwanie w tabeli na podstawie zmiennej wartości wejściowej Product, Topic.Product, w następujący sposób:

   LookUp(Topic.ProductTable, Product = Topic.Product, Path)

6. Używanie zmiennej w adresie URL źródła wiedzy:

   https://www.microsoft.com/en-us/{GlobalProductURL}

Agent wykonuje zapytania tylko w sekcji witryny internetowej o określonym zakresie w trakcie wykonywania.

Typowe scenariusze

Wykorzystaj zmienne w publicznych źródłach wiedzy w witrynach internetowych do:

• Routing oparty na produkcie: Ogranicz zapytania do konkretnej dokumentacji produktu.

• Filtrowanie według regionu lub języka: mapuj User.Language do zlokalizowanych adresów URL (na przykład en-us, it-it).

• Adresy URL specyficzne dla środowiska: przełączaj się między stronami programistycznymi, testowymi i produkcyjnymi.

Kwestie wymagające rozważenia

• Publiczne źródła wiedzy korzystają z wyszukiwania Bing i opierają się na treściach zindeksowanych.
• Limity głębokości adresów URL nadal obowiązują, gdy używasz zmiennych.
• Zmienne zmieniają tylko docelowy URL. Nie wpływają na sposób indeksowania, ani pobierania treści.

Ważne

Zmienna musi wskazywać na prawidłowy publiczny adres URL, który spełnia wymagania dotyczące publicznych źródeł wiedzy. Nieprawidłowe lub nieobsługiwane adresy URL mogą nie zwracać wyników.