Dodawanie SharePoint jako źródła wiedzy

SharePoint jako źródło wiedzy działa przez parowanie agenta z adresem URL SharePoint lub listami SharePoint. W tym artykule omówiono pełne funkcje integracji SharePoint udostępniane przez wybranie opcji SharePoint w oknie dialogowym Dodaj wiedzę.

Notatka

• W oknie dialogowym Dodaj wiedzę dostępne są dwie opcje SharePoint. Opcja SharePoint w sekcji przekazywania plików służy do przekazywania pojedynczych plików lub folderów SharePoint i umożliwia synchronizację plików. W tym artykule opisano opcję SharePoint, która zapewnia pełną obsługę SharePoint w programie Copilot Studio.

• Aby uzyskać listę limitów i obsługiwanych funkcji SharePoint, zobacz Copilot Studio web app SharePoint limity.

• Aby dodać pojedyncze pliki lub foldery SharePoint, zobacz Dodaj pliki i foldery SharePoint.

• Odpowiedzi agentów, które używają SharePoint jako źródła wiedzy, nie są uwzględniane w transkrypcje rozmów.

• W przypadku agentów zakotwiczonych w źródłach wiedzy programu SharePoint włączenie zakotwiczenia wykresu dzierżawy za pomocą wyszukiwania semantycznego zapewnia lepszą jakość pobierania wiedzy i odpowiedzi. Ta funkcja wykorzystuje nowoczesne narzędzia do wyszukiwania wewnętrznego, które pozwalają agentowi uzyskać większą objętość kontekstu z większą precyzją. Jednak ze względu na zwiększoną złożoność systemu niektórzy użytkownicy i zapytania mogą doświadczyć niewielkiego wzrostu opóźnień.

Podczas publikowania agenta połączenia z użyciem generatywnych odpowiedzi są wykonywane w imieniu użytkownika, który rozmawia z agentem, przy użyciu ustawień uwierzytelniania skonfigurowanych w agencie. Domyślnie agenci utworzeni w Copilot Studio i Microsoft Teams są konfigurowani przy użyciu opcji uwierzytelniania Uwierzytelnianie z usługą Microsoft, która działa w środowiskach takich jak Microsoft Teams, Power Apps i Microsoft 365 Copilot.

Notatka

Można używać generatywnych odpowiedzi z danymi SharePoint w czatach w Microsoft Teams, nie wymagając ręcznego uwierzytelniania. Aby użyć tej metody dla wcześniej opublikowanego agenta, skonfiguruj ponownie agenta do używania Authenticate z firmą Microsoft a następnie opublikuj go ponownie w 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 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ę SharePoint jako źródło wiedzy, wykonaj następujące kroki:

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 Featured wybierz pozycję SharePoint.

   

4. Podaj adres URL SharePoint. Oddziel wiele adresów URL ręcznymi podziałami wierszy (użyj Shift + Enter).

5. Wprowadź nazwę i opis. Opis powinien być szczegółowy, zwłaszcza jeśli generatywne AI jest włączone, ponieważ pomaga w generatywnej orkiestracji.

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

Dodawanie list SharePoint jako źródła wiedzy

SharePoint list to popularny sposób przechowywania danych tabelarycznych i zapewnia szybki, łatwy dostęp do informacji. Agent może używać tych list jako źródła wiedzy. Dodając listę SharePoint jako źródło wiedzy, tworzysz połączenie w czasie rzeczywistym ze źródłem, dzięki czemu najbardziej aktualne dane są używane na potrzeby zapytań i rozumowania. Użytkownicy są uwierzytelniani przy użyciu poświadczeń SharePoint, co gwarantuje, że mają uprawnienia dostępu do danych, zanim agent udostępni 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 generatywnych odpowiedzi.

3. W sekcji Przekazywanie pliku wybierz pozycję SharePoint.

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

   

