NodaroAccount
Docs do Nodaro
DocumentaçãoReferência de nósModelosTemplatesAgentes de IA (MCP)DesenvolvedoresAuto-hospedagemPesquisaComparações
Referência das ferramentas

Projetos e workflows

Deixe um assistente de IA montar workflows do Nodaro em JSON, editá-los com verificação de versão, exportá-los, importá-los e executá-los no projeto mcp.

As ferramentas de projetos e workflows permitem que um assistente monte workflows do Nodaro do jeito que o editor os armazena: como nós e conexões em JSON. O assistente aprende o formato com start_workflow_editor e get_node_skill, cria e edita workflows, move-os entre projetos com exportação e importação e os executa. Todo workflow que ele cria ou edita fica no projeto mcp, então os seus próprios projetos continuam intactos. As ferramentas de sessão leem e organizam as sessões de criação dentro dos seus projetos.

Uma sessão típica

Aprenda o formato

Chame start_workflow_editor. A ferramenta retorna a estrutura JSON do workflow, as regras para ligar as conexões e o catálogo de tipos de nó. Chame get_node_skill para cada tipo de nó de que o workflow precisa e get_picker_catalog para os valores válidos de cada seletor.

Crie o workflow

Chame create_workflow com um nome e, se quiser, os primeiros nós e conexões. O workflow abre no editor, em Workflows MCP.

Edite com segurança

Leia o grafo atual com get_workflow_json e depois envie um delta para update_workflow_json com a versão que você leu. Só mudam os nós e as conexões que você indicar.

Execute

Chame run_workflow e acompanhe a execução com get_app_run. O resultado de cada nó é salvo na sua biblioteca.

start_workflow_editor

Retorna o guia que um assistente lê antes de montar ou editar um workflow. O guia cobre a estrutura JSON do workflow, as convenções de ligação de conexões e entradas e as regras de update_workflow_json. Também lista os campos de resultado de cada nó de geração e o catálogo de tipos de nó.

Permissão: nenhuma, sempre visível. Créditos: grátis.

Esta ferramenta não tem parâmetros. Ela não altera nada e pode ser chamada quantas vezes você quiser.

get_node_skill

Retorna o guia completo de um tipo de nó: os campos de dados com os valores padrão, quando usá-lo, erros comuns e um exemplo completo em JSON. Use-a antes de escrever um nó desse tipo num workflow.

O custo em créditos no guia é o preço de tabela do nó. Para o preço cobrado por uma execução, use list_models ou GET /v1/nodes.

Permissão: nenhuma, sempre visível. Créditos: grátis.

ParâmetroTipoObservações
node_typestringObrigatório. O tipo de nó em kebab case, como listado por start_workflow_editor, por exemplo generate-image, list ou trim-video.

Retorna: o guia do nó. Um tipo desconhecido retorna um erro com a lista de tipos válidos.

get_picker_catalog

Retorna os valores válidos de um nó seletor, como Cenário, Clima, Pessoa ou Lente. Os seletores acrescentam uma frase ao prompt do nó que alimentam, então um workflow precisa usar um ID real do catálogo. Chame esta ferramenta antes de escrever o valor de um seletor num workflow.

Permissão: nenhuma, sempre visível. Créditos: grátis.

ParâmetroTipoObservações
node_typestringO tipo do seletor em kebab case, por exemplo setting. Omita-o para listar todos os seletores.
detailstringcompact (padrão): id, label, category, term, icon e imageUrl. full também acrescenta a description e o promptHint de cada opção, a frase completa que ela adiciona ao prompt.
categorystringPara seletores de uma dimensão: só as opções de uma categoria.
fieldstringSó uma dimensão de um seletor de várias dimensões, como Pessoa, Figurino e beleza ou Enquadramento. Também as configurações extras de um seletor de uma dimensão, como a posição, a duração e a intensidade de Transição e Efeitos de personagem, ou a posição e o ritmo de Movimento de personagem.

Retorna: sem node_type, um diretório de todos os seletores com nodeType, label, kind (single ou multi), o campo ou os campos de valor, optionCount e imageCount. Com node_type, as opções desse seletor. Um tipo desconhecido retorna um erro com os tipos válidos.

