Adicionar tabelas SQL do Azure como fonte de conhecimento

Quando você integra tabelas SQL do Azure como fonte de conhecimento, você fundamenta seu agente nos dados estruturados armazenados no seu banco de dados SQL do Azure. Seu agente pode responder perguntas lendo as tabelas selecionadas, usando as credenciais de conexão e permissões disponíveis para o criador.

Note

Para adicionar tabelas SQL do Azure como fonte de conhecimento, você deve ter permissão para acessar o banco de dados e as tabelas subjacentes. Permissões ausentes ou insuficientes podem impedir que servidores, bancos de dados ou tabelas sejam visíveis ou selecionáveis durante a configuração.

Prerequisites

• Um Banco de Dados SQL do Azure ou Instância Gerenciada de SQL do Azure que sua organização pode acessar a partir do Power Platform.

• Credenciais que podem se conectar ao banco de dados e ler as tabelas que você pretende adicionar (por exemplo, Microsoft Entra ID ou autenticação SQL, dependendo de como sua conexão está configurada).

• Acesso ao Copilot Studio e permissão para editar o agente.

• Acesso à rede configurado para que o Power Platform possa alcançar seu servidor SQL do Azure. Por exemplo, regras de firewall que permitem serviços do Azure ou conectividade privada conforme exigido pela sua organização.

Permissões e autenticação

O conhecimento em SQL do Azure usa a conexão SQL do Power Platform que você cria ou seleciona durante a configuração. Em tempo de execução, o agente depende da autenticação Microsoft do usuário do agente e do acesso concedido por meio desse caminho de conexão.

• Os usuários só recebem respostas com base nos dados que o criador pode acessar por meio da conexão configurada e das permissões do banco de dados.

• Se as tabelas não aparecerem durante a configuração, verifique se a conexão foi bem-sucedida fora do Copilot Studio e se a conta pode listar e ler essas tabelas.

Prepare seu banco de dados SQL do Azure

Os agentes do Copilot Studio suportam bancos de dados SQL do Azure ou SQL Server. Antes de adicionar tabelas, certifique-se de que suas tabelas tenham a seguinte configuração:

• Limpe os nomes das colunas, evitando também abreviações enigmáticas. Por exemplo, use CustomerName em vez de CustNm.
• Chaves primárias definidas para cada tabela. O agente usa chaves primárias para identificar linhas e retornar resultados.
• Dados descritivos, que ajudam o agente a entender o contexto dos dados e responder perguntas com mais precisão. Por exemplo, use OrderDate em vez de Date1.

Adicione tabelas SQL do Azure ao seu agente

Para adicionar tabelas SQL do Azure como fonte de conhecimento, complete os seguintes passos:

1. Abra seu agente do Copilot Studio.

2. Selecione a guia Criar.

3. No painel de componentes, selecione Conhecimento.

4. No diálogo Adicionar conhecimento, selecione SQL do Azure (ou SQL Server, dependendo do rótulo mostrado no seu ambiente).

5. Crie ou selecione uma conexão para seu banco de dados SQL do Azure:

   • Se você ainda não tem uma conexão, selecione Criar nova conexão (ou Adicionar conexão).

   • Insira o nome do servidor e do banco de dados do seu recurso SQL do Azure.

   • Escolha o tipo de autenticação exigido pela sua organização, faça login ou forneça credenciais, e crie a conexão.

   • Se já existir uma conexão, selecione-a da lista e continue.

6. Localize uma ou mais tabelas para adicionar. Use o campo de busca para restringir a lista, se necessário, e então selecione as tabelas que quer que o agente use.

   Note

   Só adicione tabelas que o agente precisa responder às perguntas dos usuários. Use tabelas bem nomeadas com nomes claros de colunas para que o agente possa interpretar os dados de forma mais confiável.

7. 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.

8. Selecione Adicionar ao agente para concluir a adição da fonte de conhecimento.

Depois que você adiciona a fonte de conhecimento

Depois que você adiciona SQL do Azure:

• Confirme que a fonte de conhecimento aparece na página de Conhecimento do agente com a conexão e as tabelas selecionadas que você escolheu.

• Publique o agente para que a fonte de conhecimento esteja disponível na experiência publicada.

• Teste seu agente com perguntas que devem ser respondidas nas tabelas selecionadas. Por exemplo, "Mostre-me os cinco maiores clientes por vendas totais no mês passado." Se os resultados retornados estiverem vazios ou incorretos, certifique-se de que a tabela contenha os dados esperados e que a consulta esteja alinhada com seu esquema.

Dica

Crie uma visualização de diagnóstico no SQL do Azure que retorne um conjunto de dados pequeno e conhecido. Use este conjunto de dados para confirmar que a conexão funciona antes de usar tabelas de produção.

Melhore a qualidade das respostas

Nomes e descrições claros ajudam o agente a entender quando e como usar seus dados do SQL do Azure.

• Use um nome específico de fonte de conhecimento que reflita o domínio do negócio (por exemplo, "Pedidos de clientes – SQL do Azure") em vez de um rótulo genérico.

• Escreva uma descrição detalhada que explique quais dados as tabelas contêm, quais perguntas de negócios elas respondem e quaisquer filtros ou relacionamentos importantes.

• Selecione apenas tabelas relevantes. Tabelas extras podem diluir o aterramento e dificultar para o agente escolher os dados corretos.

• Prefiro esquema legível. Tabelas e colunas com nomes amigáveis para negócios geralmente produzem respostas melhores do que nomes técnicos opacos.

Descrição de exemplo

O exemplo a seguir mostra o tipo de descrição que ajuda a orquestração generativa a selecionar a fonte de conhecimento correta:

SQL do Azure knowledge for Contoso order management. Inclui Clientes, Pedidos e tabelas OrderLines. Use esta fonte para dúvidas sobre status dos pedidos, histórico de pedidos, compras dos clientes, quantidades de produtos pedidos e receita por cliente ou data. Não use para estoque disponível ou rastreamento de transportadores.