SharePoint le origini conoscenze non restituiscono risultati in Copilot Studio

Sommario

Questo articolo illustra come risolvere i problemi in cui SharePoint origini conoscenze non restituiscono risultati in Microsoft Copilot Studio. Quando si configura un'origine dati SharePoint, diversi fattori possono impedire all'agente di fornire una risposta. Questi fattori includono risultati di ricerca mancanti, autorizzazioni utente, contenuto protetto, problemi di registrazione delle app, limitazioni delle dimensioni dei file, condizioni di filtro o filtro della moderazione del contenuto. In questi casi, l'agente potrebbe restituire un messaggio simile a "Non sono sicuro di come aiutarlo. Puoi provare a riformulare?"

Copilot Studio offre due modi per configurare SharePoint come origine della knowledge base e questo articolo illustra entrambi i metodi:

• Origine delle conoscenze a livello di agente. Aggiungere dalla finestra di dialogo Aggiungi informazioni nelle pagine Panoramica, Knowledge o Proprietà dell'agente. Questo percorso supporta SharePoint siti (URL) e SharePoint elenchi, limitazione delle etichette di riservatezza e condizioni di filtro. Per altre informazioni, vedere Aggiungere SharePoint come origine delle informazioni.
• Origine delle conoscenze a livello di argomento. Aggiungere all'interno di un nodo Crea risposte generative in un argomento. Questo percorso associa il nodo a un URL SharePoint. Per altre informazioni, vedere Usare SharePoint contenuto per le risposte generative.

Risultati della ricerca mancanti da SharePoint

Quando Copilot Studio cerca SharePoint, usa solo i primi tre risultati della ricerca per riepilogare e generare una risposta. Se non vengono restituiti risultati di ricerca, l'agente non fornisce una risposta. Copilot Studio si basa sull'indicizzazione Microsoft Search e applica vincoli specifici ai layout di pagina, ai componenti e ai formati di file usati per generare risposte.

Correzione dei risultati della ricerca mancanti SharePoint

1. Assicurarsi che l'origine knowledge SharePoint (origine a livello di agente o Crea nodo risposte generative) punti a un percorso SharePoint con contenuto pertinente.

2. Solo i documenti nei formati supportati vengono utilizzati per generare risposte.

3. Verificare che le pagine di SharePoint che l'agente usi soddisfino i vincoli seguenti:

   • Pagine moderne: Sono supportate solo le pagine SharePoint moderne. Le pagine moderne che contengono componenti SharePoint Framework (SPFx) non sono supportate.
   • Pagine classiche: Il contenuto delle pagine classiche .aspx in SharePoint non viene usato per generare risposte.
   • Per un elenco completo dei limiti tecnici, vedere SharePoint limiti delle app Web.

4. È possibile che i documenti siano stati caricati di recente in SharePoint e non siano ancora stati indicizzati. È anche possibile che alcune impostazioni impediscano la visualizzazione di alcuni siti nei risultati della ricerca. Per ulteriori informazioni, vedi Risultati della ricerca mancanti in SharePoint Online.

   Come verificare

   • Nella barra di ricerca del portale di SharePoint immettere una parola chiave univoca dal documento di destinazione e verificare che il file venga visualizzato nei risultati della ricerca. Se il file non viene visualizzato, l'indicizzazione è incompleta.

   Come risolvere il problema

   • Attendere il completamento del ciclo di indicizzazione automatizzato.
   • Per gli aggiornamenti urgenti, SharePoint gli amministratori del sito possono attivare manualmente un reindicizzazione. In SharePoint impostazioni passare a Informazioni> sitoVisualizza tutte le impostazioni> del sitoCerca e disponibilità> offlineRe-index site. Per altre informazioni, vedere Richiedere manualmente la ricerca per indicizzazione e la reindicizzazione di un sito, una raccolta o un elenco.

Autorizzazioni utente mancanti per SharePoint

