Dados não estruturados como fonte de conhecimento

Ao usar o Copilot Studio, você pode aprimorar seus agentes com conhecimento específico de domínio, alimentado pelas mesmas fontes de dados confiáveis e familiares que você constrói por meio dos conectores Power Platform.

Ao enviar conteúdo externo do seu dispositivo, OneDrive ou SharePoint, pode enriquecer seus agentes com conhecimento contextual adaptado ao seu negócio. O Microsoft Dataverse armazena esses arquivos de forma segura e os processa automaticamente em índices semânticos e embeddings vetoriais. Essa configuração permite aos agentes gerem respostas mais precisas, embasadas nas informações fornecidas por você.

Arquivos enviados no Copilot Studio usam o Microsoft Dataverse para ingerir arquivos brutos e criar índices e embeddings vetoriais. Esses índices e embeddings ajudam a fornecer respostas de qualidade para seus agentes. Você pode enviar esses arquivos do seu computador ou conectando-se ao OneDrive ou SharePoint.

Quando você faz upload de arquivos como fontes de conhecimento, ajuda a enriquecer seus agentes com dados extras, aumenta o conhecimento do modelo de linguagem e fundamenta o agente em informações específicas que você fornece. Você pode enviar vários arquivos, que são indexados semanticamente como embeddings vetoriais e depois usados como conhecimento para agentes. Você pode compartilhar esse conhecimento usado em agentes com usuários autenticados e não autenticados do agente.

Para melhorar as respostas do agente, o sistema carregava os arquivos em partes para um processamento mais rápido e os indexava vetorialmente para fornecer correspondências semânticas com a consulta do usuário. O sistema armazena os arquivos de forma segura no Dataverse. Quando um usuário faz uma consulta por meio de um agente, o Copilot Studio encontra as partes mais relevantes correspondentes à intenção da consulta do usuário e retorna os resultados para o usuário. 

Da mesma forma, o Dataverse ingere arquivos OneDrive, arquivos SharePoint (usando as opções em upload de arquivos) e conteúdo não estruturado, como artigos de base de conhecimento de outros sistemas empresariais, como Salesforce, ServiceNow, Confluence e ZenDesk, para fornecer melhores resultados semânticos ao agente.

Observação

Para obter mais informações sobre como usar dados estruturados, consulte Usar intérprete de código para analisar dados estruturados.

Conectores do Power Platform para dados não estruturados

Os seguintes conectores do Power Platform estão configurados para funcionar com fontes de dados não estruturadas:

OneDrive

O OneDrive permite que os criadores usem uma interface seletor de arquivos para escolher os arquivos e pastas que desejam incluir. Uma vez selecionados, o sistema recupera os itens no Dataverse e os indexa para uso. As pastas que você adiciona incluem todos os arquivos suportados e subpastas dentro daquela pasta até o limite total de arquivos.

SharePoint

O SharePoint permite que os criadores usem uma interface seletor de arquivos para escolher os arquivos e pastas que desejam incluir. Uma vez selecionados, os itens são recuperados no Dataverse e indexados para uso. As pastas que você adiciona incluem todos os arquivos suportados e subpastas dentro daquela pasta até o limite total de arquivos. Atualmente, não há suporte para Pages.

Salesforce

O conector do Salesforce para dados não estruturados oferece suporte à capacidade de recuperar a Base de Dados de Conhecimento contendo artigos de conhecimento. Os criadores selecionam uma Base de Dados de Conhecimento e todos os artigos dessa Base de Dados de Conhecimento são indexados para uso. Você não pode selecionar artigos ou tópicos individuais. Ao consultar dados, você não pode especificar um artigo ou base de conhecimento específico. A lista Conhecimento mostra um único objeto para todos os objetos de conhecimento selecionados ao criar a origem.

ServiceNow

O conector do ServiceNow para dados não estruturados dá suporte à capacidade de recuperar bases de dados de conhecimento contendo artigos de conhecimento. As bases de dados de conhecimento contêm artigos. Os criadores selecionam uma Base de Dados de Conhecimento e todos os artigos dessa Base de Dados de Conhecimento são indexados para uso. Você não pode selecionar artigos individuais. Ao consultar dados, você não pode especificar uma base de conhecimento, pasta ou artigo individual. A lista Conhecimento mostra um único objeto para todos os objetos de conhecimento selecionados ao criar a origem.

Confluência

O conector Confluence para dados não estruturados suporta a capacidade de recuperar os espaços contendo páginas. O conector também suporta subpastas. Você não pode selecionar páginas individuais. Ao consultar dados, você não pode especificar uma página. A lista de conhecimento mostra um único objeto para todas as páginas dentro do espaço.

