Como Processar Documentos com o ABBYY Vantage usando SFTP

Visão geral

ABBYY Vantage possibilita o processamento automático de documentos com recursos inteligentes de extração. Este guia se concentra no fluxo de trabalho baseado em SFTP, que permite enviar documentos para uma pasta compartilhada e recuperar automaticamente os resultados processados. O que você vai fazer:

Criar e configurar uma Skill de Processo
Configurar o acesso SFTP para entrada e saída
Enviar documentos por linha de comando
Baixar os resultados de extração

Tempo para concluir: 15–20 minutos

Etapa 1: Criar uma Skill de Processo

Uma Skill de Processo é a base do seu fluxo de trabalho de processamento de documentos no Vantage.

Acesse a seção Documents no ABBYY Vantage.
Clique em Skill Designer na barra lateral esquerda.
Selecione Skill de Processo entre os tipos de skill.

Na caixa de diálogo Create Process skill, insira:
- Skill Name: Um nome descritivo para o seu processo (por exemplo, “Teste de Skill de Processo 1”)
- Description: Descrição opcional do que essa skill faz
- Technology Core Version: 3.0 (recomendado)

Clique em Create

Etapa 2: Configurar o workflow da Skill de Processo

Depois de criar sua skill, você configurará o fluxo de processamento de documentos.

No Skill Designer, você verá o painel Select Process Skill à direita
Escolha Simple Document skill workflow para processar um único tipo de documento

Isso cria um workflow pré-configurado com:

Conector Input: Onde os documentos entram no sistema
Skill de OCR (Optical Character Recognition): Reconhecimento óptico de caracteres
Skill de Extract: Extração de dados
Conector Output: Onde os resultados são entregues

O workflow aparecerá no canvas central exibindo: Input → OCR → Extract → Output

Etapa 3: Configurar a entrada via SFTP

Configure a atividade Input para aceitar documentos via SFTP.

Clique na atividade Input no fluxo de trabalho.
No painel Actions à direita, marque Select additional source.
Selecione a opção Shared folder.
Clique em Settings para configurar.

Configurar as definições de entrada

Na caixa de diálogo Input Settings: Shared Folder:

Configurações da pasta:

Folder name: Input (padrão)
Import method: Single file

Credenciais para importação (exibidas para sua utilização):

Folder link: .../Input
Exceptions folder link: .../Input-exception
Username: Um UUID gerado (por exemplo, 685df03c-9e22-41cb-a96f-4c408ab52735)
Password: Exibida com opção de mostrar/ocultar

Observação: Copie essas credenciais, pois você precisará delas para se conectar via SFTP. Arquivos que não puderem ser importados serão movidos para a pasta de exceções. O Vantage verifica se há arquivos a cada 20 segundos após a publicação da Skill.

Clique em Save.

Etapa 4: Configurar Output via SFTP

Configure a atividade Output para entregar os resultados via SFTP.

Clique na atividade Output no fluxo de trabalho.
No painel Actions, marque Select additional destination.
Selecione o botão de rádio Shared folder.
Clique em Settings para configurar.

Configurar as opções de saída

Na caixa de diálogo Output Settings: Shared Folder:

Informações:

Folder name: Output (padrão)
Folder: .../Output
Username: Um UUID gerado automaticamente (por exemplo, 685df03c-9e22-41cb-a96f-4c408ab52735)
Password: A senha é exibida, com opção de mostrar/ocultar

Dados exportados:

Fields (JSON): Formato de exportação padrão

Observação: Os resultados são organizados em subpastas nomeadas com base no arquivo de origem e no ID da transação (por exemplo, invoice_1.jpg-4ac2a31b-d1b6-4231-99b2-39f00bc5df82). Os arquivos são removidos automaticamente de acordo com a política de retenção de dados.

Clique em Save.

Etapa 5: Configurar Skills de Extração

Defina quais tipos de documento a atividade Extract deve reconhecer e processar.

Clique na atividade Extract no fluxo de trabalho.
No painel Actions, você verá Document Skills.

As Skills de Documento disponíveis incluem:

Invoice
Invoice AU-NZ
Invoice CA
Invoice ES
Invoice UA
Invoice US

