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.
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.
| Campo | Obrigatório | Descrição |
|---|---|---|
| Nome | Sim | De 3 a 80 caracteres. Aparece na árvore de arquivos e em todas as telas do template. |
| Descrição | Não | Até 500 caracteres. Ajuda seus colegas a entender para que o template serve. |
| Workspace e Criar em | Sim | O workspace e a pasta onde o template é criado. A pasta padrão é a raiz. |
| Documento de referência | Recomendado | Um 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.
- 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.
- 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.
- 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.
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á:
- Monte o pipeline — páginas, filtros, identificação, extração, pós-processamento e validações. Veja Construtor.
- Teste o rascunho no Playground e no Simular API. Veja Playground e Simular API.
- Publique uma versão e deixe-a ativa. Veja Versões.
- Chame o template pela API, por um robô ou por um agente. Veja Usar templates em automações.