Integrações
Visão geral
As integrações ligam o OutDo a fontes de dados e serviços externos. Permitem obter dados de APIs, importar ficheiros, e usar AI para extrair informação estruturada de documentos.
Cada integração está limitada a um workspace e guarda a sua configuração específica do tipo. As integrações são geridas através da secção Integrations do Painel de administração.
Propriedades da integração
| Propriedade | Descrição |
|---|---|
| Name/Label | Nome de apresentação da integração |
| Type | HTTP, Excel, AI Struct, ou Template |
| Workspace | A que workspace a integração pertence |
| Shared | Se a integração está acessível a partir de outros workspaces |
Integração HTTP
A integração HTTP liga-se a APIs REST, obtém dados, mapeia campos da resposta para colunas de features, e sincroniza os resultados.
Configuração
Endpoints — Define um ou mais endpoints de API:
| Definição | Descrição |
|---|---|
| Method | GET, POST, PUT, ou DELETE |
| URL | URL do endpoint da API (suporta a sintaxe de template {{org.var}} e {{ws.var}}) |
| Headers | Headers HTTP personalizados (por exemplo, tokens de autenticação) |
| Variables | Parâmetros de entrada para a chamada da API |
| Response structure | Estrutura JSON esperada da resposta |
Data mappings — Mapeia campos da resposta da API para colunas de features:
| Definição | Descrição |
|---|---|
| API path | Caminho JSON na resposta (por exemplo, data.0.customer_name) |
| Target feature | Feature de destino para os dados mapeados |
| Target column | Coluna de destino dentro da feature |
| Transformations | Transformações de valor (regex, fórmulas) aplicadas durante o mapeamento |
Linked Select resolution — Faz corresponder automaticamente valores da API a registos existentes em features ligadas.
Fluxo do utilizador
- Configura o URL do endpoint, o método, os headers, e as variáveis.
- Testa o endpoint com valores de exemplo para as variáveis — vê a resposta como JSON ou como pré-visualização em tabela.
- Configura o mapeamento de dados dos campos da resposta da API para colunas de features.
- Executa o fetch — os dados ficam numa área de staging para revisão.
- Valida os dados mapeados.
- Sincroniza com a feature de destino.
Importação/exportação Excel
A integração Excel importa dados de ficheiros Excel (.xlsx) e CSV com mapeamento de colunas, transformações, e pré-visualização.
Configuração
Definições do ficheiro:
| Definição | Descrição |
|---|---|
| CSV delimiter | Separador para ficheiros CSV (predefinição: vírgula) |
| CSV encoding | Codificação de caracteres (predefinição: UTF-8) |
| Has header | Se a primeira linha contém os nomes das colunas |
| Start row | Número de linhas a saltar antes de os dados começarem |
| Sheet name | Para ficheiros Excel com várias folhas |
Mapeamentos de colunas:
| Definição | Descrição |
|---|---|
| Source column | Nome da coluna no ficheiro carregado |
| Target column | Coluna de destino na feature |
| Component type | Tipo de componente de destino (para regras de limpeza) |
| Include | Toggle para ignorar uma coluna |
| Transformations | Transformações de dados por coluna (trim, maiúsculas, minúsculas, regex, etc.) |
| Fixed values | Valores estáticos acrescentados a todos os registos importados |
Fluxo do utilizador
- Carrega um ficheiro Excel ou CSV usando o seletor de ficheiros.
- Seleciona a folha (se o ficheiro tiver várias folhas).
- Pré-visualiza as primeiras 100 linhas numa tabela.
- Revê a configuração do mapeamento de colunas.
- Executa a importação com um indicador de progresso.
- Revê os resultados — contagem de sucessos e de erros.
AI Struct
A integração AI Struct usa inteligência artificial para extrair dados estruturados de documentos (PDFs, imagens). Suporta vários fornecedores de AI e schemas de extração configuráveis.
Configuração
Fornecedor de AI:
| Definição | Descrição |
|---|---|
| Provider | Mistral, OpenAI, ou Anthropic |
| Model | Nome do modelo (por exemplo, GPT-4o, Claude Sonnet) |
| API key | Chave de autenticação para o serviço de AI |
| Endpoint | Endpoint de API personalizado (opcional) |
| Max tokens | Comprimento máximo da resposta |
| Temperature | Criatividade da resposta (0 = determinística, 1 = criativa) |
Entrada:
| Definição | Descrição |
|---|---|
| Mode | File picker (o utilizador escolhe os ficheiros) ou Variable (automatizado) |
| OCR | Pré-processamento opcional por OCR, com os fornecedores: Google ML Kit, Google Cloud Vision, Azure |
| Max pages | Limita o número de páginas processadas por documento |
| PDF render DPI | Qualidade de imagem para a conversão do PDF (predefinição: 150) |
Extração:
| Definição | Descrição |
|---|---|
| System prompt | Instruções para a AI sobre o que extrair |
| User prompt template | Template de mensagem com o placeholder {{instructions}} |
| Schema fields | Define a estrutura esperada dos dados extraídos |
| Column mappings | Mapeia campos extraídos para colunas de features |
Deduplicação:
| Definição | Descrição |
|---|---|
| Enabled | Verifica se há registos duplicados antes da importação |
| Strategy | Como lidar com duplicados |
| Matching fields | Que campos comparar para a deduplicação |
Fluxo do utilizador
- Seleciona os documentos a processar (seletor de ficheiros ou fila em lote).
- Configura o fornecedor de AI, o modelo, e o schema de extração.
- Define as instruções do prompt a descrever o que extrair.
- Processa os ficheiros — a AI extrai dados estruturados.
- Revê os dados extraídos numa vista de staging.
- Trata os duplicados com base nas regras de deduplicação.
- Sincroniza com a feature de destino.
Correspondência e preenchimento automáticos
O AI Struct suporta correspondência automática inteligente dos dados extraídos com registos existentes, e preenchimento automático de colunas de features com base em mapeamentos de cabeçalho e de linhas de itens dos documentos processados.
Templates
Os Templates de integração disponibilizam padrões de integração pré-configurados que podem ser carregados e personalizados. Servem como pontos de partida para cenários comuns de integração, reduzindo o tempo de configuração.