Adicionar origens de conhecimento ao agente declarativo no Microsoft 365 Copilot

A funcionalidade Agent Builder no Microsoft 365 Copilot fornece uma interface simples para integrar origens de conhecimento para tornar o seu agente declarativo mais inteligente e consciente do contexto. Estas origens de conhecimento baseiam o seu agente em dados empresariais, conteúdos públicos e informações específicas do utilizador para lhes permitir fornecer respostas mais precisas, relevantes e personalizadas.

Este artigo descreve as origens de conhecimento suportadas e os passos para configurá-las no Microsoft 365 Copilot. Para obter informações gerais sobre a criação de agentes com Microsoft 365 Copilot, veja Build agents with Microsoft 365 Copilot (Criar agentes com Microsoft 365 Copilot).

Para obter mais informações sobre as origens de conhecimento e os requisitos de licenciamento suportados, veja Origens de conhecimento.

Adicionar origens de conhecimento

Para adicionar origens de conhecimento ao seu agente:

1. No Microsoft 365 Copilot, selecione Criar agente e aceda ao separador Configurar.

2. Na secção Conhecimento , utilize um dos seguintes métodos para adicionar origens de conhecimento:

   • Barra de pesquisa – clique na barra de pesquisa e navegue para selecionar ficheiros, sites, conversas ou reuniões.
   • Introduza URL – adicione um site público ou uma ligação do SharePoint (tem de ter dois níveis de profundidade e sem parâmetros de consulta) na caixa de pesquisa.
   • Carregar ficheiro – selecione o ícone de seta para selecionar ficheiros a partir do seu dispositivo ou do ícone de nuvem para adicionar ficheiros a partir de sites do SharePoint.

3. Selecione os itens a incluir. Pode adicionar:

   • Até quatro URLs de web sites públicos.
   • Ficheiros, pastas ou sites do SharePoint.
   • Até cinco URLs de chat do Teams.
   • Ficheiros incorporados carregados a partir do seu dispositivo.
   • Microsoft 365 Copilot conectores (se ativado pelo administrador da sua organização).

Sites públicos

Pode adicionar sites públicos específicos como origens de conhecimento do agente para tornar o seu agente consciente do contexto. Quando referencia sites como origens de conhecimento, aplicam-se os seguintes limites:

• Os URLs de web sites públicos só têm de ter dois níveis; por exemplo, https://example.org/a/b/c é um URL inválido porque tem mais de dois níveis.
• Os URLs não podem conter parâmetros de consulta; por exemplo, https://example.org?test=1 é inválido.
• Pode adicionar até quatro URLs.

Para configurar o agente para utilizar quaisquer dados Web como conhecimento, no separador Configurar , em Conhecimento, selecione o botão de alternar junto a Procurar em todos os sites.

Conteúdo do SharePoint

Pode referenciar sites, ficheiros e pastas específicos do SharePoint como origens de conhecimento do agente. Quando referencia origens do SharePoint, considere os seguintes limites:

• Pode ser selecionado um total de 100 ficheiros do SharePoint para cada agente.
• Os ficheiros já carregados para o SharePoint podem ter permissões e etiquetas de confidencialidade existentes, que são respeitadas quando o agente está a gerar uma resposta.
• Embora não exista um limite de tamanho de ficheiro direto nos ficheiros de conhecimento que selecionar, o agente só pode identificar tipos de ficheiro específicos.

Introduzir um URL para um site, pasta ou ficheiro do SharePoint

Pode introduzir um URL para um site, pasta ou ficheiro do SharePoint, como contoso.sharepoint.com/sites/policies. O agente pesquisa a URL e os subcaminhos. Por exemplo, um 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.

Depois de fornecer o URL do SharePoint, prima Enter para adicioná-lo como uma origem de conhecimento.

Seletor de ficheiros do SharePoint

