Recursos de IA
Documentação de fluxos com IA
10 min
objetivo o canvas da fluid conta com um agente de ia especializado capaz de gerar automaticamente a documentação técnica de qualquer fluxo com um único clique, o agente analisa a estrutura do fluxo — seus passos, conectores, templates e lógica de execução — e produz uma documentação clara e estruturada, pronta para ser compartilhada ou publicada como funciona o agente percorre todos os passos ativos do fluxo e gera uma documentação que inclui visão geral da integração, com um diagrama simplificado do fluxo de execução descrição de cada passo conector utilizado, função, configuração e próximo passo templates completos (sql/json) com explicação das variáveis utilizadas e sua origem tabela de conexões referenciadas no fluxo resumo da lógica em linguagem natural, explicando o que o fluxo faz do início ao fim o resultado é entregue diretamente no canvas, em português brasileiro, sem necessidade de nenhuma configuração adicional como usar abra o fluxo desejado no canvas clique em "ai assistant" no topo da tela aguarde alguns segundos enquanto o agente processa o fluxo a documentação gerada será exibida no painel lateral e poderá ser copiada exemplo de saída a seguir, um exemplo do tipo de documentação gerada pelo agente para um fluxo de sincronização entre omie e supabase fluxo academycezar omiesupabase descrição integração omie e supabase visão geral este fluxo sincroniza produtos do erp omie com uma base de dados supabase a lógica implementa um padrão de upsert para cada produto retornado do omie, verifica se já existe na base e decide entre atualizar ou cadastrar consulta (omie) → loop → consultaprodutobase (select) → condição ├─ true → atualiza produto base (update) └─ false → cadastra produto (insert) next → lista produto base (select) resumo da lógica busca todos os produtos do omie (paginado, 10 por página) para cada produto, verifica se já existe na base se existe → atualiza o nome do produto se não existe → insere um novo registro ao final, lista todos os registros da base para confirmação limitações desta versão nota sobre capacidade o agente de documentação possui limites de processamento que variam conforme o tamanho e a complexidade do fluxo fluxos com templates mais concisos suportam até 15 passos documentados fluxos com templates maiores ou mais complexos suportam entre 8 e 10 passos fluxos que excedam esses limites podem não ter a documentação gerada corretamente para fluxos extensos, considere documentá los em partes ou simplificar os templates antes de acionar o agente boas práticas o agente documenta apenas passos ativos — passos desconectados do fluxo são ignorados informações sensíveis, como tokens e senhas, são automaticamente omitidas da documentação gerada para fluxos maiores ou com lógica complexa, revise a documentação gerada antes de publicar a documentação reflete o estado atual do fluxo — caso o fluxo seja editado, gere novamente para manter a doc atualizada perguntas frequentes a documentação é salva automaticamente? não após a geração, você pode copiar o conteúdo ou exportá lo manualmente a documentação não é versionada junto com o fluxo nesta versão inicial o agente documenta fluxos de qualquer tamanho? sim, mas fluxos muito extensos podem levar alguns segundos a mais para serem processados a documentação gerada pode ser editada? o conteúdo gerado pode ser copiado e editado livremente em qualquer editor de texto ou diretamente no archbee