Objetivo

Nesta etapa será configurado o acesso do CR.IA Business ao sistema e ao banco de dados que serão utilizados pela plataforma.

A conexão permite que os agentes do CR.IA Business acessem as informações corporativas necessárias para realizar consultas, análises e responder às perguntas realizadas pelos usuários.

Cada sistema cadastrado representa uma origem de dados que poderá ser utilizada pelos agentes da plataforma.

Importante: antes de configurar a conexão, a etapa de Instalação do conector deve estar concluída.

---

Bancos de dados suportados

Atualmente, o CR.IA Business permite conexão com os seguintes bancos de dados:

• Microsoft SQL Server
• PostgreSQL
• SAP HANA
• Oracle

A configuração pode variar de acordo com o sistema utilizado e com a infraestrutura do ambiente da empresa.

---

Acessar a configuração da conexão

Após concluir a instalação do conector, retorne à tela de Instalação do CR.IA Business.

A etapa:

Configurar conexão

será disponibilizada.

Clique nessa opção para iniciar a configuração do sistema e do banco de dados.

A plataforma apresentará a tela de cadastro de sistemas.

Para criar uma nova conexão, clique em:

Novo

Será apresentada a janela de configuração da conexão, organizada nas seguintes abas:

• Geral
• Avançado
• Conexão

Cada aba possui informações específicas necessárias para configuração do ambiente.

---

Aba Geral

Na aba Geral são informados os dados de identificação do sistema que será conectado ao CR.IA Business.

Preencha os seguintes campos:

Nome

Informe um nome que permita identificar facilmente o sistema dentro do CR.IA Business.

Exemplos:

• SAP Business One
• ERP Produção
• SAP Matriz
• Banco Corporativo
• Sistema Financeiro

Recomenda-se utilizar um nome simples e facilmente reconhecido pelos administradores da plataforma.

Descrição

Informe uma breve descrição do sistema ou da finalidade da conexão.

Exemplo:

Base de produção do SAP Business One utilizada pela matriz.

O preenchimento da descrição facilita a identificação do ambiente, principalmente quando existem várias conexões cadastradas.

Tipo Sistema

Selecione o tipo de sistema que será conectado.

Essa informação identifica a aplicação ou ambiente de origem dos dados.

Após preencher as informações da aba Geral, acesse a aba Avançado.

---

Aba Avançado

A aba Avançado contém informações utilizadas para integração com o sistema corporativo.

Os campos disponíveis são:

Endpoint do ERP

Informe o endereço utilizado pelo CR.IA Business para comunicação com o ERP, quando aplicável.

Esse endereço depende do sistema utilizado pela empresa.

SAP Business One

Para ambientes SAP Business One, deve ser informado o endereço do Service Layer.

Exemplo de estrutura:

https://servidor:50000/b1s/v1

O endereço, porta e configuração podem variar de acordo com o ambiente SAP Business One da empresa.

Importante: o servidor onde está instalado o conector do CR.IA Business deve conseguir acessar o Endpoint do ERP informado.

Schema do ERP

Informe o schema ou identificação utilizada pelo ERP, quando aplicável.

Essa informação pode variar de acordo com o sistema conectado e sua configuração.

Em ambientes onde esse campo não seja necessário, o preenchimento deve seguir a configuração definida para o sistema utilizado.

---

Aba Conexão

Na aba Conexão são informados os dados técnicos necessários para que o CR.IA Business acesse o banco de dados.

Os seguintes campos estão disponíveis:

---

Software de Banco de Dados

Selecione o banco de dados utilizado pelo sistema.

As opções disponíveis incluem:

• Microsoft SQL Server
• PostgreSQL
• SAP HANA
• Oracle

Selecione a opção correspondente ao banco de dados do ambiente que será conectado.

---

Host do Banco de Dados

Informe o endereço do servidor onde está localizado o banco de dados.

Dependendo da infraestrutura da empresa, poderá ser utilizado:

• nome do servidor;
• endereço IP;
• host configurado para acesso ao banco.

Exemplos:

SERVIDORDB

ou

192.168.1.10

O servidor onde está instalado o conector deve conseguir acessar esse endereço.

---

Nome do Banco de Dados

Informe o nome do banco de dados que será utilizado pelo CR.IA Business.

Essa informação deve corresponder exatamente ao banco de dados existente no servidor informado.

Exemplo:

EMPRESA_PRODUCAO

Em ambientes SAP Business One, normalmente corresponde ao banco de dados da empresa que será consultada.

---

Schema do Banco de Dados

Informe o schema utilizado para acessar os objetos do banco de dados, quando aplicável.

O preenchimento desse campo depende do banco de dados utilizado e da estrutura configurada no ambiente.

---

Usuário do Banco de Dados

Informe o usuário que será utilizado pelo CR.IA Business para acessar o banco de dados.

Recomenda-se criar um usuário específico para utilização pelo CR.IA Business.

Recomendação de segurança: para utilização dos agentes destinados exclusivamente a consultas e análises, recomenda-se que o usuário possua somente permissões de leitura sobre os objetos necessários.