Também pode selecionar ficheiros ou pastas a partir do seletor de ficheiros do SharePoint ao selecionar o ícone de nuvem na secção Conhecimento . O painel esquerdo do seletor apresenta os sites do SharePoint acedidos recentemente. Para visualizar mais sites do SharePoint, selecione Mais lugares. Se criou recentemente um site, este será apresentado após vários minutos.

Depois de selecionar um site, você poderá selecionar vários arquivos e pastas. Ao fazê-lo, adiciona o ficheiro ou pasta do SharePoint às origens de conhecimento do agente. Quando o mesmo site inclui várias pastas, selecione o botão ao lado do nome da pasta para visualizar outras pastas.

Preparação de ficheiros

Quando novos arquivos são carregados no SharePoint, eles podem levar vários minutos para ficarem prontos para o agente incluir 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 verificar a preparação do arquivo examinando a seção Conhecimento na guia Configurar; o arquivo tem a palavra "Preparando" ao lado dele. Quando o nome do ficheiro subjacente carregado para o SharePoint é alterado ou eliminado, o agente recolhe as alterações. Também pode selecionar o botão recarregar na parte superior da secção Conhecimento para recarregar manualmente o estado.

Dados do Microsoft Teams

Pode colocar o seu agente nos dados do Microsoft Teams, incluindo mensagens de chat do Teams e informações da reunião. Para utilizar todas as mensagens de chat, transcrições de reuniões e calendários aos quais tem acesso como conhecimento, selecione As minhas conversas e reuniões do Teams.

Também pode definir o âmbito dos seus agentes para conversas específicas, incluindo canais de equipa, conversas de grupo e conversas de reunião. O âmbito de conhecimentos para conversas específicas melhora a precisão e a relevância das respostas dos agentes. Para definir o âmbito do conhecimento do Teams para conversas específicas, no separador Configurar , na secção Conhecimento , selecione a barra de pesquisa. Na janela que é aberta, selecione o separador Chats e selecione as conversas específicas a adicionar. Pode adicionar até cinco conversas.

E-mails do Outlook

Pode colocar o seu agente no e-mail do Outlook. Para adicionar e-mails como uma origem de dados de conhecimento, no separador Configurar , na secção Conhecimento , selecione a barra de pesquisa e selecione Os meus e-mails.

Conteúdo do ficheiro incorporado

Pode carregar ficheiros diretamente a partir do seu dispositivo para que o agente utilize como conhecimento. Os ficheiros que carregar tornam-se conteúdos incorporados no agente. Para carregar ficheiros, pode arrastar e largar do seu dispositivo para o separador Descrever ou o separador Configurar . Também pode escolher o ícone de seta no separador Configurar para carregar ficheiros a partir do seu dispositivo. Pode carregar ficheiros individuais a partir do seu dispositivo, mas não pastas de ficheiros.

Pode adicionar até 20 ficheiros como origens de conhecimento.

Os ficheiros incorporados são apresentados no separador Configurar em Ficheiros carregados. Os ficheiros podem demorar alguns minutos a carregar e a aparecer a cinzento até serem totalmente carregados. O tempo de carregamento pode variar com base no tamanho do ficheiro e na velocidade da Internet. Para obter informações sobre os limites de tamanho dos ficheiros incorporados, veja Limites de tamanho de ficheiros.

Para remover um ficheiro que carregou, selecione o X junto ao ficheiro e selecione Remover.

Os ficheiros com qualquer uma das seguintes características não são suportados:

• Encriptação de chave dupla.
• Etiquetas de confidencialidade que têm permissões definidas pelo utilizador. Se carregar um ficheiro com permissões definidas pelo utilizador, a criação do agente falha.
• Etiquetas de confidencialidade que têm a permissão de extração de direitos desativada. Se carregar estes ficheiros, a criação do agente falha. Se um utilizador do agente não tiver direitos de extração para um ficheiro incorporado, o utilizador não poderá aceder ao agente.
• Ficheiros de outro inquilino com encriptação ativada.
• Proteção por palavra-passe.