Copilot Studio rispetta Sicurezza Microsoft 365 taglio. Come minimo, un utente deve disporre delle autorizzazioni di lettura per i siti e i file pertinenti oppure non vengono restituiti risultati di ricerca.

Se l'utente non dispone di autorizzazioni, il sistema non restituisce risultati né errori o eccezioni. Per un utente senza autorizzazioni, sembra che non siano stati trovati documenti.

Verificare SharePoint autorizzazioni utente

1. Chiedere all'utente interessato di passare direttamente al percorso esatto SharePoint documento per verificare che sia possibile aprire il file.
2. Testare la query usando lo stesso account utente in Microsoft 365 Copilot Chat. Se Microsoft 365 Copilot Chat non riesce a recuperare una risposta, conferma un'autorizzazione o una barriera di indicizzazione di ricerca.

Correzione delle autorizzazioni utente mancanti SharePoint

Modificare le autorizzazioni in modo che gli utenti possano accedere ai siti e ai file pertinenti. Per ulteriori informazioni, vedi Condivisione e autorizzazioni nell'esperienza moderna di SharePoint.

Il contenuto è protetto da etichette di riservatezza, DKE o password

L'origine knowledge SharePoint a livello di agente rispetta le etichette di riservatezza per il taglio delle autorizzazioni e visualizza solo il contenuto consentito dalle etichette per l'utente connesso. Tuttavia, l'agente non può estrarre o mettere a terra contenuti la cui protezione cripta il file. Questa limitazione include etichette di sensibilità che applicano la crittografia, la Double Key Crittografia (DKE) e file protetti da password.

Tali documenti potrebbero essere visualizzati come Pronto nell'elenco delle origini conoscenze e potrebbero essere aperti dall'utente in SharePoint, ma restituiscono comunque "nessuna risposta" quando viene chiesto all'agente di visualizzare il relativo contenuto.

Verificare il contenuto SharePoint protetto

1. Aprire il file direttamente in SharePoint o nell'app desktop e verificare se richiede una password, indica la protezione DKE o mostra un'etichetta di riservatezza di crittografia.
2. Chiedere informazioni sul contenuto noto per essere visualizzato solo in file non protetti nella stessa origine. Se tali query hanno esito positivo mentre le query con ambito per i file protetti non restituiscono alcuna risposta, la protezione è la causa.

Correzione del contenuto SharePoint protetto

• Rimuovere l'etichetta di riservatezza di crittografia, la protezione DKE o la password dal file, se i criteri dell'organizzazione lo consentono.
• Pubblicare una copia non protetta del contenuto necessario in un percorso SharePoint a cui l'agente può accedere.
• Puntare l'origine conoscenze a un percorso SharePoint che non contiene contenuto crittografato.

Il collegamento di origine SharePoint viene interrotto dopo una ridenominazione

Se si rinomina un sito o una cartella SharePoint usata da un'origine knowledge a livello di agente, il collegamento di origine esistente può interrompere e causare un gap di autorizzazione. In questo caso, l'agente potrebbe non riuscire ad accedere alla Knowledge Base e non restituire alcuna risposta.

Correzione di un collegamento di origine SharePoint interrotto

1. Chiedere al amministratore di SharePoint di concedere le autorizzazioni appropriate per il percorso rinominato e generare un nuovo collegamento di origine.
2. Apri l'agente e aggiorna l'origine dati di conoscenza di SharePoint con il collegamento appena generato.

La registrazione dell'app o l'agente non è configurata correttamente per SharePoint

Quando gli amministratori configurano SharePoint origini delle informazioni, è necessario configurare l'autenticazione usando una registrazione dell'app Microsoft Entra ID e configurare ambiti aggiuntivi. Come minimo, la registrazione dell'app deve specificare gli Sites.Read.All ambiti e Files.Read.All e aggiungere tali ambiti alle impostazioni di autenticazione dell'agente insieme profile a e openid. Se gli ambiti non sono presenti nella registrazione dell'app o nelle impostazioni di autenticazione dell'agente o se il consenso non viene concesso agli ambiti necessari, l'agente non restituisce risultati né errori o eccezioni. Per un utente, sembra che non sia stato trovato alcun documento.