Cada opção traz um term, a frase curta e profissional a escrever no prompt, como whip pan left. label serve só para exibição. Uma opção sem efeito, como auto ou none, tem o term vazio. As opções com imagem trazem um imageUrl absoluto: mostre-o como está e nunca monte um a partir de um ID. Pessoa e Figurino e beleza também retornam sections, os tópicos deles em ordem, cada um com um rótulo, os campos e uma imagem opcional.

{
  "nodeType": "person",
  "sections": [
    { "label": "Identity", "fields": ["type", "age", "ethnicity", "regionalAesthetic"],
      "imageUrl": "https://app.nodaro.ai/picker-art/character/sections/identity.2d5ec1a4.webp" }
  ],
  "dimensions": [
    { "field": "type", "label": "Type", "options": [
      { "id": "man", "label": "Man", "term": "man",
        "imageUrl": "https://app.nodaro.ai/picker-art/character/person/man.d6bed999.webp" }
    ] }
  ]
}

As imagens dos seletores de look só são retornadas no Nodaro Cloud. Em uma implantação que mostra as próprias imagens, o imageUrl de uma opção é a imagem da implantação, no próprio host de mídia dela. Só as opções a que ela deu uma imagem têm uma, e nenhum tópico tem. A ferramenta deixa de fora a imagem ampliada, imageLargeUrl. Catálogos de seletores cobre os mesmos dados para desenvolvedores.

list_projects

Lista todos os projetos da sua conta, ordenados por nome, com o ID, o nome, a descrição, o número de workflows e a data de criação de cada um. O assistente pode ler todos os seus projetos, mas só edita o projeto mcp.

Permissão: workflows:read. Créditos: grátis.

Esta ferramenta não tem parâmetros.

Retorna: data, a lista de projetos.

get_project

Retorna um projeto pelo ID ou pelo nome.

Permissão: workflows:read. Créditos: grátis.

ParâmetroTipoObservações
project_idstringObrigatório. Um ID de projeto ou um nome de projeto. O nome precisa ser idêntico, inclusive nas maiúsculas, por exemplo My Feature Film.

Retorna: o ID, o nome, a descrição, o número de workflows e a data de criação do projeto.

list_workflows

Lista os workflows do projeto mcp, dos mais recentes para os mais antigos.

Permissão: workflows:read. Créditos: grátis.

ParâmetroTipoObservações
limitintegerDe 1 a 100. Padrão: 20.
cursorstringO next_cursor da página anterior.
include_sub_workflowsbooleanPadrão: false, que oculta os sub-workflows que pertencem a outro workflow, como faz a visualização de projeto do editor. Passe true para listá-los também.

Retorna: data, com o ID, o nome, a descrição, a versão, a miniatura, as datas e o editorUrl de cada workflow, e next_cursor. Um next_cursor igual a null indica a última página.

get_workflow

Retorna os detalhes de um workflow do projeto mcp: o nome, a descrição, a versão e as datas.

Permissão: workflows:read. Créditos: grátis.

ParâmetroTipoObservações
workflow_idstringObrigatório. Um ID de workflow do projeto mcp.

Retorna: o workflow, com o editorUrl dele.

get_workflow_json

Retorna o grafo completo de um workflow do projeto mcp: os nós, as conexões, as configurações, o nome, updated_at e version.

Permissão: workflows:read. Créditos: grátis.

ParâmetroTipoObservações
workflow_idstringObrigatório. Um ID de workflow do projeto mcp.

Retorna: o grafo e o editorUrl do workflow. Guarde version e envie-o de volta com a sua próxima alteração, para que a alteração falhe em vez de sobrescrever a edição de outra pessoa.

create_workflow

Cria um workflow no projeto mcp, vazio ou com um grafo inicial.

Permissão: workflows:write. Créditos: grátis.

ParâmetroTipoObservações
namestringObrigatório. De 1 a 200 caracteres.
descriptionstringAté 2.000 caracteres.
nodesarrayOs primeiros nós, no formato de nó do editor.
edgesarrayAs primeiras conexões.
settingsobjectAs configurações do workflow.

