Adicionar fontes de conhecimento ao seu agente declarativo no Microsoft 365 Copilot

O recurso Construtor de Agentes no Microsoft 365 Copilot fornece uma interface simples para você integrar fontes de conhecimento para tornar seu agente declarativo mais inteligente e consciente do contexto. Essas fontes de conhecimento fundamentam seu agente em dados corporativos, conteúdo público e informações específicas do usuário para permitir que ele forneça respostas mais precisas, relevantes e personalizadas.

Você pode adicionar:

• Até quatro URLs de sites públicos.
• Até 100 sites, pastas ou arquivos do SharePoint.
• Até 50 arquivos do OneDrive.
• Até cinco URLs de chat do Teams.
• Arquivos inseridos carregados do seu dispositivo (na guia Configurar ).
• Conectores do Microsoft 365 Copilot (se habilitados pelo administrador da sua organização).

Este artigo descreve as fontes de conhecimento compatíveis e as etapas para configurá-las no Microsoft 365 Copilot. Para obter informações gerais sobre como criar agentes com o Microsoft 365 Copilot, consulte Criar agentes com o Microsoft 365 Copilot.

Para obter informações sobre fontes de conhecimento com suporte e requisitos de licenciamento, consulte Fontes de conhecimento.

Adicionar fontes de conhecimento

Se você usar linguagem natural para criar seu agente, o Agent Builder adicionará fontes de conhecimento para você com base em sua descrição. Você também pode adicionar fontes de conhecimento a partir da caixa de chat:

1. No Microsoft 365 Copilot, escolha Novo agente no painel esquerdo e forneça uma descrição em linguagem natural para o agente.

2. Escolha o ícone de adição (+) na caixa de chat. Use um dos seguintes métodos para adicionar fontes de conhecimento:

   • Adicionar conteúdo de trabalho - Selecione, pesquise ou carregue arquivos.
   • Carregar imagens e arquivos - Faça upload diretamente do seu dispositivo.
   • Anexar arquivos na nuvem - Anexe arquivos na nuvem aos quais você tem acesso.

Se você estiver configurando seu agente manualmente, para adicionar fontes de conhecimento a ele:

1. No Microsoft 365 Copilot, escolha Novo agente no painel esquerdo e escolha Ignorar para configurar.

2. Na seção Conhecimento , use um dos seguintes métodos para adicionar fontes de conhecimento:

   • Pesquisa - Digite palavras-chave para pesquisar itens. Use essa opção para adicionar fontes, como email e mensagens do Teams.
   • Insira a URL - Adicione um site público, um link do SharePoint que inclua o caminho do site (por exemplo, .../sites/<site-name>/...) e não inclua parâmetros de consulta ou um link compartilhado do OneDrive.
   • Procurar - Use o seletor Anexar arquivos de nuvem para procurar e selecionar arquivos, pastas ou listas do SharePoint ou do OneDrive.
   • Upload - Carregue arquivos diretamente do seu dispositivo.

Sites públicos

Adicione sites públicos específicos como fontes de conhecimento do agente para tornar seu agente sensível ao contexto. Quando você faz referência a sites como fontes de conhecimento, os seguintes limites se aplicam:

• As URLs de sites públicos devem ter apenas dois níveis. Por exemplo, https://example.org/a/b/c é uma URL inválida porque tem mais de dois níveis.
• URLs não podem conter parâmetros de consulta. Por exemplo, https://example.org?test=1 é inválido.
• Você pode adicionar até quatro URLs.

Para configurar seu agente para usar todos os dados da web como conhecimento:

• Use linguagem natural para pedir ao Agent Builder para priorizar suas fontes de conhecimento.
• Na guia Configurar , em Conhecimento, escolha o alternância ao lado de Pesquisar todos os sites.

Conteúdo do SharePoint e do OneDrive

Faça referência a arquivos, pastas, listas e sites específicos como fontes de conhecimento do agente. Ao fazer referência a fontes do SharePoint ou do OneDrive, considere os seguintes limites:

Quando você faz referência a uma lista do SharePoint, os seguintes limites se aplicam:

• Uma lista pode ter no máximo 20.000 itens (linhas) e 50 MB de texto bruto. Se sua lista exceder qualquer um dos limites, o agente a truncará e observará o truncamento em sua resposta.
• A coluna Anexos (listar anexos) não é indexada nem usada para fundamento; Os agentes não respondem a partir do conteúdo do anexo.
• Selecionar um site do SharePoint não inclui suas listas. Para usar uma lista como conhecimento, selecione a lista específica.

Insira uma URL para arquivos, pastas, listas ou sites