Selecione os tipos de documento relevantes para o seu caso de uso.
Clique em Add Skill se precisar de tipos de documento adicionais.
Use Edit Mapping para personalizar a extração de campos, se necessário.

Etapa 6: Publicar e obter o ID da sua Skill

Antes de usar o SFTP, você precisa publicar a Skill e localizar o respectivo ID.

Clique no botão Publish no canto superior direito do Skill Designer.
Depois de publicada, anote o Skill ID na URL do navegador.

O formato da URL é:

https://vantage-preview.abbyy.com/skill-editor/Processing/{skill-id}

Por exemplo: fc7116ea-ab6c-40fa-b10d-1aef61aaaa2c Aviso: Mantenha o ID da sua Skill em mãos – você vai precisar dele para acessar as pastas corretas de entrada e saída no SFTP.

Etapa 7: Conectar ao SFTP

Agora você está pronto para se conectar via SFTP usando as credenciais das configurações de Entrada/Saída.

Detalhes da conexão

Em suas configurações de Input/Output, você tem:

Server: 172.172.228.138
Port: 2022
Username: Seu UUID gerado
Password: Sua senha gerada
Base Path: /{skill-id}/

Conectar via Terminal

Abra o terminal e conecte-se usando:

sftp -P 2022 {username}@172.172.228.138

Exemplo:

sftp -P 2022 [email protected]

Observação: Use -P maiúsculo para o número da porta no SFTP (-p minúsculo é usado para outra finalidade). Quando solicitado, digite sua senha.

Etapa 8: Navegar pela estrutura de pastas do SFTP

Depois de conectado, você verá o prompt do SFTP: sftp>

Exibir Skills Disponíveis

Liste todas as Skills de Processo disponíveis:

sftp> ls

Você verá pastas para cada skill (identificadas pelos respectivos IDs de skill), além de:

Catalogs - Catálogos de Skill de Documento
Catalogs-exception - Importações de catálogos com falha
skills-import - Diretório de importação de skills

Acesse seu Skill

Use o ID do Skill da Etapa 6:

sftp> cd {your-skill-id}
sftp> ls

Você deverá ver três pastas:

Input - Onde você envia documentos para processamento
Input-exception - Importações com falha são movidas para cá
Output - Onde os resultados processados são exibidos

Etapa 9: Enviar documentos para processamento

Acesse a pasta Input e envie seus documentos.

Acesse a pasta de entrada

sftp> cd Input
sftp> pwd
Remote working directory: /{skill-id}/Input

Carregar um único arquivo

Carregue um arquivo informando o caminho completo:

sftp> put ~/Documents/Sample\ Files/Demo\ Docs/invoice_1.jpg

Ou, primeiro, altere o diretório local:

sftp> lcd ~/Documents/Sample\ Files/Demo\ Docs
sftp> lls
sftp> put invoice_1.jpg

Carregar vários arquivos

sftp> mput *.jpg
sftp> mput invoice_*.pdf

Observação: Os arquivos enviados para o Input são automaticamente excluídos após o processamento bem-sucedido (geralmente em até 20 segundos). Se você não encontrar o seu arquivo depois de fazer o upload, isso significa que o Vantage já o colocou em processamento!

Verificar envio

Verifique se os arquivos ainda estão na pasta Input:

sftp> ls

Se a pasta estiver vazia ou se o seu arquivo não estiver lá, o processamento já foi iniciado.

Etapa 10: Verificar o status do processamento

Monitorar a pasta de exceções de entrada

Se um arquivo falhar na importação, ele aparecerá aqui:

sftp> cd ..
sftp> cd Input-exception
sftp> ls

Uma pasta vazia indica que todos os arquivos foram importados com sucesso.

Aguarde o processamento

O tempo de processamento varia dependendo de:

Complexidade do documento
Skills de extração configuradas
Carga atual do sistema

Normalmente, faturas simples são processadas em 30–60 segundos.

Etapa 11: Baixar resultados processados

Quando o processamento for concluído, os resultados aparecerão na pasta Output.

Navegue até a pasta de saída