Retorna: o id, o name e o editorUrl do novo workflow. O editorUrl é o link que abre o workflow no editor da implantação à qual você está conectado. Compartilhe o link exatamente como ele é retornado. As configurações que um modelo não aceita são corrigidas, e as conexões são verificadas, como descrito em update_workflow_json.

update_workflow_json

Altera um workflow do projeto mcp: o grafo, as configurações ou a miniatura. Todos os campos, exceto workflow_id, são opcionais; assim, você pode, por exemplo, trocar só a miniatura.

Permissão: workflows:write. Créditos: grátis.

ParâmetroTipoObservações
workflow_idstringObrigatório. Um ID de workflow do projeto mcp.
deltaobjectUma alteração parcial, aplicada em uma única etapa sobre delta.base_version. É a forma preferida de editar. Veja abaixo.
nodesarraySubstitui todos os nós. Envie junto com edges.
edgesarraySubstitui todas as conexões. Envie junto com nodes.
settingsobjectSubstitui as configurações do workflow por inteiro. Uma chave armazenada que pertence a outro gravador precisa voltar sem mudanças. Veja Chaves de configuração de outro gravador.
thumbnail_urlstring or nullA URL de uma imagem que já está hospedada, ou null para remover a miniatura.
expected_versionintegerO version de get_workflow_json. A alteração é recusada se o workflow tiver mudado desde então.
expected_updated_atstringO updated_at de get_workflow_json, uma forma mais antiga de fazer a mesma verificação. Prefira expected_version.

Retorna: uma confirmação com o número de nós e o editorUrl do workflow, e a lista das configurações que o Nodaro corrigiu, se houver.

Editar com um delta

Um delta indica só o que muda, pelo ID. Ele não pode ser combinado com nodes, edges, settings, thumbnail_url nem com os campos expected_.

Campo do deltaO que faz
base_versionObrigatório. O version de get_workflow_json. A alteração é recusada se o workflow tiver mudado desde então.
upsert_nodesNós inteiros a adicionar ou substituir, identificados pelo ID.
delete_node_idsNós a remover. As conexões deles também são removidas.
upsert_edgesConexões inteiras a adicionar ou substituir, identificadas pelo ID.
delete_edge_idsConexões a remover.
setUm novo name, ou settings mescladas chave por chave: uma chave que você envia substitui a armazenada, e uma chave que você deixa de fora continua.

Prefira um delta a enviar o grafo inteiro. Uma gravação completa baseada numa cópia antiga apaga as alterações que outra sessão fez nesse meio-tempo.

Conexões que o Nodaro verifica

Toda gravação verifica as conexões: create_workflow, update_workflow_json e import_workflow, incluindo as upsert_edges de um delta. As conexões de um delta são verificadas em relação ao grafo que o delta deixa.

  • Um nome antigo de entrada ou de saída passa para o nome atual. Por exemplo, out em um nó Feed de canal do Telegram vira text.
  • Uma conexão sem id recebe um.
  • Uma conexão que não pode funcionar é descartada. Ela pode indicar um nó que não existe, conectar um nó a ele mesmo ou não ter uma das pontas. A mesma conexão enviada duas vezes sem id também é descartada. Uma lista de edição (EDL) conectada a uma entrada de transcrição também é descartada, assim como uma transcrição conectada a uma entrada edl.
  • Um nome de entrada ou de saída que o nó não tem é armazenado como foi enviado, com um aviso. O canvas só desenha uma conexão em uma entrada ou saída que o nó mostra, então leia os nomes de cada nó em get_node_skill.

A resposta lista cada alteração. O resultado estruturado traz as alterações em edgeAdjustments e os avisos em edgeWarnings. Duas conexões com o mesmo id recusam a gravação inteira, e nada é armazenado.

Um nó novo começa num modelo que a implantação oferece

Numa implantação que restringe modelos, create_workflow, update_workflow_json e import_workflow conferem cada nó novo no workflow. Quando o nó não indica um modelo e o modelo padrão dele não é oferecido, ele é gravado no primeiro modelo do menu do editor que a sua conta pode executar, como o editor faz com um nó novo.

  • Um modelo que você indica é mantido. Uma execução o recusa onde ele não é oferecido.
  • Um nó que o workflow já tem mantém o modelo dele.
  • Cada troca é listada na resposta e em structuredContent.modelMoves, com nodeId, type, field, from e to.

