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

Apps e componentes

Encontre apps e componentes do Nodaro, leia as entradas, execute-os e repita execuções que falharam num assistente de IA: list_apps, run_app e retry_app_run.

As ferramentas de apps e componentes permitem que um assistente use workflows que as pessoas publicaram. Um app é um workflow publicado com um formulário simples, como uma restauração de fotos ou uma edição temática, e um componente é um bloco de construção publicado. O assistente procura um deles, lê as entradas e o executa com os seus créditos.

Os apps atendem muitos pedidos que nenhuma ferramenta de geração resolve sozinha, como transformações inéditas, edições temáticas e pipelines de várias etapas. Um assistente deve procurar nos apps antes de responder que algo não pode ser feito.

list_apps

Busca apps publicados: no marketplace público ou entre os seus próprios apps.

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

ParâmetroTipoObservações
scopestringpublic (padrão) para o marketplace, ou mine para os seus próprios apps.
searchstringUm tema a buscar, com até 100 caracteres.
categorystringUma categoria, com até 50 caracteres.
limitintegerDe 1 a 50.
cursorstringO cursor da página anterior.

Retorna: os apps correspondentes, com os slugs deles. O estimated_credits de cada app é o preço que o app informa. Às vezes, o preço acompanha a duração de uma gravação que você dá ao app, como uma renderização do Aplicar EDL de um episódio inteiro. Nesse caso, estimated_credits é a parte fixa e per_minute_credits são os créditos por minuto da gravação. Quando o app tem uma entrada de lista que você preenche, per_item_credits é o que cada item além dos itens salvos pelo criador acrescenta. Os dois valem 0 ou não aparecem quando não se aplicam.

O preço informado é uma faixa. Os campos acima são o preço “a partir de”, com as configurações salvas do app. max_estimated_credits, max_per_minute_credits e max_per_item_credits são o preço “até”: o máximo que uma execução pode custar entre as escolhas que o usuário do app tem. Eles só aparecem quando diferem do preço “a partir de”. Um app publicado antes de a faixa existir só os tem depois da próxima publicação.

Quando um preço informado inclui uma chamada de LLM medida, a linha traz estimated_credits_is_estimate: true. O valor é então a chamada típica do modelo, e a execução é cobrada pelos tokens que a chamada realmente usou, então mostre o preço como ≈N. O campo não aparece para um preço fixo.

Em uma implantação que não permite trabalhos públicos (outputs.allowPublic: false), ou que esconde a página Apps, o escopo público não lista nada: { "data": [], "scope": "public", "next_cursor": null }. Os seus próprios apps continuam listados com scope: "mine".

get_app_inputs

Retorna as entradas de um app, o mesmo formulário que a página do app mostra. Chame-a antes de run_app para saber as chaves das entradas.

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

ParâmetroTipoObservações
slugstringObrigatório. O slug do app, por exemplo photo-restoration.

Retorna: o slug, o name e a description do app. Também retorna um item por entrada, com key, label, type (image, video, audio, text, select, number, boolean, list ou color), se ela é required e as options de um campo de seleção.

  • Um controle deslizante que o app expõe, como a Estabilidade de um Texto para fala, a Temperatura de um LLM ou uma Duração, é type: "number" com os próprios min, max e step do controle. run_app aceita um número ou uma string numérica para ele.
  • Uma configuração rápida que o app expõe, como o modelo, a resolução, a duração, a proporção ou a escolha de Rascunho de um nó, tem o tipo do que ela aceita. É um select cujas options são os valores dela, um number com min e max para uma configuração que aceita qualquer valor de um intervalo, ou um boolean, como Rascunho ou Instrumental. Quando as escolhas dependem do modelo do nó, options lista os valores de todos os modelos e a description informa isso. Escolha um valor que o modelo do nó aceite. Para essas entradas, run_app converte uma string numérica em número e "true" ou "false" em booleano. Um valor fora de uma lista fixa é recusado com 400 validation_error.
  • Uma entrada URL de vídeo é type: "video" e required: true. O valor dela é um link para um vídeo: a página do vídeo, ou outro link público da web. Um valor que não é um link da web é recusado com 400 locked_field. De um site cuja duração de vídeo o Nodaro lê primeiro, um vídeo de 4 minutos ou mais só é baixado como um trecho que você indica em inputOverrides, com sectionStartSec e sectionEndSec no nó. Uma execução sem o trecho é recusada antes de qualquer cobrança.