sftp> cd ..
sftp> cd Output
sftp> ls

Compreendendo a estrutura dos resultados

Os resultados são organizados em subpastas com o seguinte padrão de nomenclatura:

{original-filename}-{transaction-id}

Exemplo:

invoice_1.jpg-4ac2a31b-d1b6-4231-99b2-39f00bc5df82

Exibir o conteúdo da pasta de resultados

sftp> cd invoice_1.jpg-4ac2a31b-d1b6-4231-99b2-39f00bc5df82
sftp> ls

Conteúdo típico:

Invoice_US.json - Dados extraídos em formato JSON
Invoice_US.csv - Dados extraídos em formato CSV (se configurado)
Arquivos adicionais, dependendo das configurações de saída

Fazer download dos resultados

Defina o diretório local para download:

sftp> lcd ~/Downloads
sftp> lpwd
Local working directory: /Users/yourname/Downloads

Baixar um único arquivo:

sftp> get Invoice_US.json

Baixe todos os arquivos da pasta:

sftp> mget *

Baixar toda a pasta de resultados de forma recursiva:

sftp> cd ..
sftp> get -r invoice_1.jpg-4ac2a31b-d1b6-4231-99b2-39f00bc5df82

Entendendo a saída JSON

A saída padrão é um arquivo JSON que contém:

Estrutura do documento - Layout e organização
Valores de campos extraídos - Dados obtidos do documento
Níveis de confiança - Confiabilidade de cada extração
Erros de regra - Quaisquer problemas de validação
Metadados de campos - Informações adicionais sobre cada campo

Estrutura de exemplo:

{
  "Document": {
    "DocumentType": "Invoice US",
    "Fields": [
      {
        "Name": "InvoiceNumber",
        "Value": "INV-12345",
        "Confidence": 0.98
      },
      {
        "Name": "Total",
        "Value": "1250.00",
        "Confidence": 0.95
      }
    ]
  }
}

Para obter a documentação detalhada do esquema JSON, consulte a documentação da ABBYY Vantage API.

Comandos SFTP úteis

Comando	Descrição	Exemplo
`ls`	Listar arquivos remotos	`ls`
`lls`	Listar arquivos locais	`lls`
`pwd`	Mostrar diretório remoto	`pwd`
`lpwd`	Mostrar diretório local	`lpwd`
`cd folder`	Alterar diretório remoto	`cd Output`
`lcd folder`	Alterar diretório local	`lcd ~/Downloads`
`put file`	Enviar um único arquivo	`put invoice.pdf`
`mput files`	Enviar vários arquivos	`mput *.jpg`
`get file`	Baixar um único arquivo	`get result.json`
`mget files`	Baixar vários arquivos	`mget *`
`get -r folder`	Baixar pasta de forma recursiva	`get -r results/`
`exit`	Desconectar	`exit`

Solução de problemas

Problemas de conexão

Problema: erros de “Connection refused” ou de tempo limite (timeout) Soluções:

Verifique se você está conectado à VPN da empresa
Confira o número da porta (deve ser 2022 com a opção -P em maiúsculo)
Confirme se seu nome de usuário e senha estão corretos
Teste a conectividade básica da rede: ping 172.172.228.138

Problemas de carregamento

Problema: Arquivos não estão sendo processados Soluções:

Verifique a pasta Input-exception em busca de importações com falha
Verifique se o formato do arquivo é suportado (PDF, JPG, PNG, TIFF, etc.)
Certifique-se de que o Skill de Processo está publicado
Verifique os limites de tamanho de arquivo (varia conforme a configuração)

Nenhum arquivo de saída

Problema: A pasta de saída fica vazia após o envio dos arquivos Soluções:

Aguarde mais tempo – o processamento pode levar de 30 a 60 segundos ou mais
Verifique se o Output está configurado com o destino “Shared folder”
Verifique os logs da transação na interface web do Vantage
Confirme se a atividade Extract tem as skills de documento apropriadas configuradas

Erros de permissão

Problema: “Permissão negada” ao enviar/baixar Soluções:

Verifique se você está usando as credenciais corretas para Input e Output
As credenciais de Input permitem: upload e exclusão
As credenciais de Output permitem: visualização, download, renomear e exclusão
Verifique se a skill está publicada e ativa

Práticas recomendadas

Segurança

Nunca compartilhe credenciais de SFTP em texto aberto
Use canais seguros para transmitir senhas
Altere as credenciais periodicamente
Limite o acesso SFTP apenas ao pessoal necessário

Gerenciamento de arquivos

Use nomes de arquivo descritivos que incluam datas ou IDs
Processe arquivos em lotes fora do horário de pico, se possível
Baixe e arquive os resultados o quanto antes
Limpe regularmente as pastas de resultados antigos

Monitoramento

Verifique regularmente a pasta Input-exception para identificar falhas de importação
Monitore os tempos de processamento para identificar gargalos
Revise os níveis de confiança da extração nos resultados
Configure alertas para falhas críticas (se disponível)

Otimização do fluxo de trabalho

Agrupe tipos de documentos semelhantes
Configure Skills de Documento apropriadas para o seu caso de uso
Teste com documentos de exemplo antes do uso em produção
Documente seu fluxo de trabalho SFTP para referência da equipe

Próximas etapas

Agora que você tem um pipeline de processamento de documentos baseado em SFTP em funcionamento:

Teste com vários documentos - Carregue diferentes tipos de arquivo e variações de documentos
Verifique a precisão da extração - Analise os resultados em JSON e as pontuações de confiança
Personalize a extração - Use Edit Mapping para ajustar com precisão a extração de campos
Automatize os uploads - Crie scripts para automatizar o envio de arquivos
Integre com sistemas - Conecte seus aplicativos por meio da API REST do Vantage
Expanda seu fluxo de trabalho - Adicione mais Skills de Documento ou crie Skills de Processo adicionais

Para configurações avançadas, integração via API ou fluxos de trabalho personalizados, consulte a documentação do ABBYY Vantage.

Recursos adicionais

REST API Documentation: Para upload de arquivos via API e recuperação de resultados
Skill Catalog: Navegue por Skills de Documento predefinidas
Suporte: Entre em contato com o suporte da ABBYY para obter assistência técnica

Resumo

Você concluiu com sucesso:

✅ Criou uma Skill de Processo no ABBYY Vantage
✅ Configurou o acesso SFTP para entrada e saída
✅ Configurou Skills de extração de documentos
✅ Conectou-se via linha de comando do SFTP
✅ Enviou documentos para processamento
✅ Baixou os resultados de extração

Seu pipeline de processamento de documentos agora está operacional e pronto para uso em produção!

Sobre

Início rápido

​Visão geral

​Etapa 1: Criar uma Skill de Processo

​Etapa 2: Configurar o workflow da Skill de Processo

​Etapa 3: Configurar a entrada via SFTP

​Configurar as definições de entrada

​Etapa 4: Configurar Output via SFTP

​Configurar as opções de saída

​Etapa 5: Configurar Skills de Extração

​Etapa 6: Publicar e obter o ID da sua Skill

​Etapa 7: Conectar ao SFTP

​Detalhes da conexão

​Conectar via Terminal

​Etapa 8: Navegar pela estrutura de pastas do SFTP

​Exibir Skills Disponíveis

​Acesse seu Skill

​Etapa 9: Enviar documentos para processamento

​Acesse a pasta de entrada

​Carregar um único arquivo

​Carregar vários arquivos

​Verificar envio

​Etapa 10: Verificar o status do processamento

​Monitorar a pasta de exceções de entrada

​Aguarde o processamento

​Etapa 11: Baixar resultados processados

​Navegue até a pasta de saída

​Compreendendo a estrutura dos resultados

​Exibir o conteúdo da pasta de resultados

​Fazer download dos resultados

​Entendendo a saída JSON

​Comandos SFTP úteis

​Solução de problemas

​Problemas de conexão

​Problemas de carregamento

​Nenhum arquivo de saída

​Erros de permissão

​Práticas recomendadas

​Segurança

​Gerenciamento de arquivos

​Monitoramento

​Otimização do fluxo de trabalho

​Próximas etapas

​Recursos adicionais

​Resumo