Uma implantação que não restringe modelos armazena cada nó como foi enviado.

Quando o workflow mudou nesse meio-tempo

Com expected_version, expected_updated_at ou um delta, um workflow que mudou desde a sua leitura retorna um conflito: “Workflow was modified since you last read it. Fetch the latest JSON with get_workflow_json and retry.” Leia-o de novo e repita a alteração. Sem esses campos, a gravação sobrescreve o workflow incondicionalmente.

Configurações que um modelo não aceita

Os nós de imagem recebem configurações específicas de cada modelo, como aspectRatio, resolution e quality, e cada modelo permite valores diferentes. Quando um nó pede um valor que o modelo dele não aceita, o Nodaro não recusa a gravação. Ele troca o valor por um que o modelo aceita, ou o remove quando o modelo não tem essa configuração, e a resposta lista cada alteração:

Updated workflow 4f0c… (12 nodes).

Adjusted 2 parameter(s) the selected model does not accept:
  - node_8 (gpt-image): aspectRatio "16:9" → "1:1" — GPT Image 1.5 does not
    support aspect_ratio "16:9". Supported: 1:1, 3:2, 2:3.
  - node_8 (gpt-image): resolution "2K" → removed — GPT Image 1.5 has no
    resolution setting.

O resultado estruturado traz a mesma lista em adjustments. O valor armazenado não é o que você enviou, então não envie o valor original de novo. Confira os valores permitidos de cada modelo com list_models ou escolha um modelo que aceite o que você precisa. create_workflow e import_workflow corrigem as configurações da mesma forma. Um nó configurado com vários modelos ao mesmo tempo fica como está.

Um valor é mantido em vez de corrigido: aspectRatio: "auto" em um nó Gerar imagem, Imagem para imagem, Modificar imagem ou Editar imagem. Automático mantém o formato da sua foto. Quando o workflow é executado, um modelo cuja própria configuração auto mantém o formato a recebe. Qualquer outro modelo usa a proporção aceita mais próxima da foto, e o GPT Image 2.6 também, porque o auto dele renderiza um quadrado em retrato. Em um nó Gerar imagem, a foto é a primeira imagem que o nó envia ao modelo: uma imagem de inpaint ou de refinamento; caso contrário, a primeira imagem de referência. Sem foto conectada, auto resulta no formato padrão do modelo: o auto do próprio modelo, quando ele tem um; caso contrário, a primeira proporção listada.

O tipo de tarefa de referência do Seedance de um nó de vídeo, referenceTaskType em um nó generate-video, image-to-video, text-to-video ou video-to-video, só é mantido enquanto um modelo que o nó executa lista o valor. Hoje esses modelos são o Seedance 2.5 e o Seedance 2.5 Flash, e list_models lista os valores como referenceTaskTypes. Em um nó com vários modelos, basta um deles. Caso contrário, a chave é removida e listada em adjustments, para que o valor não fique esperando sem uso em outro modelo e passe a valer depois. auto, e qualquer valor que nenhum modelo lista, também é removido: Automático significa que a chave não está definida. Um nó que não indica modelo é avaliado pelo modelo que ele executa por padrão.

Texto antes e depois do prompt

O data de qualquer nó de IA pode trazer promptPrefix e promptSuffix, textos que o Nodaro adiciona antes e depois do prompt do nó quando ele é executado. Veja Texto antes e depois do prompt.

Chaves de configuração de outro gravador

As settings de um workflow são compartilhadas por vários gravadores, e settings no corpo inteiro as substituem por completo. Três chaves armazenadas não são suas para mudar:

  • settings.studio: um workflow com ela é uma produção do Studio, e as tomadas, os resultados e o plano ficam nela. Para alterar uma produção, use as ferramentas de produção do Studio.
  • settings.mcpConversation: um workflow que um assistente criou pelo MCP. Ela registra qual chat criou o workflow e até onde ele chegou. O Nodaro a lê para continuar o chat e para listá-lo. Veja Conversas do MCP viram workflows.
  • settings.mcpHub: o marcador de mês do hub ao qual pertencem as conversas de um mês.