Zendesk

O conector do Zendesk para dados não estruturados dá suporte à capacidade de recuperar a base de dados de conhecimento contendo artigos de conhecimento. Você não pode selecionar artigos, categorias ou seções individuais. Ao consultar dados, você não pode especificar um artigo, categoria ou seção. A lista de conhecimento mostra um único objeto para todos os artigos dentro da base de dados de conhecimento.

Segurança

Quando um usuário consulta um agente que está usando uma fonte do Power Platform Connector, o sistema realiza algumas verificações de autorização.

Acesso do Conector

Quando um fabricante usa pela primeira vez uma fonte baseada em conectores, o sistema o orienta a selecionar um conector existente da Power Platform ou a adicionar um. Esse processo garante que os dados só sejam compartilhados com criadores que tenham as permissões indicadas e dá acesso à própria fonte de dados.

Consentir Acesso

Quando um usuário faz uma consulta, o sistema usa suas informações de conexão para verificar a fonte dos dados e verificar se ele tem permissão para ver o conteúdo. Embora o sistema armazene chunks e índices localmente no Dataverse, ele realiza uma verificação em tempo real das consultas para garantir que o usuário atual tenha acesso aos dados antes de fornecer um resumo ou resposta.

Observação

• Se um usuário não tiver permissão para um conjunto específico de arquivos ou artigos da base de conhecimento, o sistema não retorna um resultado para ele. Em vez disso, recebem uma mensagem padrão dizendo "nenhum resultado foi encontrado." Se os usuários acham que deveriam haver resultados para essa fonte, precisam trabalhar com seus administradores para garantir que eles tenham permissões para os dados que estão tentando acessar. O usuário precisa de um papel de segurança Dataverse apropriado atribuído a ele, como o papel de Usuário Básico.
• O sistema não armazena localmente as informações de permissão de conteúdo. Ele realiza todas as verificações de permissão ao vivo com a fonte para garantir que estejam na data mais up-to.

Sincronização e frequência de atualização do arquivo

Um trabalho de sincronização agendada mantém os arquivos conectados do OneDrive e do SharePoint, e os artigos de conhecimento não estruturados atualizados. Esse trabalho é executado automaticamente em segundo plano, atualizando o conteúdo dos arquivos e reindexando as alterações a fim de fornecer resultados precisos para consultas. As atualizações gerenciam não apenas alterações feitas no conteúdo, mas também garantem que qualquer conteúdo excluído da fonte deixe de ser exibido como parte das respostas de qualquer consulta. Atualmente, não há como acionar manualmente uma atualização.

Para mais informações sobre o tempo de frequência de atualização, veja limites da fonte de conhecimento de dados não estruturados do Copilot Studio.

Licenciamento

Todas as solicitações que envolvam conhecimento são cobradas segundo as tarifas de mensagens de respostas generativas do Microsoft Copilot. Para mais informações, veja Taxas de cobrança e gestão.

Se as fontes de conhecimento exigem a ingestão de dados, o armazenamento dos dados e os índices correspondentes para recuperá-los estão sujeitos aos direitos de armazenamento que o cliente possui. Para mais informações sobre a busca em linguagem natural do Dataverse, veja Aprimorar experiências baseadas em IA com a busca do Dataverse.

Limites e limitações

Quando você ativa o suporte a dados não estruturados pela primeira vez, o Dataverse pode levar entre 5 e 30 minutos para configurar e indexar antes de processar os arquivos adicionados. O tempo depende do tamanho do ambiente do Dataverse atual.

Cada agente pode ter, no máximo, 500 objetos de conhecimento. Esses objetos podem ser arquivos, pastas, artigos de conhecimento, sites ou outras fontes.

Atualmente, um agente pode usar apenas cinco fontes diferentes por vez. Por exemplo, SharePoint, Dataverse, OneDrive ou outras fontes.

Para mais informações sobre limites e limitações específicas para as fontes de dados não estruturadas suportadas, veja Copilot Studio limites da fonte de conhecimento de dados não estruturados.

Observação

Os agentes do Copilot Studio exigem a pesquisa do Dataverse para usar essa fonte de conhecimento. Se você não puder adicionar um arquivo habilitado para o Dataverse a um agente, peça ao administrador para ativar a pesquisa do Dataverse no ambiente. Para obter mais informações sobre a pesquisa do Dataverse e como gerenciá-la, consulte O que é a pesquisa do Dataverse e Configurar a pesquisa do Dataverse para o ambiente.