Correggere la registrazione dell'app o l'autenticazione dell'agente non configurata correttamente

Aggiungere gli ambiti necessari alla registrazione dell'app e alle impostazioni di autenticazione dell'agente e concedere il consenso.

L'esempio seguente è un riferimento alla registrazione di un'app ben configurata:

L'esempio seguente mostra le impostazioni di autenticazione richieste in Copilot Studio:

Limiti delle dimensioni dei file per SharePoint risposte generative

Per le origini SharePoint, se non si dispone di una licenza Microsoft 365 Copilot nello stesso tenant del proprio agente, le risposte generative possono elaborare solo file di dimensioni fino a 7 MB. È anche necessario disattivare il grafo tenant a terra con l'impostazione di ricerca semantica .

Se possiedi una licenza Microsoft 365 Copilot nello stesso tenant del tuo agente, le dimensioni massime del file sono di 200 MB. È anche necessario attivare il grafo tenant a terra con l'impostazione di ricerca semantica .

I file di dimensioni maggiori possono essere archiviati in SharePoint e vengono restituiti da una ricerca Microsoft Graph, ma non vengono elaborati dalle risposte generative. In alternativa, puoi caricare i file, che possono avere dimensioni massime di 512 MB.

Per un elenco dei limiti e delle funzionalità supportate di SharePoint, vedere Limiti delle app Web di SharePoint.

Correggere i problemi relativi alla dimensione dei file nelle risposte generative di SharePoint

Se i file pertinenti per la tua esperienza di intelligenza artificiale conversazionale superano il limite di dimensione, potresti voler esplorare architetture alternative, come l'utilizzo dell'indicizzazione semantica di Microsoft 365 o connetti i tuoi dati in OpenAI di Azure per risposte generative.

SharePoint list'origine non restituisce risultati

Per le origini delle conoscenze a livello di agente che usano elenchi di SharePoint, diversi fattori specifici dell'elenco possono causare la restituzione di alcuna risposta da parte dell'agente anche se l'elenco contiene dati pertinenti.

• La ricerca nel dataverse è obbligatoria. Copilot Studio agenti richiedono la ricerca di Dataverse per usare un SharePoint list come origine delle informazioni. Se la ricerca di Dataverse è disattivata nell'ambiente, l'elenco non può essere sottoposto a query e non vengono restituiti risultati. Per altre informazioni su come attivare la ricerca di Dataverse, vedere Configurare la ricerca di Dataverse per l'ambiente.
• Le dimensioni dell'elenco influiscono sulla qualità e la latenza. Gli elenchi che contengono più di 35.000 righe possono ridurre la qualità dei risultati e aumentare la latenza, che può essere presente come nessuna risposta per query altrimenti valide.
• Troppi elenchi in un agente. È possibile selezionare fino a 10 elenchi alla volta e, per ottenere risultati ottimali, usare non più di 10 elenchi per agente. L'aggiunta di altri elenchi aumenta la probabilità che il contenuto pertinente non venga visualizzato.
• L'elenco non viene visualizzato negli elenchi recenti. Se un SharePoint list con accesso condiviso non viene visualizzato in Elenchi personali o Elenchi recenti nel browser, aprire l'elenco in SharePoint una volta in modo che venga visualizzato in Elenchi recenti o incollare l'URL dell'elenco direttamente nella selezione url quando si aggiunge l'origine.

Risolvere i problemi relativi all'origine SharePoint list