settings no corpo inteiro que mudem ou descartem uma dessas chaves são recusadas. Copie-as sem mudanças de get_workflow_json, ou omita settings. settings no corpo inteiro são sempre gravadas contra a versão em que foram lidas, e o seu próprio expected_version ou expected_updated_at só restringe a correspondência. Um workflow que mudou nesse meio-tempo retorna o mesmo conflito de um expected_version desatualizado: o registro de conversa de um assistente muda a cada etapa. Leia o workflow de novo e tente outra vez.

delta.set.settings é mesclado chave por chave, então uma chave que você deixa de fora continua. Ali, só é recusada uma chave protegida enviada com mudança, ou enviada como null.

delete_workflow

Exclui um workflow do projeto mcp. A exclusão é permanente.

Permissão: workflows:write. Créditos: grátis.

ParâmetroTipoObservações
workflow_idstringObrigatório. Um ID de workflow do projeto mcp.

Retorna: uma confirmação, ou um erro quando o workflow não está no projeto mcp.

export_workflow

Exporta qualquer um dos seus workflows, de qualquer projeto, como um pacote JSON portátil. É a única ferramenta de workflow que não se limita ao projeto mcp.

Permissão: workflows:read. Créditos: grátis.

ParâmetroTipoObservações
workflow_idstringObrigatório. Qualquer um dos seus workflows.
with_assetsbooleanPadrão: false. true também inclui no pacote os personagens, objetos e locais que o workflow usa.

Retorna: o pacote como uma string JSON. Passe a string inteira para import_workflow.

ModoO que o pacote contémPara que usar
Template, with_assets: falseO grafo, sem o conteúdo específico das entidadesCompartilhar a estrutura de um workflow como um template reutilizável
Completo, with_assets: trueO grafo e todos os personagens, objetos e locais que ele usaLevar uma produção completa para outra conta ou instância

Quando um nó usa uma mídia que outra instância não consegue baixar, como um arquivo no armazenamento local de uma instalação auto-hospedada, o pacote a lista em portability.unreachableMedia, com o nó, o campo e a URL. O pacote ainda pode ser importado, mas esses nós não são executados em outro lugar até que a mídia seja enviada de novo.

import_workflow

Importa um pacote de export_workflow para o projeto mcp.

Permissão: workflows:write. Créditos: grátis.

ParâmetroTipoObservações
workflow_jsonstringObrigatório. A string JSON inteira de export_workflow.

Retorna: o id, o name e o editorUrl do novo workflow e um importReport que diz quais mídias foram copiadas, quais ficaram como estavam e quais foram ignoradas.

  • As mídias são copiadas. As mídias de outros hosts são copiadas para esta instância quando podem ser acessadas, e o workflow é executado a partir das cópias. Os limites são 25 arquivos para o grafo e mais 25 para as entidades do pacote, com imagens de até 20 MB e vídeos ou áudios de até 50 MB. As mídias num host privado que esta instância não consegue acessar ficam como estão e são listadas como unreachable.
  • As entidades são recriadas. Os personagens, objetos, criaturas e locais do pacote são criados de novo na sua conta, com novos IDs. Os nós de entidade e cada menção com @ no grafo ou nas configurações apontam para as novas cópias, e assetIdMap relaciona cada ID antigo ao novo.
  • As cópias contam no seu armazenamento. As imagens das entidades do pacote são copiadas para o seu próprio armazenamento. Quando o armazenamento está cheio, assetsSkipped indica as entidades que não foram criadas; o workflow é importado mesmo assim.

run_workflow

Executa um workflow do projeto mcp, exatamente como uma execução no editor.

Permissão: workflows:execute. Créditos: os créditos de cada nó executado, aos mesmos preços do editor.

