Versões
Publique versões de um template de IDP, escolha qual delas atende em produção e volte para uma versão anterior quando precisar.
Versões
Tudo o que você edita no template fica no rascunho. Publicar congela toda a configuração do pipeline em uma versão — documento de referência, páginas, filtros, identificação, extração, pós-processamento, validações e modelo. A aba Versões mostra o que já foi publicado e qual versão está ativa.
A versão ativa é a que atende em produção: a API e webhook, a ação de robô e a ação de agente de IA sempre executam a versão ativa, nunca o rascunho. Mudanças no rascunho só chegam a quem usa o template depois de publicadas. Veja Usar templates em automações.
Só desenvolvedores e administradores do workspace podem publicar e ativar versões.
Publicar uma versão
Clique em Publicar, no topo do template, ou em Publicar versão, na aba Versões. Alterações ainda não salvas são salvas antes, para entrarem na versão. A janela mostra a Versão atual e a Nova versão e pede:
| Campo | Obrigatório | Descrição |
|---|---|---|
| Tipo de mudança | — | Correção, Melhoria ou Mudança grande. Cada opção mostra o número resultante a partir da versão mais alta já publicada: de 1.2.0, por exemplo, vai para 1.2.1, 1.3.0 ou 2.0.0. Na primeira publicação, as opções partem de 0.0.1, 0.1.0 e 1.0.0. |
| Número da versão | Sim | Preenchido pelo tipo de mudança e editável. Use o formato semver, por exemplo 1.2.0; sufixos como 1.2.0-beta.1 também são aceitos. O número não pode repetir o de uma versão já publicada no template. |
| O que mudou | Não | Até 10.000 caracteres. Resuma o que a versão traz; o texto aparece na lista de versões. |
| Tornar esta a versão ativa | — | Ligada por padrão. Ligada, a nova versão passa a atender em produção na hora. Desligada, a versão é publicada como Arquivada e a versão ativa atual continua atendendo. |
Clique em Publicar para concluir.
Lista de versões
A aba Versões lista as versões da mais recente para a mais antiga. Cada linha mostra o número da versão, a data e hora da publicação, a descrição e o status:
| Status | Significado |
|---|---|
| Ativa | A versão que atende em produção. Há no máximo uma por template. |
| Arquivada | Uma versão publicada que não está atendendo. Pode ser ativada a qualquer momento. |
A lista não oferece edição nem exclusão de versões publicadas. Para mudar o comportamento do template, edite o rascunho e publique uma nova versão.
Voltar para uma versão anterior
Para desfazer uma publicação, clique em Ativar na linha de uma versão arquivada e confirme. Produção e a API passam a usar essa versão imediatamente, e a versão que estava ativa fica Arquivada. O rascunho não muda.
Sem versão ativa
Enquanto o template não tem uma versão ativa, ele não atende em produção. O editor mostra o aviso Nenhuma versão publicada, com o atalho Publicar versão, e:
- a API recusa as chamadas com o status
409e o erroNO_ACTIVE_VERSION. Veja API e webhook; - a ação de robô e a ação de agente de IA falham com o erro
NO_ACTIVE_VERSION.
O Playground, o Simular API e a Base de testes continuam funcionando, porque executam o rascunho. Veja Playground e Simular API.