1. Chiedere all'amministratore di attivare la ricerca di Dataverse nell'ambiente in cui viene eseguito l'agente.
2. Ridurre il numero di righe nell'elenco o suddividere elenchi di grandi dimensioni in elenchi con stato attivo più piccolo.
3. Ridurre il numero di elenchi associati all'agente a un massimo di 10, mantenendo solo gli elenchi rilevanti per gli argomenti supportati dall'agente.
4. Aggiungere nuovamente gli elenchi incollando l'URL quando non vengono visualizzati automaticamente in Elenchi recenti.

Le condizioni di filtro escludono il contenuto previsto

Entrambi i percorsi di configurazione consentono di restringere la SharePoint contenuto che l'agente può usare. Se tali filtri sono troppo restrittivi o non configurati correttamente, l'agente non restituisce alcuna risposta anche quando esiste contenuto corrispondente.

• Origine a livello di agente, Filtri delle impostazioni avanzate. In un'origine della knowledge base a livello di agente SharePoint, i filtri basati su Titolo, Autore, Modificato da o Modificato su possono escludere il contenuto richiesto dall'utente. I filtri associati a una variabile personalizzata, a una variabile di sistema o a una variabile di ambiente potrebbero risolversi in un valore imprevisto in fase di esecuzione.
• Nodo risposte generative a livello di argomento, Cerca solo origini selezionate. Quando l'opzione Cerca solo origini selezionate è attivata per un nodo Crea risposte generative , vengono usate solo le origini selezionate in tale nodo. Se l'origine SharePoint prevista non è presente nella selezione, l'agente non restituisce alcuna risposta anziché eseguire il fallback ad altre origini delle informazioni.

Verificare le condizioni di filtro

1. Nella pagina Knowledge selezionare l'origine SharePoint e quindi selezionare Modifica>impostazioni avanzate per esaminare eventuali condizioni di filtro attive e i valori in cui si risolvono.
2. Nell'argomento che ospita il nodo Crea risposte generative aprirel'origine dati> del nodo e confermare sia l'impostazione Cerca solo origini selezionate che le origini specifiche selezionate.

Correggere le condizioni di filtro

• Rimuovere o ridurre le condizioni di filtro che escludono il contenuto previsto.
• Se un filtro usa una variabile, aggiungere un passaggio di debug nella conversazione per verificare che la variabile venga risolta nel valore previsto in fase di esecuzione.
• Nel nodo a livello di argomento aggiungere l'origine SharePoint prevista alle origini selezionate o disattivare Ricerca solo origini selezionate, in modo che vengano eseguite query anche sulle origini delle informazioni a livello di agente.

Contenuto bloccato dalla moderazione del contenuto in Copilot Studio

Quando generano risposte, gli agenti di Copilot Studio moderano il contenuto che rientra nelle categorie di danni. Quando il contenuto viene moderato, le risposte generative non forniscono una risposta o un'indicazione che il contenuto è stato moderato. Tuttavia, gli eventi di moderazione vengono registrati quando l'agente è configurato per inviare dati di telemetria ad Applications Insights di Azure.

Dopo aver connesso l'agente ad app Azure Insights, puoi usare la seguente query Kusto Query Language (KQL) per scoprire se il contenuto è stato filtrato:

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

Nell'esempio seguente, la query KQL evidenzia un tentativo di utilizzare risposte generative filtrate dalla moderazione del contenuto:

Correzione della moderazione del contenuto che blocca le risposte generative

• Prova a modificare la moderazione dei contenuti, ma tieni presente che un livello inferiore di moderazione dei contenuti potrebbe comportare risposte meno accurate o pertinenti.

• Se si ritiene che il contenuto non debba essere moderato, contattare Microsoft supporto clienti.

Contenuti correlati

• Aggiungere SharePoint come origine delle informazioni
• Usare SharePoint contenuto per le risposte generative
• Configurare risposte generative su SharePoint
• limiti dell'app Web SharePoint
• Condivisione e autorizzazioni nell'esperienza moderna SharePoint
• Risolvere gli errori di filtro del contenuto di intelligenza artificiale responsabile