Sdílet prostřednictvím


Generativní odpovědi ukazující na zdroje SharePoint nevrací výsledky

Generativní odpovědi umožňují tvůrcům vytvářet agenty, kteří odpovídají na otázky založené na zdrojích dat, jako jsou veřejné weby, nebo SharePoint, směrováním agenta na tyto zdroje dat. Někdy však agent neposkytne odpověď a místo toho vrátí něco jako "Nejsem si jistý, jak s tím pomoci. Můžeš to zkusit přeformulovat?" (Skutečná zpráva závisí na implementaci.)

Když je nakonfigurovaný zdroj dat SharePoint, může existovat několik různých faktorů, které brání uzlu Vytvořit generativní odpovědi v vrácení odpovědi, například ty, které jsou popsány v následujících částech.

Poznámka:

Než budete pokračovat, ujistěte se, že jste postupovali podle pokynů k nastavení generativních odpovědí přes SharePoint.

Chybí výsledky vyhledávání

Generativní odpovědi pro zdroj dat SharePoint spoléhají na volání Microsoft Graph koncového bodu hledání rozhraní API. Pouze první tři výsledky, které se vracejí z grafu Microsoft, se používají k shrnutí a vygenerování odpovědi. Pokud se nevrátí žádné výsledky, uzel generativních odpovědí neposkytne odpověď.

Pokud chcete diagnostikovat, proč Copilot Studio nevrací výsledky z Microsoft Graph, můžete přímo volat koncový bod hledání. Toto volání simuluje způsob, jakým Copilot Studio funguje na pozadí. Volání koncového bodu hledání lze vygenerovat pomocí následující šablony s Graph Explorerem. Při přístupu k nástroji Graph Explorer se nezapomeňte přihlásit pomocí příslušných přihlašovacích údajů pro tenanta SharePoint.

Šablonu lze použít buď zkopírováním následujícího obsahu, nebo pomocí tohoto přímého odkazu, který otevře nástroj Graph Explorer s předem vyplněným dotazem.

POST https://graph.microsoft.com/v1.0/search/query

{
    "requests": [{
            "entityTypes": ["driveItem", "listItem"],
            "query": {
                "queryString": "SEARCH TERMS filetype:docx OR filetype:aspx OR filetype:pptx OR filetype:pdf path:\"https://DOMAIN.sharepoint.com/sites/SITENAME\""
            },
            "from": 0,
            "size": 3,
            "QueryAlterationOptions": {
                "EnableModification": true,
                "EnableSuggestion": true
            }
        }
    ]
}

Chybějící výsledky

Předpokládejme, že generativní odpovědi jsou nakonfigurovány způsobem, aby poskytovaly odpovědi na základě obsahu uloženého do umístění https://<uživatelská doména>.sharepoint.com/sites/HR. Uživatelé však nedostávají odpovědi, když se ptají: „Jaké jsou naše zásady týkající se zaměstnaneckých výhod?“

Na pozadí se přepisují dotazy uživatelů, takže se do Microsoft Graph odesílají jenom hlavní klíčová slova, což vede k dotazu podobnému následujícímu příkladu:

Screenshot vyhledávacího dotazu v nástroji Graph Explorer.

Pokud se do koncového bodu vyhledávání nevrátí žádné výsledky, jak je znázorněno v následující odpovědi, odpověď neposkytnou ani generativní odpovědi.

Screenshot ukazující nevrácení výsledků vyhledávání v nástroji Graph Explorer.

Jak opravit

  1. Ujistěte se, že uzel Vytvořit generativní odpovědi odkazuje na umístění SharePoint s relevantním obsahem.

  2. Ke generování odpovědí se používají pouze dokumenty v podporovaných formátech.

    Poznámka:

    Podporovány jsou pouze moderní stránky SharePoint.

  3. Je možné, že dokumenty byly nahrány na SharePoint teprve nedávno, ale ještě nebyly indexovány. Je také možné, že existují nastavení, která brání zobrazování některých stránek ve výsledcích vyhledávání. Další informace naleznete v části Chybí výsledky vyhledávání v SharePoint Online.