5. Po wybraniu pozycji Przeglądaj elementy okno dialogowe zostanie automatycznie wypełnione ciągiem Moje listy i Ostatnie listy. My Lists wyświetla tylko listy utworzone w aplikacji SharePoint List. Wszystkie inne listy są wyświetlane na listach ostatnio używanych. Jeśli nie widzisz potrzebnej listy, otwórz SharePoint i uzyskaj dostęp do listy, a następnie zostanie wyświetlona w Recent Lists.

   

   Można wybrać maksymalnie 15 list jednocześnie. 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 SharePoint z dostępem udostępnionym, ale nie jest ona wyświetlana w Recent Lists wklej adres URL listy do zaznaczenia adresu URL.

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

7. Wprowadź nazwę i opis. Opis powinien być szczegółowy, zwłaszcza jeśli generatywne AI jest włączone, ponieważ pomaga w generatywnej orkiestracji.

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

Zaawansowane scenariusze uwierzytelniania

Domyślnie agenci programu Copilot Studio wstępnie konfigurują agentów do uwierzytelniania użytkowników przy użyciu uwierzytelniania firmy Microsoft w celu uzyskiwania dostępu do źródeł SharePoint podczas nawiązywania połączenia z agentem za pośrednictwem Microsoft Teams, Power Apps lub Microsoft 365 Copilot. Jeśli jednak konieczne jest ręczne skonfigurowanie uwierzytelniania, poniższe kroki są wymagane do generowania odpowiedzi na potrzeby pracy z SharePoint źródłami danych.

Ważne

Jeśli Restricted SharePoint Search jest włączona, użycie SharePoint jest zablokowane.

• 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ć swojego agenta, zobacz Uwierzytelnianie.

• Aby uzyskać instrukcje dotyczące tworzenia wymaganej rejestracji aplikacji Microsoft Entra ID, zobacz Konfiguruj uwierzytelnianie użytkownika za pomocą Microsoft Entra ID. Podczas tworzenia tej rejestracji użytkownik lub administrator musi określić zakresy Sites.Read.All i Files.Read.All w rejestracji aplikacji Microsoft Entra ID.

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

• Podczas konfigurowania uwierzytelniania zakresy kontrolują dostęp użytkowników. Określ Sites.Read.All i Files.Read.All w polu zakresów w pobliżu istniejących wartości profile i openid w programie 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 ustawienie Uwierzytelniaj ręcznie z następującymi dostawcami usług uwierzytelniania:

  • Microsoft Entra ID
  • Microsoft Entra ID w wersji V2 z poświadczeniami federacyjnymi
  • Microsoft Entra ID v2 z certyfikatami
  • Microsoft Entra ID w wersji 2 z sekretami klienta

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

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

Filtrowanie źródła SharePoint

Twórcy mogą poprawić wydajność źródła wiedzy SharePoint agenta, określając parametry zapytania wyszukiwania. Te parametry zapytań definiują, co jest wyszukiwane w źródle wiedzy. Na przykład możesz określić, że chcesz wyszukiwać tylko elementy, które zostały zmodyfikowane w ciągu ostatnich sześciu miesięcy. Ten typ filtra zostanie skonstruowany tak:

Atrybut	Operator	Wartość
Modified on	on or after	X date

Tworzenie warunków filtrowania

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

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

2. Wybierz trzy kropki (... ) dla źródła SharePoint i wybierz Edytuj.

3. Wybierz pozycję Ustawienia zaawansowane.

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

   • Nazwa
   • Autor
   • Zmodyfikowane przez
   • Data modyfikacji

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

   • Wartość statyczna
   • Dane wejściowe dostarczane przez użytkownika podczas interakcji z agentem, które są następnie zapisywane jako niestandardowa zmienna globalna
   • Zmienna systemowa

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

Więcej ustawień polepszających wyszukiwanie

Jeśli chcesz filtrować źródło SharePoint, należy wyłączyć następujące ustawienia:

• Wyszukiwanie w Sieci Web
• Na poziomie agenta ustawienie Użyj ogólnej wiedzy w ustawieniach generatywnej inteligencji agenta
• Na poziomie tematu 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.