Gerencie fontes de conhecimento em um agente (GitHub Copilot)

Depois de adicionar fontes de conhecimento ao seu agente, você pode visualizá-las, atualizá-las e removê-las da aba Conhecimento . A manutenção regular garante que seu agente tenha acesso a conteúdos atuais e relevantes.

Veja as fontes de conhecimento do seu agente

  1. Abra seu agente no Copilot Studio.

  2. Na aba Compilar, localize a seção Conhecimento no painel direito.

  3. Fontes de conhecimento aparecem como chips mostrando o nome da fonte. Não existe uma visualização de tabela com colunas de tipo e status.

  4. Quando o status de indexação está disponível para o seu ambiente, um chip pode mostrar um selo de indexação como Indexação, Pronto, Parcialmente indexado, Indexação incompleta ou Indexação falhada. Passe o mouse sobre o crachá para mais detalhes. Uma fonte que a política da sua organização bloqueia mostra um indicador de bloqueio.

Atualizar uma fonte de conhecimento

  1. Na aba Build , na seção Conhecimento , selecione a fonte de conhecimento que você deseja atualizar.

  2. No diálogo de detalhes, revise e modifique a configuração (URL, site, arquivo ou configurações de conexão).

  3. Selecione Salvar para aplicar as alterações.

Note

Alterações no conteúdo subjacente (por exemplo, atualizar um documento no SharePoint) são refletidas automaticamente. Você só precisa atualizar a configuração da fonte de conhecimento se a localização ou as configurações de conexão mudarem.

Remover uma fonte de conhecimento

  1. Na aba Build , na seção Conhecimento , localize a fonte do conhecimento.

  2. Selecione o botão × no chip da fonte de conhecimento. A origem é removida imediatamente, sem mensagem de confirmação. Na lista expandida, use o botão Excluir na linha.

Note

Remover uma fonte de conhecimento do seu agente não exclui o conteúdo original. Isso só remove o acesso do agente a essa fonte.

Ativar ou desativar a pesquisa na web

Note

Essa opção está disponível para agentes alimentados pelo harness do GitHub Copilot.

Agentes alimentados pelo harness GitHub Copilot incluem uma opção para ativar ou desativar a busca na web como fonte de conhecimento:

  1. Na aba Build , na seção Conhecimento do painel direito.

  2. No diálogo Adicionar conhecimento , selecione Sites públicos.

  3. Ative a opção de Buscar em todos os sites e depois termine o assistente para aplicar a mudança. Para desligá-lo depois, desative o botão de alternância ou selecione × no chip Pesquisar todos os sites na seção Conhecimento .

    • Quando a pesquisa na web está ativada, seu agente pode complementar suas respostas com informações da web.
    • Enquanto a busca na web estiver ativada, você não pode adicionar um site público específico ou uma configuração de Busca Personalizada do Bing. Os sites que você já adicionou são mantidos, mas não são usados até você desligar a busca na web.
    • Se seu administrador desativou a busca na web, o botão de alternância fica desativado e a configuração não é aplicada.
    • Quando a busca na web está desativada, seu corretor usa apenas sites configurados explicitamente.

Correspondência de títulos para fontes do SharePoint

Para fontes de conhecimento do SharePoint e OneDrive, Título está disponível como uma propriedade no construtor Filtrar esta fonte de conhecimento. Ele suporta os operadores é igual a e não é igual a e recebe valores de texto. A propriedade aparece apenas quando o filtro de atributos de título do SharePoint está ativado para o seu ambiente.

Filtrar fontes de conhecimento do SharePoint e OneDrive

Um filtro limita qual conteúdo de uma fonte de conhecimento do SharePoint ou do OneDrive que seu agente pode usar. Quando você abre uma fonte de conhecimento do SharePoint ou OneDrive, o painel de detalhes tem duas abas: Detalhes e Configurações Avançadas. A aba Configurações Avançadas mostra Filtrar essa fonte de conhecimento, onde o filtro aparece como um conjunto de linhas de filtro. Nos bastidores, o filtro é armazenado como uma expressão da linguagem de consulta de palavras-chave do SharePoint (KQL).

Note

Por padrão, os controles de filtro na aba de configurações avançadas são somente leitura. Você pode revisar um filtro que já foi aplicado à origem, mas não pode adicionar, alterar ou remover declarações dessa aba, e as alterações no filtro não são salvas. A aba só pode ser editada quando o recurso de persistência adicional de termos de busca do SharePoint for ativado para o seu ambiente.

Como construir um filtro

Cada linha de instrução tem três partes: uma propriedade, um operador e um valor.

Property Operadores Valor
Autor, Criado por, Modificado por, Nome do Arquivo contém, não contém, é igual a, não é igual a Texto
Cargo é igual a, não é igual a Texto
Criado, Modificado em antes, depois, até, a partir de Data
Tipo de arquivo é igual a, não é igual a Um dos TXT, DOCX, PDF, XLSX ou ASPX
Tamanho do arquivo é igual a, não é igual, é menor que, é maior que, é menor ou igual a, é maior que ou igual a Número, com uma unidade de Bytes, KB, MB ou GB

Um filtro pode ter até 10 linhas de declaração. Valores de filtro são texto literal; você não pode usar variáveis neles.

Como as linhas se combinam

A frase acima das linhas controla como o filtro funciona:

  • Incluir apenas informações mantém apenas o conteúdo que corresponde às condições. Excluir informações remove o conteúdo que corresponde às condições.
  • Tudo exige que o conteúdo corresponda a cada afirmação. qualquer exige que o conteúdo corresponda a pelo menos uma afirmação.

O filtro inteiro usa todos ou qualquer. Você não pode misturar os dois em um filtro. Você não pode mostrar um filtro que misture ambos nas linhas. Se uma origem tiver um filtro existente que as linhas não podem representar, um aviso aparece na aba.

Práticas Recomendadas

  • Revise periodicamente as fontes de conhecimento para remover conteúdos desatualizados ou irrelevantes.
  • Use nomes descritivos para identificar fontes rapidamente.
  • Teste seu agente após remover as fontes para garantir que ele ainda responda corretamente às perguntas-chave.