Em uma implantação que não permite trabalhos públicos (outputs.allowPublic: false), um app é só de quem o criou. O app de outra pessoa responde App "<slug>" not found., como um slug desconhecido.

run_app

Executa um app publicado. Você paga os créditos da execução.

Permissão: workflows:execute. Créditos: os créditos dos nós executados dentro do app.

ParâmetroTipoObservações
slugstringObrigatório. O slug do app.
inputsobjectUm objeto plano indexado pelas chaves das entradas de get_app_inputs. Omita-o para usar os valores padrão.
inputOverridesobjectAvançado. Campos brutos de nós, indexados pelo ID do nó e pelo campo, aplicados por cima de inputs, por exemplo { "n1": { "promptPrefix": "..." } }. Um campo definido como null é apagado nesta execução: o nó roda sem valor nesse campo, e não com o valor salvo pelo criador.
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.

Retorna: um ID de execução, e o runId da execução de app. Acompanhe a execução com get_app_run. Quando a execução falha, retry_app_run aceita o runId.

inputOverrides não pode definir para onde uma saída vai, como a URL de um nó Saída de webhook, a conta de um nó de publicação ou o alvo de um scraper. Uma execução que tenta fazer isso é recusada com 400 locked_field.

Em uma implantação que não permite trabalhos públicos (outputs.allowPublic: false), só os seus próprios apps rodam. O app de outra pessoa é recusado com 404 not_found, como um app que não existe.

retry_app_run

Tenta de novo uma execução de app que falhou, a partir de onde ela parou. É o botão Tentar novamente da página do app. Só as etapas que a execução não concluiu são executadas, e só essas são cobradas. Cada etapa que ela concluiu repassa o resultado. Um Clipe UGC que falhou renderiza só os clipes que não terminou. O Tentar novamente executa a versão do app que a execução executou, com as entradas que a execução aplicou, e não aceita entradas próprias.

Permissão: workflows:execute. Créditos: as etapas executadas de novo, com a taxa do criador no app.

ParâmetroTipoObservações
slugstringObrigatório. O slug do app.
run_idstringObrigatório. O ID da execução: o runId de run_app, ou o que uma dica de retomada indica.
versionintegerA versão do app que você espera que ele execute. O padrão é a versão mais recente do app. Envie a versão da própria execução para continuar nela depois que o app mudou.
confirmbooleantrue só depois que o usuário aceitou os créditos cotados nesta conversa.

Retorna: sem confirm, uma cotação, e nada começa. A cotação traz as etapas que seriam executadas de novo, o preço (estimatedCredits, com a taxa do criador incluída), reusedClips e sufficient. sufficient diz se o saldo e os créditos de app cobrem o Tentar novamente. appCreditsAllowance aparece quando são os créditos de app que o impedem, e a cotação diz isso. Mostre a cotação ao usuário, e chame de novo com confirm: true só depois que ele a aceitar. A ferramenta então cota de novo, o que também verifica a execução, e inicia o Tentar novamente. Ela retorna o ID da execução: consulte-a periodicamente com get_app_run.

  • Um Tentar novamente de cada vez. Uma segunda chamada enquanto esse Tentar novamente está pendente é recusada com already_running, e o erro indica a execução a consultar.
  • Um app que mudou. Quando o app mudou desde a execução, um Tentar novamente simples é recusado com app_run_version_changed, que indica a versão da execução e a do app. Comece a execução de novo com run_app, ou passe a versão da própria execução para continuar nela.
  • Execuções que começam de novo. Uma execução que foi concluída ou interrompida em vez de falhar, ou cuja versão não está mais disponível, começa de novo com run_app. O erro diz qual é o caso.
  • Uma prévia. Um Tentar novamente que pararia em uma renderização de prévia é recusado com preview_review_required. Tente de novo pela página do app, onde uma pessoa pode revisar a prévia.
  • Créditos. Uma recusa por créditos mantém a própria mensagem da rota, sobre os créditos de app ou o saldo.

