Adicione tabelas Dataverse ao seu agente como fonte de conhecimento

Quando integras as tabelas do Dataverse como fonte de conhecimento, bases o teu agente nos dados contidos nas tuas tabelas. Saiba mais em Melhorar as respostas dos agentes a partir de Microsoft Dataverse.

Note

Para usar esta fonte de conhecimento, os agentes do Copilot Studio devem usar a pesquisa Dataverse. Se você não puder adicionar uma tabela Dataverse a um agente, peça ao administrador para ativar a pesquisa Dataverse em seu ambiente. Saiba mais em O que é a pesquisa Dataverse e Configurar a pesquisa Dataverse para o seu ambiente.
As tabelas do Dataverse, como fontes de conhecimento, exigem que definas a autenticação do teu agente para Autenticar com Microsoft. As outras duas opções, Sem autenticação e Autenticação manual , não são atualmente suportadas.
Para adicionar tabelas Dataverse como fonte de conhecimento, deve ter as permissões adequadas para aceder aos dados subjacentes. Permissões em falta 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 utilizador.

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

Abra o seu agente do Copilot Studio.
Selecionar o separador Compilação.
No painel de componentes, selecione o botão Conhecimento .
Selecione Adicionar conhecimento e depois selecione Dataverse.
Localize uma ou mais de suas tabelas Dataverse para adicionar. Pode adicionar até 15 tabelas Dataverse por fonte de conhecimento. Para restringir as opções, use o campo de pesquisa.

Note

As recomendações da tabela são baseadas no nome do seu agente.
Analise 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 compreender o contexto da fonte de conhecimento.
Selecione Adicionar ao agente para concluir a adição da fonte de conhecimento.

Tip

Teste o seu agente com perguntas que os seus utilizadores fariam e inclua perguntas que exijam filtragem, como "que casos abertos esta semana ainda não estão resolvidos?", em vez de uma única pesquisa. Se as respostas saírem fracas, a correção costuma ser uma melhor descrição de conhecimento, não uma tabela diferente.

Prepare tabelas Dataverse com o Data Workspace

Quando adiciona tabelas do Dataverse como base de conhecimento, a etapa Selecionar tabelas pode incluir uma ligação para o Power Apps Data Workspace. Selecione o link se precisar de criar, atualizar ou organizar dados antes de escolher tabelas para o agente. O Data Workspace abre-se num novo separador, e pode voltar ao assistente Adicionar conhecimento quando estiver pronto para selecionar tabelas.

O link só aparece quando o seu ambiente tem a solução necessária para 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 funcionalidades de pré-visualização pode variar consoante o inquilino ou grupo de implementação.

Pesquisa em texto multilinha e colunas de ficheiros

Ao adicionar o Dataverse como fonte de conhecimento, pode aplicar raciocínio não estruturado para obter respostas de maior qualidade a partir das colunas Multiline Text (MemoType) e File (FileType). Por predefinição, a pesquisa funciona nas colunas estruturadas de uma tabela. A pré-visualização abrange também conteúdos não estruturados armazenados nas colunas Texto multilinha (MemoType) e Ficheiro (FileType), pelo que as notas, descrições e documentos anexos passam a poder ser utilizados para responder a perguntas.

Antes de realizar uma pesquisa nos dados do Dataverse, certifique-se de que cumpre os seguintes requisitos:

A capacidade de pesquisa do Dataverse está ativada.
Tens acesso maker ou administrador (necessário para modificar vistas no Power Apps).

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

Importante

Criar um índice de pesquisa implica custos adicionais de capacidade Dataverse. Saiba mais em Quanto custará a pesquisa do Dataverse?.

Configurar a tabela Dataverse no Power Apps

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

Inicia sessão em Power Apps e seleciona o ambiente que queres.
Selecione Dataverse e, em seguida, Tabelas.
Selecione a tabela Dataverse que você adicionou ao agente do Copilot Studio.
Ative Pesquisável para cada coluna em que pretende pesquisar.
No painel Experiências de Dados, selecione Vistas.
Na lista de modos de exibição, selecione o tipo de Visualização de Localização Rápida .
Selecione uma coluna pesquisável da lista e adicione-a à visualização.
Selecione Editar colunas de tabelas de localização para adicionar colunas pesquisáveis nas opções Localizar por .
Selecione Salvar e Publicar para publicar as alterações no modo de exibição.

