Adicione tabelas Dataverse ao seu agente como fonte de conhecimento

Ao integrar tabelas do Dataverse como fonte de conhecimento, você baseia seu agente nos dados contidos nessas tabelas. Saiba mais em Melhorar as respostas do agente do Microsoft Dataverse.

Note

Para usar esta fonte de conhecimento, os agentes do Copilot Studio devem usar a pesquisa do Dataverse. Se você não puder adicionar uma tabela do Dataverse a um agente, peça ao administrador para ativar a pesquisa do Dataverse em seu ambiente. Saiba mais em O que é pesquisa do Dataverse e configurar a pesquisa do Dataverse para seu ambiente.
As tabelas do Dataverse como fontes de conhecimento exigem que você defina a autenticação do agente como Authenticate com Microsoft. As outras duas opções, Sem autenticação e Autenticação manual , não são suportadas no momento.
Para adicionar tabelas do Dataverse como fonte de conhecimento, você deve ter as permissões apropriadas para acessar os dados subjacentes. Permissões ausentes ou insuficientes podem impedir que as tabelas sejam visíveis ou selecionáveis durante a configuração. Saiba mais em Atribuir uma função de segurança a um usuário.

Para adicionar tabelas do Dataverse como uma fonte de conhecimento, realize as seguintes etapas:

Abra seu agente do Copilot Studio.
Selecione a guia Compilar.
No painel de componentes, selecione o botão Conhecimento .
Selecione Adicionar conhecimento e depois selecione Dataverse.
Localize uma ou mais de suas tabelas do Dataverse para adicionar. Você pode adicionar até 15 tabelas do Dataverse por fonte de conhecimento. Para restringir suas opções, use o campo de busca.

Note

As recomendações de tabela são baseadas no nome do seu agente.
Revise o nome e a descrição do conhecimento. Forneça uma descrição detalhada, pois a descrição auxilia a orquestração do agente e ajuda o agente a entender o contexto da fonte de conhecimento.
Selecione Adicionar ao agente para concluir a adição da fonte de conhecimento.

Tip

Teste seu agente com perguntas que seus usuários fariam e inclua perguntas que exijam filtragem, como "quais casos abertos esta semana ainda não foram resolvidos?", em vez de uma única consulta. Se as respostas saírem fracas, a correção geralmente é uma descrição melhor do conhecimento, não uma tabela diferente.

Prepare tabelas Dataverse com o Data Workspace

Quando você adiciona tabelas Dataverse como conhecimento, a etapa de Selecionar tabelas pode incluir um link para o Power Apps Data Workspace. Selecione o link se precisar criar, atualizar ou organizar dados antes de escolher as tabelas para o agente. O Data Workspace abre em uma nova aba, e você pode voltar ao assistente de Adicionar Conhecimento quando estiver pronto para selecionar tabelas.

O link aparece apenas quando seu ambiente possui a solução necessária de preparação de dados e o Data Workspace está ativado. Se o link não aparecer, continue com as tabelas disponíveis ou pergunte ao seu administrador se o Data Workspace está disponível no seu ambiente.

A disponibilidade de recursos de pré-visualização pode variar conforme o inquilino ou grupo de lançamento.

Pesquisar texto multilinha e colunas de arquivo

Ao adicionar o Dataverse como uma fonte de dados de conhecimento, você pode aplicar o raciocínio não estruturado para obter respostas de maior qualidade de colunas de Texto Multilinha (MemoType) e Arquivo (FileType). Por padrão, a recuperação funciona sobre as colunas estruturadas de uma tabela. A versão prévia estende isso para conteúdo não estruturado armazenado nas colunas Texto de várias linhas (MemoType) e Arquivo (FileType), de modo que notas, descrições e documentos anexados possam ser usados para responder perguntas.

Antes de executar uma pesquisa nos dados do Dataverse, verifique se você atende aos seguintes requisitos:

A funcionalidade de pesquisa do Dataverse está ativada.
Você tem acesso de criador ou administrador (necessário para modificar exibições em Power Apps).

Saiba mais em Configurar a pesquisa do Dataverse para o ambiente.

Importante

A criação de um índice de pesquisa gera custos extras de capacidade do Dataverse. Saiba mais em Quanto custará a pesquisa do Dataverse?.

Configurar a tabela do Dataverse no Power Apps

Na Visualização de Busca Rápida, inclua explicitamente a tabela e as colunas de Texto Multilinha e Arquivo como Pesquisáveis. Saiba mais em Configurar a pesquisa do Dataverse para o ambiente.