Todas as recusas estão listadas em Tentar novamente uma execução que falhou.

Em uma implantação que não permite trabalhos públicos, uma execução do app de outra pessoa não é repetida (404 not_found, como para um app que não existe). O get_app_run continua lendo essa execução.

delete_app_run

Arquiva a execução de um app. Você pode restaurá-la ou excluí-la de vez em app.nodaro.ai/archived-runs. Uma execução só pode ser excluída de vez depois que terminou ou foi interrompida.

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

ParâmetroTipoObservações
slugstringObrigatório. O slug do app, a última parte da URL do app.
runIdstringObrigatório. O ID da execução.

Retorna: uma confirmação.

list_components

Busca componentes publicados: no marketplace público ou entre os seus. Use-a quando o usuário citar um componente pelo nome ou pedir um pipeline de várias etapas que corresponda a um componente conhecido.

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

ParâmetroTipoObservações
scopestringpublic (padrão) para o marketplace, ou mine para os seus próprios componentes.
searchstringUm tema a buscar, com até 100 caracteres.
limitintegerDe 1 a 50.
cursorstringO cursor da página anterior.

Retorna: os componentes correspondentes, com os slugs deles. Cada um traz estimated_credits, per_minute_credits e per_item_credits, além dos campos max_ correspondentes, lidos como em list_apps. Uma linha que contém a estimativa de uma chamada de LLM medida traz estimated_credits_is_estimate: true, como em list_apps.

Em uma implantação que não permite trabalhos públicos (outputs.allowPublic: false), o escopo público não lista nada: { "data": [], "scope": "public", "next_cursor": null }. scope: "mine" funciona como antes.

get_component_inputs

Retorna as entradas de um componente. Chame-a antes de run_component para saber as chaves das entradas.

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

ParâmetroTipoObservações
component_idstringObrigatório. O slug do componente.

Retorna: um item por entrada, com key, label, type e se ela é required.

Em uma implantação que não permite trabalhos públicos (outputs.allowPublic: false), um componente é só de quem o criou. O de outra pessoa responde Component "<slug>" not found., como um slug desconhecido.

run_component

Executa um componente publicado.

Permissão: workflows:execute. Créditos: os créditos dos nós executados dentro do componente.

ParâmetroTipoObservações
component_idstringObrigatório. O slug do componente.
inputsobjectUm objeto plano indexado pelas chaves das entradas de get_component_inputs. Omita-o para usar os valores padrão.
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.

Retorna: um ID de tarefa. Quando a tarefa termina, o output_data dela traz as saídas do componente. Nos clientes com MCP Apps, o cartão da tarefa mostra as saídas uma embaixo da outra.

Em uma implantação que não permite trabalhos públicos (outputs.allowPublic: false), o run_component roda só os seus próprios componentes. O de outra pessoa é recusado com 404 not_found "Component not found". Um componente colocado em um fluxo de trabalho continua rodando como parte da execução desse fluxo, com run_workflow.

Perguntas frequentes

Qual é a diferença entre um app e um componente?

Um app é um workflow publicado que funciona sozinho a partir de um formulário simples. Um componente é um bloco de construção publicado que outros workflows reutilizam. Os assistentes procuram primeiro um app quando não existe uma ferramenta direta para o pedido.

Quem paga a execução de um app iniciada por um assistente?

Você. run_app e run_component gastam créditos da sua própria conta, aos preços dos nós que existem dentro do app ou do componente.

Um assistente pode alterar as configurações ocultas de um app?

Só algumas. inputOverrides pode definir campos brutos de nós, como o texto adicionado antes de um prompt, mas não pode mudar o destino de uma saída, como a URL de um webhook ou uma conta de rede social. Essas execuções são recusadas.

Como um assistente tenta de novo uma execução de app que falhou?

Ele chama retry_app_run com o slug do app e o ID da execução. A primeira chamada só cota as etapas e o preço. Depois que você aceita, ele chama de novo com confirm true, e só as etapas que a execução não concluiu são executadas e cobradas.

Como excluo a execução de um app pelo assistente?

Chame delete_app_run com o slug do app e o ID da execução. A execução vai para as suas execuções arquivadas, onde você pode restaurá-la ou excluí-la de vez.

Última atualização

Nesta página