Objetivo

O gerenciamento de Fontes de Dados permite cadastrar, visualizar e administrar as estruturas de dados utilizadas pelos agentes do CR.IA Business.

As Fontes de Dados permitem centralizar a configuração das tabelas e consultas utilizadas pelos agentes, incluindo os campos que estarão disponíveis para análise.

Uma mesma Fonte de Dados pode ser utilizada por diferentes agentes, evitando a necessidade de replicar consultas e configurações.

Essa tela é utilizada principalmente por administradores do ambiente.

Acessar a Tela de Fontes de Dados

Para acessar o gerenciamento de Fontes de Dados:

1. No menu lateral do CR.IA Business, selecione Fontes de Dados.

A tela exibirá a lista de Fontes de Dados cadastradas no sistema.

Cada Fonte de Dados é apresentada com as seguintes informações:

• Nome
• Tipo
• Origem

Também é possível utilizar o campo Pesquisar fontes de dados para localizar rapidamente uma Fonte de Dados específica.

Ações Disponíveis na Tela de Fontes de Dados

Na parte superior da tela de Fontes de Dados estão disponíveis diversas ações para gerenciamento das fontes cadastradas.

As opções disponíveis são:

Novo
Permite criar uma nova Fonte de Dados.

Editar
Permite editar a configuração de uma Fonte de Dados existente.

Excluir
Remove a Fonte de Dados do ambiente.

Atualizar
Atualiza a lista de Fontes de Dados cadastradas.

Reiniciar
Reinicia o serviço do CR.IA Business para aplicar novas configurações, quando necessário.

Observação

As opções Novo e Editar são utilizadas para criação e manutenção das Fontes de Dados. O funcionamento detalhado dessas opções será apresentado nas seções seguintes.

Selecionar uma Fonte de Dados

Para realizar ações sobre uma Fonte de Dados, primeiro é necessário selecioná-la na lista.

1. Localize a Fonte de Dados desejada.
2. Marque a caixa de seleção ao lado do nome da Fonte de Dados.

Após selecionar a Fonte de Dados, as opções de gerenciamento ficarão disponíveis na barra superior da tela.

Criar uma Nova Fonte de Dados

Para criar uma nova Fonte de Dados:

1. Na tela Fontes de Dados, clique no botão Novo.
2. Será apresentada a tela Nova Fonte de Dados.
3. Na aba Configuração, informe o Nome da Fonte de Dados.
4. Selecione o Tipo da fonte:
   • Tabela – utilizada quando os dados estão disponíveis diretamente em uma tabela.
   • Consulta – utilizada quando os dados serão obtidos por meio de uma consulta SQL.
5. Informe a tabela ou a consulta SQL, conforme o tipo selecionado.

Quando o tipo Consulta for selecionado, informe a consulta SQL no campo correspondente.

Verificar a Consulta

A opção Verificar consulta permite testar a comunicação com o sistema de origem e validar a tabela ou consulta informada.

Para realizar a validação:

1. Clique em Verificar consulta.
2. Será exibida a janela Selecionar Sistema.
3. Selecione o sistema que será utilizado para realizar o teste.
4. Clique em Confirmar.

Se a consulta for executada corretamente, será apresentada a mensagem Consulta válida.

Caso ocorra algum problema durante a execução, o sistema apresentará a mensagem de erro correspondente.

Configurar os Campos

Na aba Campos são definidos os campos que estarão disponíveis para utilização pelos agentes.

Existem duas formas de configurar os campos:

Adicionar Campo

Permite informar manualmente os campos retornados pela tabela ou consulta.

Carregar da Fonte de Dados

Permite carregar automaticamente os campos retornados pela tabela ou consulta.

Ao utilizar essa opção, será exibida novamente a janela Selecionar Sistema. Após selecionar o sistema e confirmar, o CR.IA Business utilizará inteligência artificial para interpretar a consulta e carregar os campos automaticamente.

Após o carregamento, os campos poderão ser ajustados pelo usuário.

O campo Rótulo deve representar a forma como a informação é normalmente identificada pelos usuários no dia a dia. Esse campo é utilizado pela inteligência artificial para identificar o campo correspondente às informações solicitadas nas perguntas realizadas no chat.

Por exemplo:

• nome_filial → filial
• nome_loja → loja
• nome_planta → planta

Recomenda-se utilizar termos conhecidos pelos usuários da empresa, evitando utilizar somente nomes técnicos provenientes do banco de dados.

Os campos carregados também podem ser editados ou excluídos conforme a necessidade.

As demais configurações disponíveis para os campos, incluindo Regras, podem ser ajustadas conforme a necessidade da Fonte de Dados.

Editar uma Fonte de Dados

Após o cadastro, uma Fonte de Dados pode ser editada para alterar suas configurações ou seus campos.

Para editar uma Fonte de Dados:

1. Selecione a Fonte de Dados desejada na lista.
2. Clique no botão Editar.
3. Altere as informações necessárias.
4. Caso necessário, acesse a aba Campos para incluir, alterar ou excluir campos.
5. Clique em Salvar para gravar as alterações.

As alterações realizadas em uma Fonte de Dados compartilhada poderão refletir nos agentes que utilizam essa fonte.

Excluir uma Fonte de Dados

A exclusão remove a Fonte de Dados do ambiente.

Para excluir uma Fonte de Dados:

1. Selecione a Fonte de Dados na lista.
2. Clique no botão Excluir.

Será exibida uma janela de confirmação.

Antes de realizar a exclusão, verifique se a Fonte de Dados não está sendo utilizada por agentes do ambiente.

Observações Importantes

• Uma Fonte de Dados pode ser utilizada por diferentes agentes.
• A utilização de Fontes de Dados compartilhadas evita a duplicação de consultas e configurações.
• Os campos da Fonte de Dados devem corresponder às informações retornadas pela tabela ou consulta.
• Os Rótulos devem utilizar termos conhecidos pelos usuários, pois são utilizados pela inteligência artificial para identificar os campos nas perguntas realizadas no chat.
• Alterações realizadas em uma Fonte de Dados compartilhada podem afetar os agentes que utilizam essa fonte.

Após alterações importantes, pode ser necessário reiniciar o serviço do CR.IA Business para aplicar as novas configurações.