Setor de atividade
- Administração
Automatização
Inteligência Artificial
Efeitos Centrais
- 95% de economia de tempo
- Redução significativa dos custos
- Documentação completa e consistente
- Solução escalável para futuros componentes
Impacto nos negócios
- Developers significativamente aliviados
- Documentação sempre atualizada
- Recursos para produtividade com valor acrescentado
- Automação reutilizável
Documentação automatizada de 500 módulos de processo com IA: Alta qualidade de documentação com intervenção manual mínima
A documentação regular dos componentes técnicos do processo é essencial para a manutenção, o desenvolvimento e a garantia da qualidade. No entanto, geralmente falta uma responsabilidade clara, a documentação fica rapidamente desatualizada e recursos valiosos de desenvolvimento são comprometidos, tornando esse processo muitas vezes muito demorado e intensivo em recursos.
No início de 2025, o CIB Group enfrentou o desafio de criar e manter atualizada regularmente a documentação de cerca de 500 módulos de processo CIB flow. Descubra aqui como resolvemos essa tarefa.
O desafio
A documentação manual dos 500 módulos de processo CIB flow, incluindo o controlo de qualidade, levaria cerca de 30 minutos por módulo. Calculou-se que o esforço seria de cerca de 30 dias úteis.
Além disso, há um esforço adicional, pois cada componente recém-desenvolvido também precisa ser documentado, o que aumenta ainda mais os custos totais e o tempo necessário.
Além dos custos diretos com pessoal, isso gera custos de oportunidade consideráveis, uma vez que esse tempo não pode ser investido no desenvolvimento estratégico ou no benefício do cliente.
Abordagem de Solução
Desenvolvemos um processo de documentação totalmente automatizado com base no CIB flow.
A implementação técnica baseou-se num processo iniciado automaticamente a cada dois meses, que lê os módulos de processo atuais como ficheiros JSON. Estes são processados pelo Large Language Model (LLM) Claude Sonnet 4.0. Os LLMs são modelos avançados de linguagem de IA, capazes de compreender e gerar linguagem natural. Uma temperatura baixa* de 0,0 garante respostas precisas e consistentes, enquanto o número máximo de tokens* de 4096 controla os custos.
Como resultado, o processo gera uma documentação HTML totalmente gerada com várias classes CSS para opções de layout flexíveis. Os documentos finalizados podem ser publicados imediatamente na plataforma de aprendizagem, criando um fluxo de trabalho eficiente, repetível e económico.
Melhor ainda: o processo foi criado de forma independente do modelo e pode ser adaptado a novos modelos, como Claude Opus, GPT-5.2 ou Grok 4, com apenas alguns cliques.
*A temperatura controla a criatividade da saída: um valor baixo resulta em respostas mais precisas, enquanto um valor mais alto resulta em respostas mais criativas. O número de tokens influencia o comprimento da saída, definindo o número máximo de palavras ou caracteres.
Garantia de qualidade e redução de alucinações
Como os modelos de linguagem de grande porte funcionam de forma probabilística, podem ocorrer alucinações. Para garantir a qualidade, foi integrado um pós-processamento em duas etapas:
1. Verificação determinística das regras
- Reconhecimento de padrões
- Regras de validação
- Correção automática de estruturas definidas
2. Pós-processamento baseado em LLM
- Correção de erros
- Melhoria estrutural
- Verificação de consistência
Com a utilização do CIB flow e de Large Language Models baseados em IA, foi possível automatizar completamente a documentação de 500 módulos de processo em poucas horas – com custos mínimos.
Destaques do processo
Através da implementação de um processo de automatização baseado em IA com base no CIB flow e em Large Language Models (LLMs), foi possível:
- Reduzir o tempo necessário para criar a documentação em mais de 95%
- Criar a documentação de forma totalmente automatizada em menos de 5 horas
- Os custos da criação da documentação foram reduzidos para apenas 15 € no total
- Foi estabelecida uma solução consistente, escalável e fácil de manter.
Alta qualidade da documentação com intervenção manual mínima
O projeto mostra de forma convincente como a automação inteligente de processos:
- Aumenta significativamente a eficiência
- Reduz drasticamente os custos
- Qualidade melhorada
- Dívidas técnicas reduzidas
- Oferece escalabilidade sustentável
