Pular para o conteúdo principal
Roberty Studio
IDPIDP

Criar template

Crie um template de IDP do zero, com nome e documento de referência, ou importe um template exportado em JSON, conferindo as conexões do workspace.

Criar template

Para criar um template, acesse a aba Arquivos do workspace, abra o menu Criar e escolha Modelo IDP — "Extrai dados de notas, formulários e PDFs". Há duas formas de começar: Do zero ou Importar arquivo.

informação

Só desenvolvedores e administradores do workspace podem criar templates de IDP. Veja Papéis e permissões.

Do zero​

Dê um nome ao template, envie um documento de exemplo e monte o pipeline no editor.

CampoObrigatórioDescrição
NomeSimDe 3 a 80 caracteres. Aparece na árvore de arquivos e em todas as telas do template.
DescriçãoNãoAté 500 caracteres. Ajuda seus colegas a entender para que o template serve.
Workspace e Criar emSimO workspace e a pasta onde o template é criado. A pasta padrão é a raiz.
Documento de referênciaRecomendadoUm PDF, PNG ou JPG de até 15 MB. É usado na identificação e como base do playground.

O documento de referência deve ser um exemplo típico do documento que o template vai receber. Sem ele, a identificação compara o documento recebido apenas pelo tipo e pelos critérios que você descrever. Ele pode ser enviado ou substituído depois, na etapa Documento do construtor. Veja Documento e páginas.

Clique em Criar modelo para concluir. O template abre em uma nova aba do editor. Se o template for criado mas o envio do documento falhar, envie-o pela etapa Documento.

Importar um template exportado​

Use esta opção para trazer um template exportado de outro workspace, ou uma cópia que você guardou. O arquivo é o JSON gerado por Exportar JSON nas configurações do template. Veja Geral.

  1. Arquivo — solte ou escolha o JSON exportado. Um arquivo que não seja a exportação de um template de IDP é recusado. O nome do template vem preenchido com o nome que está no arquivo e pode ser alterado (mínimo de 3 caracteres). Escolha também o workspace e a pasta de destino.
  2. Verificação — antes de criar, a Roberty confere se as conexões usadas no arquivo existem neste workspace e mostra em quais etapas cada uma é usada: Modelo padrão, Identificação, Extração (LLM OCR) e Pós-processamento. Para cada conexão que falta, escolha uma conexão deste workspace para substituí-la.
  3. Clique em Importar.

Você pode importar mesmo sem resolver tudo: as conexões que não pertencem a este workspace são removidas e precisam ser escolhidas depois no editor. Se não for possível verificar as conexões, a importação continua disponível do mesmo jeito.

O template importado recebe a configuração do arquivo: o pipeline completo, as validações e o modelo padrão. O documento de exemplo é copiado se você tiver acesso ao template de origem; caso contrário, envie um na etapa Documento.

aviso

O arquivo exportado pode conter credenciais usadas nas validações por API. Trate-o como um dado sensível.

Depois de criar​

Um template recém-criado já pode ser testado, mas ainda não atende chamadas de produção. Para chegar lá:

  1. Monte o pipeline — páginas, filtros, identificação, extração, pós-processamento e validações. Veja Construtor.
  2. Teste o rascunho no Playground e no Simular API. Veja Playground e Simular API.
  3. Publique uma versão e deixe-a ativa. Veja Versões.
  4. Chame o template pela API, por um robô ou por um agente. Veja Usar templates em automações.