Docs do NodaroApps e componentes
Encontre apps e componentes publicados no Nodaro, leia as entradas e execute-os num assistente de IA: list_apps, run_app, list_components e run_component.
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.
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: um item por entrada, com key, label, type (image, video, audio, text, select, number, boolean ou list), se ela é required e as options de um campo de seleção.
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": "..." } }. |
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. Acompanhe a execução com get_app_run.
inputOverrides não pode definir para onde uma saída vai, como a URL de um nó Saída de webhook (Webhook Output), 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.
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.
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.
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.
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 job. Quando o job termina, o output_data dele traz as saídas do componente. Nos clientes com MCP Apps, o cartão do job mostra as saídas uma embaixo da outra.
Perguntas frequentes
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.