Insira uma URL para um site, pasta ou arquivo do SharePoint, como contoso.sharepoint.com/sites/policies. O agente pesquisa a URL e os subcaminhos. Por exemplo, uma URL como contoso.sharepoint.com/sites também inclui subcaminhos como contoso.sharepoint.com/sites/policies. O agente usa informações relevantes para fornecer uma resposta direcionada.

Você também pode adicionar uma lista do SharePoint por URL. Na lista, selecione Compartilhar ou Copiar link para obter o link e cole a URL da lista (sem parâmetros de consulta). Use um link direto para a lista específica, não uma exibição filtrada ou agrupada. Uma URL de site do SharePoint não inclui as listas nesse site, portanto, insira a própria URL da lista.

Para o OneDrive, insira um link compartilhável para um arquivo ou pasta (por exemplo, uma URL copiada do navegador ou opções de compartilhamento), não um caminho local ou relativo (por exemplo, C:\Users\YourName\Documents\File.xlsx).

Depois de fornecer a URL, pressione Enter para adicioná-la como uma fonte de conhecimento.

Navegue para selecionar arquivos, pastas, listas ou sites

Selecione o ícone de nuvem Anexar arquivos na nuvem na seção Conhecimento para abrir o seletor de arquivos. O seletor exibe os sites do SharePoint e do OneDrive acessados recentemente. Para exibir mais sites do SharePoint, selecione Mais locais na parte inferior do painel esquerdo. Se você criou um site recentemente, ele aparecerá depois de alguns minutos.

Para procurar uma lista do SharePoint, selecione Listas recentes no painel esquerdo do seletor e, em seguida, selecione a lista que você deseja adicionar.

Preparação de arquivos

Quando você carrega novos arquivos no SharePoint ou no OneDrive, pode levar vários minutos para que o agente os inclua em sua resposta. Você ainda pode testar seu agente no painel de teste se as fontes não estiverem prontas. No entanto, as respostas não incluem informações do arquivo recém-carregado até que ele esteja pronto.

Você pode marcar a preparação do arquivo na seção Conhecimento na guia Configurar; o arquivo tem a palavra "Preparando" ao lado dele. Quando você renomeia ou exclui o arquivo subjacente carregado no SharePoint ou no OneDrive, o agente seleciona as alterações. Você também pode selecionar o botão Atualizar na parte superior da seção Conhecimento para recarregar manualmente o estado.

Páginas do OneNote

Você pode escolher páginas específicas do OneNote no seletor de arquivos para carregar como conhecimento. Você só pode selecionar páginas individuais do OneNote; a opção de selecionar um bloco de anotações inteiro do OneNote não está disponível. Quando você seleciona Meus arquivos, pastas e sites do SharePoint, as páginas do OneNote são incluídas.

Use o seletor de arquivos para adicionar páginas do OneNote. O Agent Builder não oferece suporte à inserção de URLs de página do OneNote.

Dados do Microsoft Teams

Você pode fundamentar seu agente em dados do Microsoft Teams, incluindo mensagens de chat do Teams e informações de reuniões. Para usar todas as mensagens de chat, transcrições de reuniões e calendários aos quais você tem acesso como conhecimento, selecione Chats e reuniões do My Teams.

Você também pode definir como escopo de seus agentes chats específicos, incluindo canais de equipe, chats em grupo e chats de reuniões. O conhecimento do escopo para chats específicos melhora a precisão e a relevância das respostas dos agentes. Para abranger o conhecimento do Teams para chats específicos, na guia Configurar , na seção Conhecimento , selecione a barra de pesquisa. Na janela que é aberta, escolha a guia Chats e selecione os chats específicos para adicionar. Você pode adicionar até cinco chats.

Você também pode definir o escopo de seus agentes para reuniões específicas. O conhecimento do escopo de reuniões específicas melhora a precisão e a relevância das respostas dos agentes. Para abranger o conhecimento do Teams para reuniões específicas, na guia Configurar , na seção Conhecimento , selecione a barra de pesquisa. Na janela que é aberta, escolha a guia Reuniões e selecione as reuniões específicas a serem adicionadas.

Emails do Outlook

Você pode fundamentar seu agente no email do Outlook. Para adicionar email como uma fonte de conhecimento, na guia Configurar , na seção Conhecimento , selecione a barra de pesquisa e escolha Meus emails.

Conteúdo de arquivo inserido

Você pode carregar arquivos diretamente do seu dispositivo para que seu agente use como conhecimento. Os arquivos que você carrega tornam-se conteúdo inserido no agente. Para carregar arquivos, arraste e solte do seu dispositivo para a guia Descrever ou Configurar . Você também pode escolher o ícone de seta na guia Configurar para fazer upload de arquivos do seu dispositivo. Você pode carregar arquivos individuais do seu dispositivo, mas não pastas de arquivos.

Você pode adicionar até 20 arquivos como fontes de conhecimento.

