1. Para que serve

Use o módulo Admin Fontes para consultar as fontes cadastradas, criar uma nova fonte, editar seus metadados, testar conexões, sincronizar documentos e remover fontes administradas.

A tela reúne conexões estruturadas e documentais do tenant. As ações de editar e remover ficam disponíveis somente para fontes administráveis; as fontes compartilhadas ou provenientes do Gateway podem ser apresentadas como somente leitura.

Página Administração de Fontes com filtro por tipo, pesquisa, tabela, conexões, status e ações
Figura 1 — Lista atual de fontes cadastradas.

2. Localizar uma fonte

Use o campo Buscar por nome, engine, grupo ou região para restringir a lista. Utilize o seletor para exibir Todas, Estruturadas ou Não estruturadas.

A tabela apresenta nome, mecanismo, grupo, região, indicação de PII, origem, conexão, status, clientes vinculados e ações disponíveis. Nome e engine podem ser ordenados pela própria tabela.

Filtro de fontes aberto com as opções Todas, Estruturadas e Não estruturadas
Figura 2 — Filtro por tipo de fonte.

3. Criar uma fonte

  1. Clique em + Nova Fonte.
  2. Preencha o nome e selecione o mecanismo.
  3. Informe grupo e região, quando aplicável.
  4. Preencha a configuração específica do mecanismo escolhido.
  5. Para fontes com conexão, clique em Testar Conexão ou Testar API.
  6. Revise o resultado e clique em Salvar.

Os mecanismos disponíveis incluem bancos relacionais, MongoDB, API REST, File Server, upload de arquivos, Google Drive, OneDrive e SharePoint. Os campos adicionais dependem do mecanismo escolhido.

Formulário de nova fonte de dados com metadados e campos de conexão
Figura 3 — Formulário de nova fonte.
Lista de mecanismos disponíveis no formulário de nova fonte de dados
Figura 4 — Seleção do mecanismo da fonte.

4. Campos principais

Campo Descrição
Nome Identificação da fonte na aplicação.
Engine Mecanismo ou tipo de fonte.
Grupo Agrupamento lógico da fonte.
Região Região informada para a fonte.
Host/IP e porta Endereço e porta usados na conexão de mecanismos de banco.
Banco e usuário Dados de identificação da conexão.
Senha Credencial usada no teste e na conexão.

5. Testar e acompanhar a conexão

Para fontes de banco, Testar Conexão verifica os dados informados antes do salvamento. Para uma API REST, a ação equivalente é Testar API. O resultado é apresentado no formulário como sucesso ou falha.

Na listagem, a conexão e o status variam conforme o tipo da fonte: fontes estruturadas podem indicar online, offline, conectado, aguardando teste ou pendente; fontes documentais podem indicar configurada, sem documentos, processando, com documentos prontos ou com falha.

6. Configurar arquivos e serviços de documentos

Para Google Drive, informe o link ou ID da pasta e escolha se as subpastas serão incluídas. Para OneDrive ou SharePoint, informe o link da pasta, a opção de incluir subpastas e os dados do aplicativo solicitados. Depois de salvar uma dessas fontes, use Testar acesso salvo e Sincronizar arquivos, quando disponíveis.

Para File Server, informe o diretório do servidor e clique em Escanear Diretório. Para o mecanismo Upload de arquivos, selecione até 100 arquivos por vez. São aceitos PDF, imagem, XML, JSON, TXT, XLSX, DOCX e CSV. Após o envio, a sincronização ou o escaneamento, o processamento de OCR, embeddings e indexação ocorre em segundo plano; acompanhe o resultado na coluna Status.

7. Editar ou remover uma fonte

  1. Localize a fonte na tabela.
  2. Clique em Editar para abrir os dados administráveis.
  3. Revise os metadados e as configurações específicas do mecanismo.
  4. Teste a conexão ou o acesso, quando aplicável.
  5. Clique em Salvar ou Fechar.

Para remover, clique no ícone de remoção e confirme o diálogo apresentado. A confirmação informa que a fonte será removida permanentemente e que a ação não pode ser desfeita.

Tela de gerenciamento de uma fonte com ações de edição e configuração
Figura 5 — Editar uma fonte selecionada.

Os vínculos entre fontes e clientes são exibidos na coluna Clientes. Para criar ou alterar esses vínculos, utilize o módulo Admin Clientes, na área Fontes.

8. Principais fluxos

  • Cadastrar banco: Nova Fonte → metadados → conexão → Testar Conexão → Salvar.
  • Cadastrar documentos: Nova Fonte → escolher mecanismo documental → configurar pasta, diretório ou arquivos → Salvar → sincronizar ou escanear, quando aplicável → acompanhar processamento.
  • Atualizar fonte: localizar → Editar → revisar → testar, quando aplicável → Salvar.
  • Vincular a cliente: Admin Clientes → Fontes → criar ou alterar o vínculo.
  • Remover: localizar → ícone de remoção → confirmar a operação.