Chybějící uživatelská oprávnění

Generativní odpovědi při SharePoint volání Microsoft Graph spoléhají na delegovaná oprávnění . Uživatel musí mít minimálně oprávnění ke čtení příslušných webů a souborů, jinak volání Microsoft Graph nevrátí žádné výsledky.

Pokud uživateli chybí oprávnění, nevrátí se žádné výsledky ani žádné chyby nebo výjimky. Pro uživatele bez oprávnění to vypadá, jako by nebyly nalezeny žádné dokumenty.

Jak opravit

Upravte oprávnění, aby uživatelé měli přístup k relevantním webům a souborům. Další informace najdete v části Sdílení a oprávnění v moderním prostředí SharePoint.

Registrace aplikace nebo agent jsou chybně nakonfigurované

Když správci nakonfigurují generativní odpovědi přes SharePoint, očekává se, že správci nastaví ověřování pomocí Microsoft Entra ID a nakonfigurují další obory. Pokud v registraci aplikace nebo v nastavení ověřování agent chybí obory nebo pokud nebyl udělen souhlas s požadovanými obory, nevrátí se žádné výsledky ani žádné chyby nebo výjimky. Uživateli se zdá, jako by nebyly nalezeny žádné dokumenty.

Jak opravit

Přidejte potřebné obory do registrace aplikace nebo do nastavení ověřování agent a udělte souhlas.

Následující příklad je odkaz na dobře nakonfigurovanou registraci aplikace:

Screenshot oprávnění k registraci aplikace.

Následující příklad ukazuje požadovaná nastavení ověřování v Copilot Studio:

Screenshot nastavení ověřování aplikace Copilot Studio.

Podpora velikosti souboru

V současné době SharePoint u zdrojů mohou generativní odpovědi zpracovávat pouze soubory do velikosti 7 MB. Větší soubory mohou být uloženy v SharePoint a jsou vráceny hledáním Microsoft Graph, ale nejsou zpracovány generativními odpověďmi. Jako alternativu lze nahrávat soubory do velikosti až 512 MB.

Jak opravit

Pokud soubory relevantní pro vaši konverzační AI překračují limit velikosti, možná budete chtít prozkoumat alternativní architektury, jako je použití sémantického indexování Microsoft 365 nebo připojení dati do Azure OpenAI pro generativní odpovědi.

Obsah je blokován moderováním obsahu

Když agenti Copilot Studio generují odpovědi, moderují obsah, který je škodlivý, nevyhovující nebo porušuje autorská práva. Když je obsah moderován, generativní odpovědi neposkytnou odpověď ani neindikují, že byl obsah moderován. Události moderování se ale protokolují, když agent je nakonfigurovaný tak, aby odesílal telemetrická data do Azure Applications Insights.

Po připojení agent k Azure App Insights můžete pomocí následujícího dotazu KQL (Kusto Query Language) zjistit, jestli byl obsah filtrován:

customEvents
| extend cd = todynamic(customDimensions)
| extend conversationId = tostring(cd.conversationId)
| extend topic = tostring(cd.TopicName)
| extend message = tostring(cd.Message)
| extend result = tostring(cd.Result)
| extend SerializedData = tostring(cd.SerializedData)
| extend Summary = tostring(cd.Summary)
| extend feedback = tostring(todynamic(replace_string(SerializedData,"$","")).value)
| where name == "GenerativeAnswers" and result contains "Filtered"
| where cloud_RoleInstance == "myCopilot"
| project cloud_RoleInstance, name, timestamp, conversationId, topic, message, result, feedback, Summary
| order by timestamp desc

V následujícím příkladu dotaz KQL zdůrazňuje pokus použít generativní odpovědi filtrované moderováním obsahu:

Snímek obrazovky Azure Application Insights.

Jak opravit