Adicionar tabelas SQL do Azure como fonte de conhecimento

Quando integra tabelas SQL do Azure como fonte de conhecimento, baseia o seu agente nos dados estruturados armazenados na sua base de dados SQL do Azure. O seu agente pode responder a perguntas lendo as tabelas selecionadas, usando as credenciais de ligação e permissões disponíveis para o criador.

Note

Para adicionar tabelas SQL do Azure como fonte de conhecimento, deve ter permissão para aceder à base de dados subjacente e às tabelas. Permissões em falta ou insuficientes podem impedir que servidores, bases de dados ou tabelas sejam visíveis ou selecionáveis durante a configuração.

Pré-requisitos

• Uma Base de Dados SQL do Azure ou Azure SQL Managed Instance que a sua organização possa aceder a partir da Power Platform.

• Credenciais que possam ligar-se à base de dados e ler as tabelas que pretende adicionar (por exemplo, Microsoft Entra ID ou autenticação SQL, dependendo de como a sua ligação está configurada).

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

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

Permissões e autenticação

O conhecimento de SQL do Azure utiliza a ligação SQL da Power Platform que cria ou seleciona durante a configuração. Em tempo de execução, o agente depende da autenticação Microsoft do utilizador agente e do acesso concedido através desse caminho de ligação.

• Os utilizadores só recebem respostas com base nos dados a que o criador pode aceder através da ligação configurada e das permissões da base de dados do criador.

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

Prepare a sua base de dados SQL do Azure

Os agentes do Copilot Studio suportam bases de dados SQL do Azure ou SQL Server. Antes de adicionar tabelas, certifique-se de que as suas mesas têm a seguinte configuração:

• Limpar os nomes das colunas, evitando também abreviaturas enigmáticas. Por exemplo, use CustomerName em vez de CustNm.
• Chaves primárias definidas para cada tabela. O agente utiliza chaves primárias para identificar linhas e devolver resultados.
• Dados descritivos, que ajudam o agente a compreender o contexto dos dados e a responder às perguntas com mais precisão. Por exemplo, use OrderDate em vez de Date1.

Adicionar tabelas SQL do Azure ao seu agente

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

1. Abra o seu agente do Copilot Studio.

2. Selecionar o separador Compilação.

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 ligação à sua base de dados SQL do Azure:

   • Se ainda não tiver uma ligação, selecione Criar nova ligação (ou Adicionar ligação).

   • Introduza o nome do servidor e o nome da base de dados do seu recurso SQL do Azure.

   • Escolha o tipo de autenticação exigido pela sua organização, inicie sessão ou forneça credenciais, e crie a ligação.

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

6. Localiza uma ou mais tabelas para adicionar. Use o campo de pesquisa para restringir a lista, se necessário, e depois selecione as tabelas que quer que o agente use.

   Note

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

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

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

Depois de adicionares a fonte de conhecimento

Depois de adicionar SQL do Azure:

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

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

• Teste o seu agente com perguntas que devem ser respondidas a partir das tabelas selecionadas. Por exemplo, "Mostre-me os cinco principais clientes por vendas totais no mês passado." Se os resultados devolvidos estiverem vazios ou incorretos, certifique-se de que a tabela contém os dados esperados e que a consulta está alinhada com o seu esquema.

Sugestão

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

Melhorar a qualidade das respostas

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

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

• Escreva uma descrição detalhada que explique que dados as tabelas contêm, que perguntas de negócio respondem e quaisquer filtros ou relações importantes.

• Selecione apenas tabelas relevantes. Tabelas extra podem diluir o aterramento e dificultar a escolha dos dados certos pelo agente.

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

Exemplo de descrição

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

SQL do Azure knowledge for Contoso order management. Inclui Clientes, Encomendas e tabelas OrderLines. Use esta fonte para perguntas sobre o estado das encomendas, histórico de encomendas, compras dos clientes, quantidades de produtos encomendados e receitas por cliente ou data. Não uses para inventário disponível ou rastreio de transportadores.