Os arquivos inseridos são armazenados na região geográfica padrão do locatário, não no PDL (local de dados) preferencial do usuário.

A guia Configurar exibe os arquivos inseridos em Arquivos carregados. Files pode levar alguns minutos para carregar e aparecer cinza até que sejam totalmente carregados. O tempo de upload pode variar de acordo com o tamanho do arquivo e a velocidade da Internet. Para obter informações sobre limites de tamanho para arquivos inseridos, consulte Limites de tamanho de arquivo.

Para remover um arquivo carregado, escolha o X ao lado do arquivo e escolha Remover.

Files com qualquer uma das seguintes características não têm suporte:

• Criptografia de chave dupla.
• Rótulos de confidencialidade com permissões definidas pelo usuário. Se você carregar um arquivo com permissões definidas pelo usuário, a criação do agente falhará.
• Rótulos de confidencialidade com a permissão de direitos de extração desabilitada. Se você carregar esses arquivos, a criação do agente falhará. Se um usuário agente não tiver direitos de extração para um arquivo incorporado, o usuário não poderá acessar o agente.
• Files de outro locatário que têm a criptografia habilitada.
• Proteção por senha.

Para obter detalhes, consulte Cenários de rótulo de confidencialidade sem suporte.

Para obter informações sobre indexação e recuperação de conteúdo de arquivo inserido, consulte Otimizar recuperação de conteúdo.

Rótulos de confidencialidade para conteúdo incorporado do agente

Aplique um rótulo de confidencialidade ao conteúdo inserido do agente se você carregar algum arquivo com um rótulo de confidencialidade ou se o locatário tiver uma política de rotulagem de confidencialidade padrão. Ao aplicar um rótulo de confidencialidade ao conteúdo inserido do agente, você garante que o agente esteja em conformidade com as políticas do Microsoft Purview da sua organização.

O rótulo de confidencialidade aplicado ao conteúdo inserido é a prioridade mais alta dos seguintes rótulos:

• O rótulo de confidencialidade de prioridade mais alta aplicado a qualquer arquivo inserido.
• A política de rótulo de confidencialidade padrão aplicada pela organização.

Por exemplo, se você incorporar um arquivo com um rótulo Geral e um arquivo com um rótulo Confidencial no agente, o rótulo de confidencialidade Confidencial será aplicado ao conteúdo inserido.

Somente os usuários que têm permissões de direitos de extração para o rótulo de confidencialidade aplicado ao conteúdo inserido podem acessar e usar o agente. O rótulo não aparece na listagem da Agent Store. Os usuários que não têm permissões de extração direita para o conteúdo inserido podem visualizar o agente e a descrição do agente, mas não podem instalar e usar o agente.

Um rótulo de confidencialidade também é aplicado às respostas do agente. Este rótulo é a prioridade mais alta dos seguintes rótulos:

• O rótulo de confidencialidade do conteúdo inserido
• O rótulo de confidencialidade de qualquer outra fonte de conhecimento do agente, como arquivos do SharePoint e do OneDrive.

Atualmente, não é possível definir um rótulo de confidencialidade em um agente.

Cenários de rótulo de confidencialidade sem suporte

A tabela a seguir lista cenários de rótulo de confidencialidade que não têm suporte no momento, descreve o comportamento quando um construtor carrega o arquivo para o agente e fornece a ação recomendada para o construtor.

Compartilhando um agente com arquivos incorporados

Ao compartilhar um agente com arquivos incorporados, você compartilha os arquivos com os usuários quando eles adquirem o agente. Depois que os usuários adquirirem o agente, eles poderão obter respostas do Copilot com base nessas fontes de conhecimento. Você tem as seguintes opções para compartilhar um agente com arquivos inseridos como conhecimento:

• Qualquer pessoa na sua organização
• Usuários específicos em sua organização
• Somente você

Quando você compartilha o agente, a tela Compartilhar exibe o rótulo de confidencialidade se os rótulos de confidencialidade forem definidos no conteúdo incorporado.

Tipos de arquivo e limites de tamanho

A tabela a seguir lista os tipos de arquivo que você pode adicionar como conhecimento ao seu agente e os limites de tamanho de arquivo inseridos para cada tipo de arquivo.

* Suporte apenas para o SharePoint no Microsoft 365.

Dados de People

Se você basear seu agente nos dados do People, ele poderá fornecer respostas mais personalizadas e com reconhecimento de contexto. People data fornece informações públicas sobre indivíduos, como nome, cargo, habilidades e relacionamentos organizacionais. Essas informações permitem que os agentes pesquisem perfis de usuários e colegas, incluindo estrutura de relatórios e detalhes de contato.

O People data é habilitado por padrão para agentes criados por usuários que possuem uma licença do Microsoft 365 Copilot. Você pode desativar ou reativar esse recurso na interface do usuário de configuração do agente. Para desabilitar ou habilitar dados do People:

• Na guia Configurar no Agent Builder no Microsoft 365 Copilot, selecione a alternância ao lado de Referenciar pessoas na organização para ativar ou desativar os dados de People.

Esse recurso está disponível apenas para usuários com uma licença de complemento do Microsoft 365 Copilot.

Conectores do Copilot

Os conectores do Copilot permitem que os agentes acessem e apliquem conhecimento de sistemas externos, como contas de clientes, tíquetes de incidentes, repositórios de código e artigos de conhecimento. Use conectores do Copilot para integrar dados corporativos aos seus agentes e capacitá-los com conhecimento específico do domínio.

Para obter mais informações sobre conectores do Copilot, consulte Visão geral dos conectores do Microsoft 365 Copilot.

Escopo: Fontes de dados do conector do Copilot

Para aumentar a precisão e a relevância das respostas dos agentes, baseie os agentes não apenas em dados organizacionais amplos, mas também em dados de escopo específicos. Para definir o escopo dos dados do conector em seu agente para um atributo específico:

1. Na guia Configurar , em Escolher outras fontes de dados, selecione o conector para sua fonte de dados.

2. No card desse conector, adicione as conexões relevantes para seu cenário.

3. Selecione a seta para voltar para a seção Conhecimento .

4. Expanda o conector que você adicionou e selecione o atributo para o qual deseja definir o escopo do conhecimento (por exemplo, projeto, espaço, pasta) e pesquise ou digite o nome do atributo.

   Observação

   Se o atributo não aparecer nos resultados da pesquisa, pode ser porque:

   • O administrador não configurou o conteúdo com escopo.
   • Você não tem as permissões necessárias para acessar o conteúdo.
   • O escopo não é válido para o conector selecionado.

5. Selecione o atributo na lista para adicioná-lo.

6. O conhecimento do seu agente agora tem como escopo os dados associados ao atributo com escopo.

Por exemplo, ao usar o conector de Itens de Trabalho do DevOps do Azure, você pode definir o escopo do agente para um caminho de área específico para garantir que o agente se concentre apenas nos itens de trabalho mais pertinentes.

Para definir o escopo do caminho da área de Itens de Trabalho do DevOps do Azure:

1. Em Escolher outras fontes de dados, selecione Itens de Trabalho do Azure DevOps.
2. Selecione Adicionar ao lado das conexões relevantes para suas tarefas.
3. Selecione a seta para retornar à seção Conhecimento .
4. Selecione Selecionar um caminho de área e pesquise ou digite o nome do caminho de área.
5. Selecione o caminho de área para adicioná-lo.

A tabela a seguir lista os conectores do Copilot que dão suporte ao escopo e os atributos que você pode usar para definir o escopo dos dados.

Para obter mais informações sobre os conectores Copilot disponíveis, consulte a Galeria Conectores.

Priorize suas fontes de conhecimento em relação ao conhecimento geral

Você pode configurar seu agente para priorizar as fontes de conhecimento que você fornece, como conteúdo do SharePoint ou arquivos incorporados, quando ele responde a consultas que exigem pesquisas baseadas em conhecimento. As pesquisas baseadas em conhecimento são solicitações do usuário para procurar informações específicas; Por exemplo:

• Quem é o atual CEO da empresa?
• Quando é a próxima conferência de negócios?
• Qual é a atualização mais recente relacionada a um recurso?

Algumas solicitações de usuário não exigem pesquisas baseadas em conhecimento; o agente pode responder com base no conhecimento geral de IA. Por exemplo:

• Traduza esta frase para o espanhol: "Olá, tudo bem?"
• O que é 1+1?

Quando você habilita esse recurso, o agente responde a perguntas simples que não exigem pesquisa usando seu conhecimento geral e usa suas fontes de conhecimento apenas para responder a perguntas baseadas em pesquisa. Se o agente não conseguir encontrar informações relevantes nas fontes de conhecimento fornecidas, ele responderá com uma mensagem de fallback informando que não consegue encontrar as informações. Para restringir seu agente às suas próprias fontes de conhecimento, use a configuração Usar somente fontes especificadas para que o agente priorize as fontes que você designar. Essa configuração prioriza, em vez de bloquear totalmente, o conhecimento geral de IA — o Agent Builder não pode bloqueá-lo totalmente — portanto, para um controle mais estrito, consulte a observação a seguir.

Para configurar seu agente para priorizar suas fontes de conhecimento, na guia Configurar , selecione o botão ao lado de Usar apenas fontes especificadas.

Conteúdo relacionado

• Visão geral do Microsoft 365 Copilot.
• Crie agentes com o Microsoft 365 Copilot
• Criar um agente a partir de um modelo
• Compartilhar e gerenciar agentes