Note

Se você adicionar uma fonte de conhecimento do Dataverse antes de configurar suas colunas Multiline Text and File no Power Apps, pode levar até dois dias para que o sistema preencha a solicitação. Para agilizar, considere adicionar novamente o conhecimento do Dataverse após configurar o campo de 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 definas a autenticação do teu agente para Autenticar com Microsoft. As outras duas opções, sem autenticação e autenticação manual , não são suportadas.
Tabelas virtual	Apenas as tabelas virtuais que utilizam o fornecedor de dados de Finanças e Operações podem ser selecionadas.
Anexos de ficheiros (pré-visualização)	Tabelas, imagens e texto em linguagens não organizacionais não são suportados.

Sinónimos e glossário para fontes do Dataverse

Quando editas uma fonte de conhecimento do Dataverse, não vês controlos para sinónimos e glossário. As fontes do Dataverse usam os metadados das tabelas e as descrições das colunas no Dataverse para correspondência de tempo de pesquisa, por isso não se adicionam listas de sinónimos ou entradas de glossário separadas no Copilot Studio para essas fontes.

Para melhorar a forma como o seu agente encontra as linhas certas numa fonte do Dataverse:

Adicione nomes de colunas e descrições claros na própria tabela Dataverse.
Atualize o nome e a descrição da fonte no chip de fonte de conhecimento para que o agente possa identificar quando deve usar a fonte.
Teste com perguntas representativas no separador Pré-visualização para confirmar que o agente seleciona a fonte do Dataverse quando tal é esperado.
Utilize competências para ajudar a treinar o seu agente a compreender expressões comuns.

Troubleshooting

A maioria das edições das tabelas Dataverse enquadra-se nas seguintes categorias:

Issue	Resolução
O Dataverse não é oferecido, ou não podem ser adicionadas tabelas	Certifique-se de que a pesquisa Dataverse está ativada no seu ambiente. Saiba mais em Configurar a pesquisa do Dataverse para o seu ambiente.
Falta uma tabela específica na lista	Certifique-se de que tem as permissões adequadas para aceder aos dados subjacentes. Permissões em falta 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 utilizador.
O agente ignora a fonte e responde de forma genérica	Certifique-se de que a fonte de conhecimento tem um nome e descrição claros. A descrição auxilia a orquestração do agente e ajuda o agente a compreender o contexto da fonte de conhecimento. Confirma também que o agente usa o Authenticate com a Microsoft.
Notas ou ficheiros anexos nunca aparecem nas respostas	Certifique-se de que as colunas de Texto Multilinha e Ficheiro estão configuradas como pesquisáveis na Vista de Pesquisa Rápida da tabela. Saiba mais em Configurar a pesquisa do Dataverse para o seu ambiente.

Quando o Dataverse, Dynamics 365 e fontes de ficheiros carregados não estão disponíveis

Se a definição de pesquisa e índice do Dataverse para o seu ambiente estiver definida para um modo que não suporta conhecimento do agente, a janela de diálogo Adicionar conhecimento mostra um banner de ação de administrador. Enquanto essa definição estiver em vigor, tanto o comportamento de tempo de adição como o de tempo de recuperação são afetados:

Não podes adicionar novas fontes Dataverse, Dynamics 365 ou ficheiros carregados a agentes no ambiente.
As fontes destes tipos que adicionaste antes de a configuração ser alterada permanecem configuradas no agente, mas o agente poderá não conseguir obter dados a partir das mesmas.

Os criadores do Copilot Studio não conseguem alterar esta configuração sozinhos. Peça ao seu administrador para atualizar a configuração de pesquisa e índice do Dataverse do ambiente para um modo que suporte o conhecimento do agente. Não precisa de remover ou voltar a adicionar fontes existentes — depois de a definição ser atualizada, o banner limpa-se, a recuperação recomeça e pode adicionar novas fontes novamente.