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

Note

• W oknie dialogowym Dodawanie wiedzy dostępne są 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 opisano opcję SharePoint, która zapewnia pełną obsługę SharePoint w programie Copilot Studio.

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

• 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 transkrypcjach konwersacji.

• W przypadku agentów korzystających z SharePoint jako źródła wiedzy Włącz funkcję Work IQ zapewnia lepszą jakość pozyskiwania 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.

Note

Możliwe jest użycie odpowiedzi generowanych na podstawie danych SharePoint w czatach Microsoft Teams, oraz nie wymaga to 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 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. Podaj adres 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ę selektora zmiennych obok pola adresu URL i wybierz zmienną Niestandardową, System lub Środowiskową .

5. Dodaj 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

Listy programu SharePoint 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 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. Wybierz pozycję Przeglądaj elementy , aby znaleźć żądaną listę, lub wprowadź adres URL określonej witryny programu 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 program SharePoint i uzyskaj dostęp do listy, a następnie zostanie wyświetlona w obszarze Ostatnie listy.

   

   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.

   Note

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

Important

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

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

• 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 V2 z poświadczeniami federacyjnymi
  • Microsoft Entra ID v2 z certyfikatami
  • Microsoft Entra ID V2 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:

Attribute	Operator	Value
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 Wiedza wybierz źródło programu 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 programu SharePoint. Filtr można oprzeć na jednym z następujących wyborów:

   • Title
   • Author
   • Zmodyfikowane przez
   • Data modyfikacji

5. Możesz ustawić wartość warunku na jedną z następujących wartości:

   • 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 programu 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 "bez odpowiedzi", jeśli nie będzie mógł odnaleźć wyniku w przefiltrowanych źródłach wiedzy programu SharePoint.

Używanie zmiennych jako adresów URL

Użyj zmiennych w adresach URL publicznych witryn internetowych lub źródeł wiedzy SharePoint, aby dynamicznie kontrolować zakres zawartości wykorzystywanej przez agenta.

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

Obsługa zmiennych

Podczas dodawania lub edytowania publicznej witryny internetowej lub SharePoint adresu URL źródła wiedzy można wstawić zmienną do pola adresu URL.

Użyj zmiennej do:

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

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

• Zastąp cały adres URL

  {variable}

W czasie wykonywania zmienna przyjmuje wartość ciągu znaków. Źródło wiedzy jest ograniczone do rozwiązanego adresu URL.

Note

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

Tworzenie i ustawianie zmiennej

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

1. Utwórz zmienną ciągu z zakresemglobalnym .

2. Ustaw wartość zmiennej przy użyciu 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 adresu URL, wybierając pozycję {x} (Wstaw zmienną).

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

Przykład: Zakres według produktu

Możesz ograniczyć wiedzę do różnych obszarów produktów na podstawie zapytania użytkownika.

1. Użyj informacji o temacie, aby przechwycić nazwę produktu jako zmienną o nazwie Product.

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

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

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

4. Dodaj inny węzeł Ustaw wartość zmiennej i użyj go do utworzenia nowej zmiennej globalnej typu ciągu 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żyj 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

Użyj zmiennych w publicznych źródłach wiedzy w witrynie internetowej dla:

• Routowanie oparte na produkcie: Kierowanie zapytań do dokumentacji konkretnego produktu.

• Filtrowanie regionów lub języków: mapuj User.Language na zlokalizowane adresy URL (na przykład en-us, it-it).

• Adresy URL specyficzne dla środowiska: przełączanie między lokacjami deweloperskimi, testowymi i produkcyjnymi.

Zagadnienia do rozważenia

• Publiczne źródła wiedzy witryny internetowej korzystają z wyszukiwania Bing i polegają na indeksowanej zawartości.
• Limity głębokości adresu URL są nadal stosowane w przypadku używania zmiennych.
• Zmienne zmieniają tylko docelowy adres URL. Nie mają wpływu na sposób indeksowania ani pobierania zawartości.

Important

Zmienna musi rozpoznawać prawidłowy publiczny adres URL spełniający wymagania dotyczące publicznych źródeł wiedzy w witrynie internetowej. Nieprawidłowe lub nieobsługiwane adresy URL mogą nie zwracać wyników.