Criando um Flowkit
Criando um Flowkit
Flowkits permitem empacotar fluxos de integração em templates reutilizáveis que outras equipes ou clientes podem ativar com poucos cliques. Ao criar um Flowkit, você define quais fluxos ele contém, quais conexões são necessárias, quais parâmetros serão solicitados na ativação e como o Flowkit será categorizado no marketplace.
Passo 1 — Acesse a criação
No menu principal, clique em Flowkits e, na tela de catálogo, clique em Novo Flowkit.
Passo 2 — Configurações gerais
Preencha as informações de identificação do Flowkit:
Passo 3 — Seleção de fluxos
Selecione os fluxos existentes no workspace que farão parte do Flowkit. Prefira agrupar fluxos relacionados a um mesmo processo, sistema ou caso de uso — isso facilita a ativação e o monitoramento por quem for consumir o Flowkit.
Passo 4 — Conexões
Defina as conexões necessárias para os conectores utilizados nos fluxos. Se as conexões ainda não existirem, você pode criá-las diretamente nesta etapa.
As conexões configuradas aqui serão solicitadas a quem ativar o Flowkit.
Passo 5 — Parâmetros
Configure os parâmetros que serão expostos para personalização durante a ativação. Para cada parâmetro, defina:
- Chave (key) — identificador usado nos fluxos como [[flowkit.params.nomeDaVariavel]]
- Tipo — string, number ou boolean
- Obrigatório — se o preenchimento deve ser exigido na ativação
- Descrição — instrução exibida para quem for ativar
Parâmetros bem definidos evitam que quem ativa o Flowkit precise editar passos manualmente.
Passo 6 — Documentação com IA
Você pode gerar documentação técnica automaticamente para o Flowkit usando IA.
Na seção Documentação, clique em Criar com IA. Um modal de confirmação informará que a IA considerará o nome e identificador do Flowkit, os fluxos incluídos, as conexões configuradas e os parâmetros definidos.
Clique em Gerar documentação e aguarde cerca de 10 segundos. A documentação será gerada em Markdown e incluirá seções como visão geral, conectores necessários, parâmetros de configuração, fluxo de dados e troubleshooting.
Você pode editar manualmente qualquer seção gerada ou importar uma documentação existente via Importar MD.
Passo 7 — Revisão e criação
Revise todas as configurações. Após confirmar, clique em Criar Flowkit. O Flowkit ficará disponível no catálogo para ativação.
Editando um Flowkit após a criação
Na tela de Flowkits, localize o card do Flowkit, clique no menu de ações ⋮ e selecione Editar Flowkit. O assistente de edição permite atualizar título, descrição, categorias e regenerar a documentação com IA.
Após as alterações, clique em Salvar.
Próximo passo
Após criar o Flowkit, defina a estratégia de versionamento para gerenciar atualizações com segurança → Versionamento para Flowkits.