Módulos
Fluxos e agendamentos
Construtor visual com 13 tipos de bloco, contrato, publicação, execução e agendamento por intervalo.
Nesta página
Fluxos são automações montadas em um construtor visual. Eles conectam modelos, agentes, contextos de conhecimento e de dados e sistemas externos em processos que rodam no chat, por API ou por agendamento.
Blocos
O construtor oferece 13 tipos de bloco:
| Bloco | Função |
|---|---|
| Entrada | Recebe o payload da origem permitida: API, chat ou outro fluxo. |
| Modelo de IA | Chama diretamente um modelo permitido, com prompt e instruções. |
| IA sobre linhas | Aplica um passo de IA a muitas linhas, em lotes de até 50 linhas por chamada e até 8 chamadas simultâneas. |
| Agente | Envia o contexto do passo anterior a um agente publicado. |
| Decisão | Ramifica por campo e condição: igual, diferente, contém, maior que, menor que, existe ou expressão. |
| Transformar | Mapeia, normaliza ou enriquece campos do payload. |
| Busca no armazenamento | Recupera trechos de contextos de conhecimento, com pontuação. |
| Consulta de dados | Lê linhas de um contexto de dados com SQL. |
| Gravar dados | Grava linhas em uma tabela de um contexto de dados. |
| Carregar arquivos | Carrega planilhas ou CSVs de uma pasta do Armazenamento em uma tabela. |
| Integração | Chama uma conexão HTTP cadastrada em Integrações, com mapeamento do corpo da requisição. |
| Subfluxo | Executa outro fluxo publicado, com até 8 níveis de aninhamento. |
| Saída | Define a resposta da execução. |
Os blocos de IA podem devolver saída estruturada, validada por um JSON Schema com valores fechados, pronta para ser gravada em tabela. Também podem definir o esforço de raciocínio do modelo.
Contrato
Cada fluxo tem um contrato:
- Exposição: interno (apenas como subfluxo), API ou chat.
- Esquema de entrada e esquema de saída, em JSON Schema.
- Origens permitidas e token do endpoint, quando exposto por API. Veja API de fluxos.
Uma entrada fora do contrato faz a execução falhar e é registrada automaticamente como irregularidade de qualidade de dados.
Rascunho, publicação e arquivamento
Um fluxo nasce como rascunho, é publicado para rodar e pode ser arquivado. Só fluxos publicados executam. Os fluxos podem ser exportados e importados em JSON (formato aptabit.flow), por exemplo entre instalações.
Como um fluxo executa
| Origem | Como dispara |
|---|---|
| Chat | Fluxo com exposição chat aparece como alvo de conversa no workspace. |
| API | Fluxo com exposição API recebe POST no próprio endpoint, com token bearer. |
| Agendamento | Qualquer fluxo publicado, em intervalo fixo. |
| Subfluxo | Fluxo com exposição interna, chamado pelo bloco subfluxo de outro fluxo. |
A execução acontece no serviço da API, de forma síncrona: quem chama recebe o resultado ao fim da execução. Cada execução gera um registro com origem, status (succeeded ou failed), entrada, saída, mensagem de erro e o rastro de cada bloco: entradas, fontes recuperadas com pontuação e decisões tomadas. Uma execução que falha guarda o rastro dos blocos que chegaram a executar.
As execuções são consultadas em Configurações > Logs, junto com as demais interações.
Agendamentos
Em Agendamentos, um fluxo publicado roda sozinho:
- Intervalo em minutos, horas ou dias, com mínimo de 60 segundos.
- Entrada JSON fixa, enviada em cada execução.
- Número máximo de execuções, opcional.
- Pausa e retomada, com a próxima e a última execução visíveis.
Os agendamentos usam intervalos fixos; expressões de calendário, como "dias úteis às 9h", não estão disponíveis.
Templates de fluxo
A aba Templates traz 30 templates de fluxo em seis categorias:
| Categoria | Exemplos |
|---|---|
| Crédito e risco (8) | Análise de crédito PF e PJ, onboarding KYC, triagem PLD/AML, triagem de PEP e listas restritivas. |
| Documentos e back-office (7) | Extração de nota fiscal, extração de contrato, conciliação bancária, classificação documental. |
| Atendimento (5) | Chat de atendimento com contexto de conhecimento, triagem de tickets, resumo de atendimento. |
| Compliance e jurídico (4) | Revisão de conformidade, due diligence de fornecedor, relatório de auditoria, anonimização de dados (LGPD). |
| RH e interno (3) | Triagem de currículos, assistente de políticas internas, onboarding de colaborador. |
| Vendas e mercado (3) | Qualificação de leads, proposta comercial, análise de concorrência. |
Recursos planejados
Planejado: execução assíncrona de fluxos longos com acompanhamento de progresso, etapas de aprovação humana, webhooks de eventos com assinatura HMAC, versionamento de fluxos e ambientes separados de desenvolvimento e produção. Esses recursos não fazem parte da versão 3.7.