Dessa forma, consultas realizadas pelos agentes podem acessar as informações necessárias sem permitir alterações nos dados do sistema.

As permissões necessárias devem ser definidas de acordo com as tabelas, views ou objetos que serão disponibilizados para utilização no CR.IA Business.

---

Senha do Banco de Dados

Informe a senha correspondente ao usuário configurado no campo anterior.

Certifique-se de que a senha esteja correta e que o usuário esteja ativo no banco de dados.

---

Versão Alvo

Informe ou selecione a versão correspondente ao banco de dados utilizado no ambiente.

Essa configuração permite que o CR.IA Business utilize as características adequadas à versão do banco de dados conectado.

---

Exemplo de configuração para SAP Business One

Em um ambiente utilizando SAP Business One com SAP HANA, uma configuração típica terá:

Aba Geral

• Nome: identificação do ambiente SAP Business One
• Descrição: descrição da empresa ou ambiente
• Tipo Sistema: SAP Business One

Aba Avançado

• Endpoint do ERP: endereço do Service Layer
• Schema do ERP: schema correspondente ao ambiente

Aba Conexão

• Software de Banco de Dados: SAP HANA
• Host do Banco de Dados: servidor SAP HANA
• Nome do Banco de Dados: banco da empresa
• Schema do Banco de Dados: schema utilizado pelo ambiente
• Usuário do Banco de Dados: usuário configurado para acesso
• Senha do Banco de Dados: senha do usuário
• Versão Alvo: versão correspondente ao SAP HANA utilizado

Os endereços, nomes de banco, schemas, usuários e portas dependem da configuração de cada ambiente e devem ser confirmados com o responsável pela infraestrutura ou administração do ERP.

---

Salvar a conexão

Após preencher as informações necessárias nas abas Geral, Avançado e Conexão, revise os dados informados.

Clique em:

Salvar

O sistema será cadastrado no CR.IA Business e ficará disponível para utilização pela plataforma.

---

Finalizar a etapa

Após salvar a conexão, retorne à tela de Instalação.

A etapa Configurar conexão será apresentada como concluída.

Com essa etapa concluída, será possível avançar para:

Adicionar seu primeiro agente

Nessa etapa, o usuário poderá selecionar um agente pronto disponível na loja do CR.IA Business e adicioná-lo ao ambiente.

Próximo passo: Adicionar seu primeiro agente.

---

Solução de problemas na conexão

Caso a conexão não funcione corretamente, verifique os principais pontos abaixo.

Não foi possível acessar o banco de dados

Possíveis causas

• Host do banco de dados incorreto.
• Banco de dados informado incorretamente.
• Usuário ou senha inválidos.
• O servidor do conector não possui acesso ao servidor de banco de dados.
• Firewall ou regras de rede estão bloqueando a comunicação.
• Serviço do banco de dados não está disponível.

Como verificar

1. Confirme o Host do Banco de Dados.
2. Confirme o Nome do Banco de Dados.
3. Verifique o usuário e a senha informados.
4. Confirme se o servidor onde está instalado o conector consegue acessar o servidor de banco de dados.
5. Verifique as regras de firewall e rede do ambiente.
6. Confirme se os serviços do banco de dados estão ativos.

---

Usuário não possui permissão para consultar os dados

Possível causa

O usuário configurado para conexão não possui permissão de leitura sobre as tabelas, views ou objetos necessários.

Como resolver

Solicite ao administrador do banco de dados que conceda ao usuário as permissões de leitura necessárias para os objetos que serão utilizados pelo CR.IA Business.

Não é necessário conceder permissões de alteração de dados para agentes utilizados exclusivamente para consultas e análises.

---

Não foi possível acessar o Endpoint do ERP

Possíveis causas

• Endpoint informado incorretamente.
• Porta não acessível.
• Serviço do ERP indisponível.
• Firewall bloqueando a comunicação.
• O servidor do conector não consegue acessar o endereço informado.

Como resolver

1. Confirme o endereço informado em Endpoint do ERP.
2. Verifique se o serviço correspondente está em execução.
3. Confirme se o servidor do conector consegue acessar o endereço e a porta configurados.
4. Verifique eventuais regras de firewall.

Em ambientes SAP Business One, confirme também se o Service Layer está disponível e acessível pelo servidor onde o conector foi instalado.

---

A etapa não aparece como concluída

Caso a conexão tenha sido cadastrada, mas a etapa Configurar conexão continue pendente:

1. Verifique se o cadastro foi salvo corretamente.
2. Atualize a tela de Instalação.
3. Confirme se o sistema cadastrado permanece disponível.
4. Caso necessário, revise os dados de conexão.

Após a configuração ser reconhecida pela plataforma, a etapa será apresentada como concluída.

---

Conclusão

Com a conexão configurada, o CR.IA Business passa a possuir as informações necessárias para acessar o ambiente de dados da empresa.

A instalação estará então preparada para a próxima etapa obrigatória:

Adicionar seu primeiro agente

O agente utilizará a conexão configurada para acessar as informações necessárias às consultas e análises realizadas na plataforma.

Próximo passo: Adicionar seu primeiro agente.