Otimizar a obtenção de conteúdo

Os agentes declarativos expandem Microsoft 365 Copilot para personalizar a experiência para os utilizadores. Quando cria agentes declarativos, pode adicionar conteúdos do SharePoint e carregar ficheiros como origens de conhecimento. Este artigo descreve as melhores práticas a aplicar para otimizar a forma como o agente devolve dados do SharePoint e origens de conhecimento de conteúdo incorporado.

Observação

Os agentes baseados em dados do SharePoint e ficheiros incorporados só estão disponíveis para utilizadores em inquilinos que tenham Copilot Studio medição ativada ou utilizadores com licenças de Microsoft 365 Copilot. Para obter detalhes, veja Microsoft 365 Copilot licenças de programador.

Referenciar apenas ficheiros do SharePoint relevantes

Pode referenciar ficheiros específicos do SharePoint através do OneDriveAndSharePoint objeto no manifesto do agente, seja por URL ou por ID.

Quando especificar até 20 ficheiros, o Copilot procura o conteúdo completo de todos os ficheiros. O Copilot tem acesso total a todo o conteúdo do ficheiro e devolve o conteúdo adequado ao utilizador com base na respetiva consulta.

Para otimizar o conteúdo devolvido pelo Copilot, selecione os ficheiros do SharePoint mais relevantes a especificar no seu manifesto. Por exemplo, se uma pasta contiver oito ficheiros e apenas cinco forem relevantes para a tarefa do utilizador, especifique os cinco ficheiros individualmente em vez de referenciar a pasta. Para garantir que o Copilot pesquisa o conteúdo completo do ficheiro, a melhor prática é limitar a contagem total de páginas dos ficheiros relevantes que especificar para um máximo de 300 páginas.

Limitar tamanho de ficheiro do SharePoint

Quando referencia sites ou pastas do SharePoint por URL no manifesto do agente e os ficheiros incluídos no site ou pasta forem grandes, o Copilot poderá ter dificuldades em identificar o conteúdo certo para regressar ao utilizador. Para reduzir o risco de o Copilot não encontrar o conteúdo certo nos sites ou pastas que referencia, mantenha os seus ficheiros do SharePoint num máximo de 36 000 carateres (aproximadamente 15 a 20 páginas). Se os seus ficheiros tiverem mais de 36 000 carateres, considere dividi-los em ficheiros mais curtos separados para ajudar o Copilot a analisar todo o conteúdo.

Em alternativa, pode referenciar ficheiros específicos do SharePoint por ID. O Copilot procurará o conteúdo completo de todos os ficheiros se especificar 20 ou menos ficheiros. Se especificar mais de 20 ficheiros, este irá procurar no conteúdo completo dos 20 ficheiros mais relevantes.

Remover formatação especial

Atualmente, o Copilot não consegue analisar tabelas e outra formatação especial em conteúdos do SharePoint. Para garantir que o Copilot pode consumir os seus conteúdos do SharePoint, remova tabelas ou outra formatação especial do conteúdo antes de o referenciar no manifesto do agente.