ParâmetroTipoObservações
workflow_idstringObrigatório. Um ID de workflow do projeto mcp.
inputsobjectAlterações para esta execução, indexadas pelo ID do nó. Um valor simples, como "blue car", vai para o campo de entrada principal do nó. Um objeto, como { "prompt": "..." }, define campos pelo nome.
client_request_idstringUm token de nova tentativa: de 8 a 128 caracteres entre letras, dígitos e _ - . :. Reutilize-o ao repetir uma chamada que expirou, para que a execução não seja iniciada nem cobrada duas vezes. Use um valor novo para uma nova execução.
continue_from_execution_idstringUma execução sua deste workflow a continuar: uma execução que falhou, com from_failed: true, ou uma execução concluída, com node_ids. Um dos dois é obrigatório com ele.
from_failedbooleanCom continue_from_execution_id: executa só os nós que essa execução não concluiu, mais cada nó em node_ids que nenhuma execução da cadeia executou.
node_idsarrayExecuta só estes nós. Com from_failed, os nós a considerar (por padrão, os nós em que a primeira execução foi iniciada, mais cada nó que ficou com falha ou foi segurado). Todo ID conta como indicado: um nó de trabalho que nenhuma execução da cadeia executou é executado e cobrado. Um nó de fonte, gatilho, seletor ou contêiner mantém o que a execução repassou, e um nó pulado nunca é executado. Só com continue_from_execution_id, os nós que a continuação executa. Omita o campo em vez de enviar uma lista vazia.

Retorna: executionId, name e editorUrl, que abre o workflow, onde a execução aparece ao vivo. O executionId é o ID de uma execução, não de uma tarefa, então get_job não o encontra. Acompanhe a execução com get_app_run ou explique uma falha com diagnose_run. Os clientes com MCP Apps mostram o progresso da execução num cartão.

Os resultados chegam ao canvas do workflow como os de uma execução iniciada no editor. Enquanto o workflow está aberto no editor, eles aparecem em cerca de 10 segundos. Caso contrário, aparecem na próxima vez que você o abrir, a menos que você tenha executado algo no editor desde então. A execução também aparece na aba Execuções.

Continuar uma execução que falhou

Uma execução de um workflow salvo que falhou pode ser continuada de onde parou: run_workflow({ workflow_id, continue_from_execution_id: "<the failed run>", from_failed: true }). Os nós que a execução concluiu repassam as saídas e nunca são executados nem cobrados de novo. Um nó que falhou é executado de novo por inteiro, com todos os itens da lista. get_app_run e diagnose_run trazem essa chamada como resumeHint em uma execução que falhou e que run_workflow pode continuar. Uma execução de app é continuada com retry_app_run, e um nó de caso de uso, com continue_use_case.

  • Uma execução cuja continuação mais recente falhou é recusada com continuation_superseded, e o erro indica a continuação a continuar no lugar dela. Quando essa continuação concluiu tudo, o erro indica onde estão os resultados dela.
  • Quando a continuação mais recente parou em uma revisão de prévia, a execução é recusada com continuation_preview_pending. Depois que o usuário a revisa, chame render_final nessa continuação para uma renderização única. Para várias renderizações ou uma revisão do Enxugar episódio, o erro traz a chamada de run_workflow que as conclui.
  • Uma execução sem nada restante é recusada com continuation_subset_required. Uma continuação que seus créditos não cobrem é recusada com insufficient_credits antes de começar.

Veja Continuar uma execução que falhou para todas as regras.

render_final

Renderiza a versão final de uma renderização do Aplicar EDL que gerou uma Prévia, depois que você a revisou. É o botão Renderização final do editor. Ele executa a renderização em Final só nesta execução e depois cada nó que vem depois dela. O nó mantém a sua própria Qualidade.

Permissão: workflows:execute. Créditos: os créditos de cada nó executado, na tarifa da versão final.

ParâmetroTipoObservações
workflow_idstringObrigatório. Um ID de workflow do projeto mcp.
render_node_idstringObrigatório. O nó de renderização Aplicar EDL a finalizar.
execution_idstringObrigatório. A execução que gerou a Prévia: uma execução concluída sua deste workflow.
confirmbooleanOmita-o para receber só o preço. Defina true para iniciar a execução, depois que o usuário aceitar o preço.
client_request_idstringUm token de nova tentativa, como em run_workflow.

