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âmetro | Tipo | Observações |
|---|---|---|
scope | string | public (padrão) para o marketplace, ou mine para os seus próprios apps. |
search | string | Um tema a buscar, com até 100 caracteres. |
category | string | Uma categoria, com até 50 caracteres. |
limit | integer | De 1 a 50. |
cursor | string | O 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âmetro | Tipo | Observações |
|---|---|---|
slug | string | Obrigató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ópriosmin,maxestepdo controle.run_appaceita 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
selectcujasoptionssão os valores dela, umnumbercomminemaxpara uma configuração que aceita qualquer valor de um intervalo, ou umboolean, como Rascunho ou Instrumental. Quando as escolhas dependem do modelo do nó,optionslista os valores de todos os modelos e adescriptioninforma isso. Escolha um valor que o modelo do nó aceite. Para essas entradas,run_appconverte uma string numérica em número e"true"ou"false"em booleano. Um valor fora de uma lista fixa é recusado com400 validation_error. - Uma entrada URL de vídeo é
type: "video"erequired: 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 com400 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 eminputOverrides, comsectionStartSecesectionEndSecno 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âmetro | Tipo | Observações |
|---|---|---|
slug | string | Obrigatório. O slug do app. |
inputs | object | Um objeto plano indexado pelas chaves das entradas de get_app_inputs. Omita-o para usar os valores padrão. |
inputOverrides | object | Avanç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_id | string | Um 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âmetro | Tipo | Observações |
|---|---|---|
slug | string | Obrigatório. O slug do app. |
run_id | string | Obrigatório. O ID da execução: o runId de run_app, ou o que uma dica de retomada indica. |
version | integer | A 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. |
confirm | boolean | true 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 comrun_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âmetro | Tipo | Observações |
|---|---|---|
slug | string | Obrigatório. O slug do app, a última parte da URL do app. |
runId | string | Obrigató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âmetro | Tipo | Observações |
|---|---|---|
scope | string | public (padrão) para o marketplace, ou mine para os seus próprios componentes. |
search | string | Um tema a buscar, com até 100 caracteres. |
limit | integer | De 1 a 50. |
cursor | string | O 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âmetro | Tipo | Observações |
|---|---|---|
component_id | string | Obrigató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âmetro | Tipo | Observações |
|---|---|---|
component_id | string | Obrigatório. O slug do componente. |
inputs | object | Um objeto plano indexado pelas chaves das entradas de get_component_inputs. Omita-o para usar os valores padrão. |
client_request_id | string | Um 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.
Páginas relacionadas
Apps (miniapps)
Componentes e sub-workflows
Galeria e mídias
Projetos e workflows
Última atualização
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.
Pipelines
Inicie um pipeline História → vídeo com um prompt, acompanhe as etapas, aprove-as ou refine-as no chat e derive um pipeline pronto em qualquer etapa.