Docs do Nodaro
DocumentaçãoReferência de nósModelosAgentes de IA (MCP)DesenvolvedoresSelf-hostingPesquisa
Guias

Importação e exportação

Exporte um workflow em um único arquivo JSON, com ou sem personagens, objetos e locais, e importe em outra conta, projeto ou instalação self-hosted.

Um workflow viaja como um único arquivo JSON. Você o exporta do editor e o importa em qualquer lugar: em outra conta, em outro projeto ou em uma instalação self-hosted. O arquivo pode levar os personagens, objetos e locais que o workflow usa. A importação copia as mídias que consegue acessar, para que a cópia funcione de forma independente.

Exportar um workflow

Salve o workflow

A exportação lê a versão salva do workflow, não o que está no canvas. Salve primeiro.

Escolha Exportar

Na barra de ferramentas do editor, abra Exportar e escolha o que o arquivo deve conter.

OpçãoO que vai no arquivo
Com mídiasO workflow, mais os personagens, objetos e locais que ele usa
Somente templateSó o workflow, sem resultados e sem outros conteúdos de execução

Compartilhe o arquivo

Envie o arquivo ou guarde-o como backup. Se o workflow usa mídias que só a sua instalação consegue servir, como arquivos em um servidor privado, a exportação avisa. Envie essas mídias para um lugar público antes de compartilhar o arquivo, ou conte com a necessidade de novas entradas nesses nós.

Importar um workflow

Na página inicial. Clique em Importar JSON, ao lado de “Continue de onde parou”, e escolha um arquivo. O Nodaro cria o workflow e o abre. Ele vai para o seu projeto padrão, Meus workflows recentes, que é criado na primeira vez em que algo precisa dele.

No editor. Abra Importar na barra de ferramentas. Escolha De um arquivo ou Da área de transferência e depois uma de duas opções:

OpçãoO que acontece
Importar como novoUm novo workflow, como o botão da página inicial
Adicionar ao atualOs nós importados são adicionados ao canvas aberto, à direita do que já está lá

Todo workflow importado recebe o nome do arquivo com (Imported) no fim, para que uma cópia nunca pareça o original. Os dois caminhos aceitam uma exportação normal e o formato de tutorial.

O que é transferido

Parte do workflowO que acontece na importação
Personagens, objetos e locaisEm um arquivo Com mídias, eles são criados de novo na sua conta, e os nós apontam para as suas novas cópias.
Mídias que a nova instalação consegue acessarAs imagens, os vídeos e os áudios são copiados para o armazenamento da nova instalação, então o workflow deixa de depender do original. A mensagem de sucesso diz quantos arquivos foram copiados.
Mídias que a nova instalação não consegue acessarContinuam apontando para onde estavam. A importação avisa e indica os nós, que não serão executados até você enviar os arquivos de novo.
Entidades que não cabem no seu armazenamentoO workflow é importado mesmo assim, e a importação indica as entidades que não conseguiu criar. Os nós que as usam as mostram como ausentes.
Credenciais salvasNunca são exportadas. Um nó Saída de webhook (Webhook Output) chega sem a credencial dele, e você escolhe a sua.
AgendamentosUm nó Gatilho agendado (Schedule Trigger) importado sempre começa pausado. Ative-o quando estiver pronto.
Trechos e configurações de seletoresSão transferidos como estão. Um trecho é texto simples no prompt, e um seletor mantém o modo Completo ou Compacto.

Workflows compartilhados são exportados sem as entidades. Você pode exportar um workflow que alguém compartilhou com você. Nesse caso, o arquivo vem sem os personagens e os locais por trás dele. Ter permissão para ler um workflow não dá a você as entidades dele.

Mover um workflow entre o Nodaro Cloud e uma instalação self-hosted

O mesmo arquivo funciona nas duas direções:

  1. Exporte o workflow com a opção Com mídias na instalação antiga.
  2. Importe-o na nova instalação com Importar JSON.
  3. Leia a mensagem da importação. Envie de novo as mídias que ela não conseguiu acessar.
  4. Em uma instalação self-hosted, confira se os modelos que o workflow usa estão disponíveis pelas suas chaves de provedor ou por uma conexão com o Nodaro Cloud.
  5. Escolha de novo as credenciais nos nós Saída de webhook e ative os agendamentos que devem ser executados.

Importar e exportar por código

A API REST importa os mesmos arquivos com POST /v1/workflows/import, enviando o conteúdo do arquivo como workflow_json. A resposta inclui o novo workflow e um relatório da importação: quantos arquivos de mídia foram copiados, quais estavam inacessíveis e quais foram ignorados. O SDK chama o mesmo endpoint com client.workflows.import(...), e os assistentes conectados por MCP também podem exportar e importar workflows. Veja a API de workflows.

Perguntas frequentes

Última atualização

Nesta página