Otimizar a recuperação de conteúdo

Os agentes declarativos estendem o Microsoft 365 Copilot para personalizar a experiência dos usuários. Ao criar agentes declarativos, você pode adicionar conteúdo do SharePoint e carregar arquivos como fontes de conhecimento. Este artigo descreve as práticas recomendadas a serem aplicadas para otimizar a forma como seu agente retorna dados do SharePoint e fontes de conhecimento de conteúdo incorporado.

Observação

Os agentes baseados em dados do SharePoint e arquivos incorporados só estão disponíveis para usuários em locatários que têm a medição do Copilot Studio habilitada ou usuários que têm licenças do Microsoft 365 Copilot. Para obter detalhes, consulte Licenças de desenvolvedor do Microsoft 365 Copilot.

Faça referência apenas a arquivos relevantes do SharePoint

Você pode fazer referência a arquivos específicos do SharePoint por meio do OneDriveAndSharePoint objeto no manifesto do agente, por URL ou por ID.

Quando você especifica até 20 arquivos, o Copilot pesquisa o conteúdo completo de todos os arquivos. O Copilot tem acesso total a todo o conteúdo do arquivo e retorna o conteúdo apropriado ao usuário com base em sua consulta.

Para otimizar o conteúdo retornado pelo Copilot, escolha os arquivos do SharePoint mais relevantes para especificar no manifesto. Por exemplo, se uma pasta contiver oito arquivos e apenas cinco forem relevantes para a tarefa do usuário, especifique os cinco arquivos individualmente em vez de fazer referência à pasta. Para garantir que o Copilot pesquise o conteúdo completo do arquivo, a prática recomendada é limitar a contagem total de páginas dos arquivos relevantes especificados a não mais do que 300 páginas.

Limitar o tamanho do arquivo do SharePoint

Quando você faz referência a sites ou pastas do SharePoint por URL no manifesto do agente e os arquivos incluídos no site ou pasta são grandes, o Copilot pode ter problemas para identificar o conteúdo certo a ser retornado ao usuário. Para reduzir o risco de o Copilot não encontrar o conteúdo correto nos sites ou pastas que você referenciar, mantenha seus arquivos do SharePoint com no máximo 36.000 caracteres (aproximadamente 15 a 20 páginas). Se os seus arquivos tiverem mais de 36.000 caracteres, considere dividi-los em arquivos mais curtos separados para ajudar o Copilot a verificar todo o conteúdo.

Como alternativa, você pode fazer referência a arquivos específicos do SharePoint por ID. O Copilot pesquisará o conteúdo completo de todos os arquivos se você especificar 20 ou menos arquivos. Se você especificar mais de 20 arquivos, ele pesquisará o conteúdo completo dos 20 arquivos mais relevantes.

Remover formatação especial

No momento, o Copilot não consegue analisar tabelas e outras formatações especiais no conteúdo do SharePoint. Para garantir que o Copilot possa consumir seu conteúdo do SharePoint, remova tabelas ou outra formatação especial do conteúdo antes de fazer referência a ele no manifesto do agente.