Para acessar o conteúdo do OneDrive e SharePoint armazenado no Dataverse, os usuários devem possuir pelo menos uma licença Basic User para Power Apps ou Dynamics 365. Além disso, as permissões Básicas de Usuário também devem incluir permissões de leitura para as seguintes tabelas e entidades:

• Montagem de Plug-in
• Tipo de plug-in
• Mensagem do Sdk
• Etapa de processamento de mensagens do SDK
• Imagem da Etapa de Processamento de Mensagens do Sdk

Você pode configurar essas permissões no Centro de Administração do Power Platform ou no Centro de Administração do Dynamics.

perguntas frequentes

Na caixa de diálogo Adicionar conhecimento, qual é a diferença entre as duas opções do SharePoint?

No diálogo Adicionar conhecimento , você vê duas opções do SharePoint.

A opção SharePoint na seção de upload de arquivos (1) serve para enviar arquivos ou pastas individuais do SharePoint para seu agente. Essa opção faz upload de uma cópia do arquivo do SharePoint para o Dataverse e mantém uma relação síncrona para manter o arquivo atualizado. Durante consultas, o SharePoint é acessado para validar as permissões dos usuários para o conteúdo. Os arquivos armazenados do Dataverse consomem armazenamento de dados, mas oferecem capacidade de busca semântica completa em documentos e suporte para texto dentro de imagens para certos tipos de documentos, como PDFs.

Use a opção (1) quando quiser sincronização em tempo real, e não arquivos estáticos enviados para o Dataverse. Ele fornece atualizações automáticas quando arquivos fonte são alterados.

A outra opção do SharePoint (2) oferece a integração completa do SharePoint no Copilot Studio usando o conector SharePoint. Use essa opção quando precisar de todas as capacidades do conector SharePoint, configurações personalizadas de autenticação ou opções avançadas de consulta.

O ícone do SharePoint não é exibido na seção Carregar arquivos da caixa de diálogo Adicionar conhecimento?

Há um pequeno atraso entre a instalação de uma solução e a exibição dela em todas as organizações existentes. Para iniciar uma atualização manual, siga estas etapas:

1. Faça login no centro de administração do Power Platform usando credenciais de administrador.

2. Na navegação lateral, selecione Gerenciar.

3. Na lista de produtos, selecione Aplicativos do Dynamics 365. Um painel é aberto.

4. Procure "PowerAIExtensions".

5. Selecione os três pontos (...) para Microsoft Dynamics 365 - PowerAIExtensions e selecione Instalar.

6. No menu suspenso, selecione o ambiente e Instalar.

7. Depois que a instalação for concluída, abra o Power Apps em uma nova janela.

8. No painel esquerdo, selecione Soluções.

9. Selecione Ver Histórico.

10. Procure "PowerAIExtensions_Anchor" e verifique se ele está definido como 1.01.688 ou superior.

O que acontece quando adiciono mais de 500 objetos de conhecimento ao agente?

Você não pode adicionar mais objetos a menos que primeiro exclua os anteriores.

Cada agente tem o próprio índice da fonte de conhecimento?

O Dataverse armazena fontes de conhecimento para uso no ambiente onde você as cria. Se vários agentes usam a mesma pasta do SharePoint, todos os agentes usam uma única instância dessa pasta.

O que acontecerá se eu selecionar uma pasta com mais do que o número máximo de arquivos, pastas e subpastas ao adicionar uma fonte do SharePoint ou OneDrive?

O Copilot Studio recupera e indexa até o número máximo de arquivos, pastas e subpastas, além de indexar esses arquivos. Os demais não são processados. Atualmente, não há mensagem indicando o que foi ou não processado.

Um dos arquivos adicionados por mim (ou que fazia parte de uma pasta que adicionei) é exibido como parte da fonte de conhecimento, mas não consigo obter respostas dele. Por quê?

Esse problema pode estar relacionado a um dos seguintes motivos:

• O arquivo ou pasta é definido como "Pronto" na página Conhecimento.
• Verifique se o nome do arquivo não inclui um caractere não compatível (especificamente para arquivos do SharePoint).
• Certifique-se de que o arquivo não tem uma configuração de confidencialidade Confidencial ou Altamente Confidencial, ou com proteção por senha.
• Verifique se ele é um tipo de arquivo compatível.
• Se o arquivo ou a pasta for do site do OneDrive ou do SharePoint de um usuário diferente, verifique se ele foi compartilhado com o criador.
• Se o arquivo for da base de conhecimento, verifique se sua conta tem permissões para exibir o conteúdo no sistema de origem.