Entre no Power Apps e selecione o ambiente desejado.
Selecione o Dataverse e, em seguida, Tabelas.
Selecione a tabela do Dataverse que você adicionou ao agente do Copilot Studio.
Ative Pesquisável para cada coluna em que você deseja pesquisar.
No painel Experiências com dados, selecione Exibições.
Da lista de exibições, selecione o tipo de Exibição de Pesquisa Rápida.
Selecione uma coluna pesquisável na lista e adicione-a à exibição.
Selecione Editar localizar colunas das tabelas para adicionar colunas pesquisáveis nas opções Localizar por.
Selecione Salvar e Publicar para publicar as alterações na exibição.

Note

Se você adicionar uma fonte de conhecimento do Dataverse antes de configurar suas colunas Multiline Text e File no Power Apps, pode levar até dois dias para que o sistema faça o backup da solicitação. Para agilizar, considere adicionar o conhecimento do Dataverse novamente depois de configurar o campo para pesquisa.

Limitações conhecidas

Funcionalidade	Limitation
Tabelas por fonte de conhecimento	Atualmente, até 15 mesas.
Authentication	As tabelas do Dataverse como fontes de conhecimento exigem que você defina a autenticação do agente como Authenticate com Microsoft. Não há suporte para as outras duas opções, Nenhuma autenticação e Autenticação manualmente .
Tabelas virtuais	Apenas tabelas virtuais que utilizam o provedor de dados de Finanças e Operações podem ser selecionadas.
Anexos de arquivos (prévia)	Tabelas, imagens e textos em linguagens não organizacionais não são suportados.

Sinônimos e glossário para fontes do Dataverse

Quando você edita uma fonte de conhecimento do Dataverse, não vê controles para sinônimos e glossário. As fontes do Dataverse usam os metadados de tabela e as descrições das colunas no Dataverse para correspondência de tempo de busca, então você não adiciona listas de sinônimos ou entradas de glossário separadas no Copilot Studio para essas fontes.

Para melhorar como seu agente encontra as linhas certas em uma fonte do Dataverse:

Adicione nomes de colunas e descrições claros na própria tabela do Dataverse.
Atualize o nome e a descrição da fonte no chip da fonte de conhecimento para que o agente possa identificar quando usar a fonte.
Faça testes com perguntas representativas na guia Visualizar para confirmar que o agente seleciona a fonte do Dataverse quando for esperado.
Use habilidades para ajudar seu agente a entender a linguagem comum.

Solução de problemas

A maioria das edições da tabela Dataverse se enquadra nas seguintes categorias:

Issue	Resolução
O Dataverse não é oferecido, ou nenhuma tabela pode ser adicionada	Certifique-se de que a busca no Dataverse esteja ativada no seu ambiente. Saiba mais em Configurar a pesquisa do Dataverse para o ambiente.
Uma tabela específica está ausente da lista	Certifique-se de que você tem as permissões adequadas para acessar os dados subjacentes. Permissões ausentes ou insuficientes podem impedir que as tabelas sejam visíveis ou selecionáveis durante a configuração. Saiba mais em Atribuir uma função de segurança a um usuário.
O agente ignora a fonte e responde de forma genérica	Certifique-se de que a fonte do conhecimento tenha um nome e uma descrição claros. A descrição auxilia a orquestração do agente e o agente a entender o contexto da fonte de conhecimento. Também confirme que o agente usa o Authenticate com a Microsoft.
Anotações ou arquivos anexados nunca aparecem nas respostas	Certifique-se de que as colunas de Texto Multilinha e Arquivo estejam configuradas como pesquisáveis na Visualização de Busca Rápida da tabela. Saiba mais em Configurar a pesquisa do Dataverse para o ambiente.

Quando Dataverse, Dynamics 365 e fontes de arquivos enviadas não estão disponíveis

Se a configuração de busca e índice do Dataverse para seu ambiente estiver configurada para um modo que não suporta conhecimento do agente, o diálogo Adicionar conhecimento mostra um banner de ação de administrador. Enquanto essa configuração estiver ativa, os comportamentos tanto no momento da adição quanto no momento da recuperação são afetados:

Você não pode adicionar novas fontes Dataverse, Dynamics 365 ou Arquivos carregados a agentes no ambiente.
Fontes desses tipos que você adicionou antes da mudança de configuração permanecem configuradas no agente, mas o agente pode não conseguir recuperar delas.

Os criadores do Copilot Studio não podem mudar essa configuração sozinhos. Peça ao seu administrador para atualizar a configuração de pesquisa e indexação do Dataverse no ambiente para um modo que dê suporte ao conhecimento do agente. Você não precisa remover nem adicionar novamente as fontes existentes — depois que a configuração for atualizada, o banner desaparece, a recuperação é retomada e você pode adicionar novas fontes novamente.