O Nodaro decide quais nós são executados, pela mesma regra do editor. O Plano de edição não é executado de novo: a renderização lê o plano dele com a sua revisão aplicada. Uma Troca de câmeras entre o Plano de edição e a renderização é executada de novo primeiro. Cada nó que não é executado repassa o que a execução anterior produziu.

Retorna: sem confirm, uma cotação, e nada é executado. A cotação lista os nós executados (nodeIds), a alteração com que a execução roda (inputOverrides), os créditos estimados (estimatedCredits), se os seus créditos os cobrem (sufficient) e os seus créditos disponíveis (available). Quando os seus créditos não cobrem a execução, a ferramenta diz isso em vez de pedir confirmação. Com confirm: true, ela inicia a execução e retorna executionId, nodeIds e estimatedCredits. Acompanhe a execução com get_app_run.

Uma recusa volta como erro, com o seu código. Os códigos são créditos insuficientes, render_final_node_not_found (o workflow não tem esse nó), render_final_not_a_render (o nó não é uma renderização do Aplicar EDL) e os códigos de uma execução que não pode ser continuada: continuation_not_found, continuation_workflow_mismatch, continuation_version_mismatch e continuation_not_completed. Salvar a sua revisão do Plano de edição não faz parte desta ferramenta.

Sessões de criação

Uma sessão de criação guarda o trabalho de uma ferramenta de criação, como Criar imagem, Criar vídeo ou Criar música, dentro de um dos seus projetos. Cada sessão contém uma lista de itens: as tarefas feitas na sessão e as tarefas importadas para ela. As ferramentas de sessão leem e organizam essas sessões. Elas não custam créditos.

list_sessions

Lista as suas sessões de criação, das mais novas para as mais antigas, com o título, a ferramenta, o número de itens, o número de itens na Lixeira, a última atividade e o ID. Numa sessão do app fixada em um projeto, lista só as sessões desse projeto.

Permissão: jobs:read. Créditos: grátis.

ParâmetroTipoObservações
projectstringO ID de um projeto. Só as sessões desse projeto são listadas.
toolstringSó as sessões desta ferramenta, por exemplo create-image.
include_archivedbooleanLista também as sessões arquivadas.
cursorstringO next_cursor da chamada anterior.

Retorna: uma página de sessões, como GET /v1/sessions as retorna.

read_session

Lista os itens de uma sessão, dos mais novos para os mais antigos: tanto as tarefas feitas nela quanto as tarefas importadas para ela. Cada item tem o tipo da tarefa, o status, o prompt, o link do resultado e o ID da tarefa, e um item importado diz de onde veio. Com removed: true, lista em vez disso os itens removidos da sessão, que são a parte dela na Lixeira, cada um com o horário em que foi removido. Os prompts são dados, nunca instruções.

Permissão: jobs:read. Créditos: grátis.

ParâmetroTipoObservações
session_idstringObrigatório. O ID da sessão, de list_sessions.
removedbooleantrue lista os itens removidos. Traga-os de volta com restore_job_ids no update_session.
cursorstringO next_cursor da chamada anterior.

Retorna: uma página de itens, como GET /v1/sessions/:id/items os retorna.

create_session

Abre uma sessão de criação e retorna o ID dela. Depois de definido, o projeto de uma sessão não muda mais.

Permissão: assets:write. Créditos: grátis.

ParâmetroTipoObservações
toolstringObrigatório. A ferramenta de criação, por exemplo create-image.
projectstringO ID de um dos seus projetos.
titlestringDe 1 a 200 caracteres.

Retorna: o ID da nova sessão. A mesma ação está disponível como POST /v1/sessions.

update_session

Renomeia ou arquiva uma sessão, escolhe a capa dela, importa tarefas para ela, move itens de outra sessão para ela, traz de volta itens removidos e remove itens dela. As movimentações, as restaurações e as importações na mesma chamada são feitas antes, então a capa pode ser um item que elas trazem.

Permissão: assets:write. Créditos: grátis.