Para obter detalhes, veja Cenários de etiquetas de confidencialidade não suportados.

Para obter informações sobre a indexação e obtenção de conteúdos de ficheiros incorporados, veja Otimizar a obtenção de conteúdo.

Etiquetas de confidencialidade para conteúdo incorporado do agente

É aplicada uma etiqueta de confidencialidade ao conteúdo incorporado do agente se algum dos ficheiros carregados tiver uma etiqueta de confidencialidade nos mesmos ou se o inquilino tiver uma política de etiquetagem de confidencialidade predefinida. A etiqueta de confidencialidade aplicada ao conteúdo incorporado do agente garante que o agente está em conformidade com as políticas do Microsoft Purview da organização.

A etiqueta de confidencialidade aplicada ao conteúdo incorporado é a prioridade mais alta das seguintes etiquetas:

• A etiqueta de confidencialidade de prioridade mais alta aplicada a qualquer ficheiro incorporado.
• A política de etiqueta de confidencialidade predefinida aplicada pela organização.

Por exemplo, se um ficheiro com uma etiqueta Geral e um ficheiro com uma etiqueta Confidencial forem incorporados no agente, a etiqueta confidencialidade é aplicada ao conteúdo incorporado.

Apenas os utilizadores que tenham permissões de extração corretas para a etiqueta de confidencialidade aplicada ao conteúdo incorporado podem aceder e utilizar o agente. A etiqueta não aparece na listagem do Arquivo de Agentes. Os utilizadores que não tenham permissões de extração corretas para o conteúdo incorporado podem ver o agente e a descrição do agente, mas não podem instalar e utilizar o agente.

Também é aplicada uma etiqueta de confidencialidade às respostas do agente. Esta etiqueta é a prioridade mais alta das seguintes etiquetas:

• A etiqueta de confidencialidade do conteúdo incorporado
• A etiqueta de confidencialidade de quaisquer outras origens de conhecimento do agente, como ficheiros do SharePoint e do OneDrive.

Atualmente, não pode definir uma etiqueta de confidencialidade num agente.

Cenários de etiquetas de confidencialidade não suportados

A tabela seguinte lista cenários de etiqueta de confidencialidade que não são atualmente suportados, descreve o comportamento quando um construtor carrega o ficheiro para o agente e fornece a ação recomendada para o construtor.

Partilhar um agente com ficheiros incorporados

Quando partilha um agente com ficheiros incorporados, os ficheiros só são partilhados com os utilizadores quando adquirem o agente. Depois de adquirirem o agente, os utilizadores podem obter respostas da Copilot com base nessas origens de conhecimento. Tem as seguintes opções para partilhar um agente com ficheiros incorporados como conhecimento:

• Qualquer pessoa na sua organização
• Utilizadores específicos na sua organização
• Só tu

Quando partilha o agente, se as etiquetas de confidencialidade estiverem definidas no conteúdo incorporado, a etiqueta de confidencialidade é apresentada no ecrã Partilhar .

Tipos de ficheiro e limites de tamanho

A tabela seguinte lista os tipos de ficheiro que pode adicionar como conhecimento ao agente e os limites de tamanho de ficheiro incorporados para cada tipo de ficheiro.

* Apenas suportado para o SharePoint Online.

Pessoas dados

Pode colocar o seu agente no Pessoas dados para fornecer respostas mais personalizadas e com deteção de contexto. Pessoas dados fornecem informações públicas sobre indivíduos, tais como nome, posição, competências e relações organizacionais. Isto permite que os agentes procurem perfis de utilizador e de colegas, incluindo a estrutura de relatórios e os detalhes de contacto.

Pessoas dados estão ativados por predefinição para agentes criados por utilizadores com uma licença de Microsoft 365 Copilot. Pode desativar ou reativar esta capacidade na IU de configuração do agente. Para desativar ou ativar Pessoas dados:

• No separador Configurar no Agent Builder no Microsoft 365 Copilot, selecione o botão de alternar junto a Referenciar pessoas na organização para desativar ou ativar Pessoas dados.

Esta funcionalidade só está disponível para utilizadores com uma licença de suplemento Microsoft 365 Copilot.

Conectores do Copilot

Os conectores copilot permitem que os agentes acedam e apliquem conhecimentos de sistemas externos, como contas de clientes, pedidos de incidentes, repositórios de código e artigos de conhecimento. Pode utilizar conectores Copilot para integrar dados empresariais nos seus agentes, capacitando-os com conhecimentos específicos do domínio.

Para obter mais informações sobre os conectores Copilot, veja Descrição geral dos conectores Microsoft 365 Copilot.

Origens de dados do conector Scope Copilot

Para melhorar a precisão e a relevância das respostas do agente, os agentes podem ser baseados não só em dados organizacionais abrangentes, mas também em dados de âmbito específicos. Para definir o âmbito dos dados do conector no agente para um atributo específico:

1. No separador Configurar , em Escolher outras origens de dados, selecione o conector para a sua origem de dados.

2. No card desse conector, adicione as ligações que são relevantes para o seu cenário.

3. Selecione a seta para voltar à secção Conhecimento .

4. Expanda o conector que adicionou e selecione o atributo ao qual pretende definir o âmbito do conhecimento (por exemplo, projeto, espaço, pasta) e procure ou escreva o nome do atributo.

   Observação

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

   • O administrador não configurou o conteúdo no âmbito.
   • Não tem as permissões necessárias para aceder ao conteúdo.
   • O âmbito não é válido para o conector selecionado.

5. Selecione o atributo na lista para o adicionar.

6. Os conhecimentos do agente estão agora no âmbito dos dados associados ao atributo no âmbito.

Por exemplo, quando utiliza o conector Itens de Trabalho do Azure DevOps, pode definir o âmbito do agente para um caminho de área específico para garantir que o agente se concentra apenas nos itens de trabalho mais pertinentes.

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

1. Em Escolher outras origens de dados, selecione Azure Itens de Trabalho do DevOps.
2. Selecione o botão Adicionar junto às ligações que são relevantes para as suas tarefas.
3. Selecione a seta para regressar à secção Conhecimento .
4. Selecione Selecionar um caminho de área e procure ou escreva o nome do caminho da área.
5. Selecione o caminho da área para adicioná-lo.

A tabela seguinte lista os conectores Copilot que suportam o âmbito e os atributos que pode utilizar para definir o âmbito dos dados.

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

Priorizar as suas origens de conhecimento em vez de conhecimentos gerais

Pode configurar o seu agente para atribuir prioridades às origens de conhecimento que fornece, como conteúdos do SharePoint ou ficheiros incorporados, quando responde a consultas que requerem pesquisas baseadas em conhecimento. As pesquisas baseadas em conhecimento são pedidos de utilizador para procurar informações específicas; Por exemplo:

• Quem é o actual CEO da empresa?
• Quando é a próxima conferência de negócios?
• Qual é a atualização mais recente relacionada com uma funcionalidade?

Alguns pedidos de utilizador não requerem pesquisas baseadas em conhecimentos; o agente pode responder com base em conhecimentos gerais de IA. Por exemplo:

• Traduza esta frase para espanhol: "Olá, como está?"
• O que é 1+1?

Quando ativa esta funcionalidade, o agente responde a perguntas simples que não necessitam de pesquisa com base nos seus conhecimentos gerais, mas utiliza as suas origens de conhecimento apenas para responder a perguntas baseadas em pesquisa. Se o agente não conseguir encontrar informações relevantes nas origens de conhecimento fornecidas, este responde com uma mensagem de contingência que indica que não consegue encontrar as informações.

Para configurar o agente para atribuir prioridades às origens de conhecimento, no separador Configurar, selecione o botão de alternar junto a Utilizar apenas origens especificadas.

Conteúdo relacionado

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