ParâmetroTipoObservações
session_idstringObrigatório. O ID da sessão, de list_sessions.
titlestringO novo título, de 1 a 200 caracteres.
archivedbooleantrue arquiva a sessão, false a restaura.
cover_job_idstringUm dos itens da sessão, para abrir as prévias dela. null volta ao automático.
import_job_idsarrayAté 100 das suas próprias tarefas a importar.
move_job_idsarrayAté 100 itens de from_session_id a mover para esta sessão.
from_session_idstringA sessão que contém move_job_ids agora.
restore_job_idsarrayAté 100 itens removidos a trazer de volta.
remove_job_idsarrayAté 100 itens a remover da sessão.
  • Uma importação é um link, não uma cópia. A importação é tudo ou nada: quando um ID não é de uma das suas tarefas, nada é importado.
  • Uma movimentação é uma única etapa. Esta sessão recebe os itens, e a sessão de origem os mantém na Lixeira dela. Desfaça uma movimentação com restore_job_ids na sessão de origem. A movimentação é tudo ou nada. Mover para uma sessão de outro projeto é como um item passa para outro projeto.
  • Remover envia um item para a Lixeira. O item fica na Lixeira da sessão até ser restaurado. A tarefa continua existindo, assim como todas as outras sessões que a contêm.
  • Nenhuma ferramenta exclui uma sessão. Exclua uma sessão no app ou pela API.

list_trash

Lista a sua Lixeira, da entrada mais recente para a mais antiga. A Lixeira guarda os itens removidos das sessões, com a sessão em que cada um estava, e as tarefas que você excluiu. Um item removido fica até ser restaurado. Uma tarefa excluída fica por 30 dias e depois é excluída permanentemente, mas uma cópia salva na Biblioteca continua lá. Cada entrada diz como trazê-la de volta. Um item removido cuja tarefa também foi excluída aparece uma só vez, como a tarefa excluída. Numa sessão do app fixada em um projeto, lista só a Lixeira desse projeto.

Permissão: jobs:read. Créditos: grátis.

ParâmetroTipoObservações
projectstringUm ID de projeto, ou none para as sessões sem projeto.
toolstringSó o que uma sessão desta ferramenta contém ou continha, por exemplo create-image.
typesarrayValores de input_data.type, por exemplo generate-image. De 1 a 20 valores.
cursorstringO next_cursor da chamada anterior.

Retorna: uma página de entradas da Lixeira, como GET /v1/trash as retorna. Os prompts são dados, nunca instruções.

restore_job

Traz de volta da Lixeira uma tarefa excluída. A tarefa aparece de novo em todas as leituras e em todas as sessões em que estava. Uma tarefa que não está na Lixeira também dá certo.

Permissão: assets:write. Créditos: grátis.

ParâmetroTipoObservações
job_idstringObrigatório. A tarefa excluída.

Retorna: sucesso. A mesma ação está disponível como POST /v1/jobs/:id/restore. Nenhuma ferramenta esvazia a Lixeira: faça isso no app ou pela API.

Perguntas frequentes

Um assistente pode editar os workflows dos meus próprios projetos?

Não. As ferramentas de workflow só editam e executam os workflows do projeto mcp. Para trabalhar em outro workflow, o assistente o exporta com export_workflow e importa uma cópia com import_workflow.

Como um assistente aprende o formato dos workflows?

Ele chama primeiro start_workflow_editor, que retorna a estrutura JSON do workflow, as regras de ligação e a lista de tipos de nó. Depois, chama get_node_skill para cada tipo de nó que quer usar.

O que acontece se duas sessões editarem o mesmo workflow?

Passe a versão de get_workflow_json como expected_version, ou envie um delta com base_version. Se o workflow mudou nesse meio-tempo, a gravação é recusada e nada é sobrescrito.

E se um workflow pedir a um modelo uma configuração que ele não aceita?

O Nodaro a corrige em vez de falhar. Uma proporção, resolução ou qualidade não aceita é trocada por um valor aceito ou removida, e a resposta lista cada alteração em adjustments.

Executar um workflow pelo MCP custa mais do que no editor?

Não. run_workflow gasta os mesmos créditos que uma execução no editor. Montar, ler e editar workflows é grátis.

Última atualização

Nesta página