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

Galeria e mídias

Num assistente de IA, navegue pela galeria e pelos uploads do Nodaro, mostre um resultado no chat, leia uma tarefa, acompanhe execuções e marque favoritos.

As ferramentas de galeria e mídias permitem que um assistente encontre, mostre e reutilize o que você já fez no Nodaro. browse_gallery e browse_uploads mostram os seus resultados e os seus uploads numa grade, get_asset e display_asset buscam ou mostram um resultado, get_app_run acompanha uma execução de workflow ou de app, e list_favorites e favorite_asset gerenciam os seus favoritos. Nenhuma delas custa créditos.

Mostra a sua galeria como uma grade interativa de miniaturas. Você pode clicar num item para vê-lo, copiá-lo ou usá-lo na próxima edição. Use-a quando o usuário quiser ver o próprio trabalho; use list_jobs quando o assistente só precisar dos dados.

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

ParâmetroTipoObservações
scopestringmine (padrão) para a sua própria biblioteca, ou public para resultados públicos recentes de outros usuários.
kindsarrayTipos de mídia a incluir: qualquer combinação de image, video e audio. Padrão: ["image", "video"].
kindstringUm único tipo de mídia: image, video ou audio.
querystringPalavras a buscar nos prompts, com até 200 caracteres, por exemplo rabbit. Cada palavra precisa aparecer no prompt, sem diferenciar maiúsculas de minúsculas.
limitintegerDe 1 a 200. Padrão: 50.
cursorstringO next_cursor da página anterior.

Retorna: a grade, nos clientes que exibem MCP Apps, e os itens com um next_cursor como dados.

O escopo público mostra o que a galeria pública da web mostra, com a mesma moderação. Por isso, uma página pode ter menos itens que limit: continue seguindo o next_cursor até ele não aparecer mais.

Em uma implantação que não permite trabalhos públicos (outputs.allowPublic: false), o escopo público não lista nada e responde (no items). A sua própria galeria não muda.

A sua própria galeria também lista as suas renderizações do Aplicar EDL: uma renderização de vídeo em video e uma renderização de áudio em audio. Uma renderização feita com qualidade de Prévia traz preview: true, e a linha de texto dela diz (preview). O escopo público nunca lista uma renderização do Aplicar EDL.

browse_uploads

Mostra os arquivos que você enviou, e não os resultados que o Nodaro gerou. Use-a para escolher um upload anterior como entrada de uma nova geração. O botão Use da grade devolve o ID do arquivo para o chat.

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

ParâmetroTipoObservações
kindstringimage, video ou audio. Omita-o para incluir todos os uploads.
searchstringPalavras a buscar nos nomes dos arquivos, com até 200 caracteres. Cada palavra precisa aparecer no nome do arquivo, sem diferenciar maiúsculas de minúsculas.
limitintegerDe 1 a 100. Padrão: 40.
cursorstringO nextCursor da página anterior.

Retorna: os uploads com as URLs e os IDs deles, e um nextCursor. Uma renderização do Aplicar EDL feita com qualidade de Prévia traz preview: true, e a linha de texto dela diz (preview). Um arquivo cuja cópia armazenada sumiu não é listado nem contado.

get_asset

Retorna os detalhes de um resultado: a URL da saída, o prompt e o modelo. Retorna as suas próprias tarefas em qualquer status e as tarefas públicas e concluídas de outros usuários. Em uma implantação que não permite trabalhos públicos (outputs.allowPublic: false), retorna só as suas próprias tarefas, e a tarefa de outro usuário aparece como não encontrada. Uma tarefa pública de outro usuário não traz as palavras do provedor sobre uma falha (errorDetail é null) nem o ID desse usuário. Para uma tarefa com falha, acrescenta retryable, guidance e, quando houver, suggestedProvider; Quando uma tarefa falha explica esses campos.

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

ParâmetroTipoObservações
job_idstringObrigatório. O ID da tarefa do resultado.

Retorna: o envelope da tarefa, sem input.

display_asset

Mostra um resultado no chat: o usuário vê a imagem, o vídeo ou o áudio em vez de dados. As imagens também ganham os botões Animate, Edit e Recreate e uma visualização em tela cheia. Use get_asset quando o assistente só precisar dos detalhes.

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

ParâmetroTipoObservações
job_idstringObrigatório. Uma tarefa sua em qualquer status, ou uma tarefa pública e concluída de outro usuário.

Em uma implantação que não permite trabalhos públicos (outputs.allowPublic: false), display_asset mostra só as suas próprias tarefas. A tarefa de outro usuário aparece como não encontrada.

Retorna: o cartão de mídia, com os detalhes do resultado como dados.

get_app_run

Retorna o progresso de uma execução de workflow ou de app publicado: o status, o estado de cada nó e todas as URLs de saída produzidas até o momento. Cada URL vem com o prompt, o modelo e o ID da tarefa. Use-a depois de run_workflow, render_final e run_app, que retornam um ID de execução (execution_id) em vez de um ID de tarefa. get_job não encontra um ID de execução. Chame-a a cada 5 a 10 segundos enquanto a execução estiver pending ou running.

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

ParâmetroTipoObservações
execution_idstringObrigatório. O ID da execução.

Retorna: o status da execução, os estados dos nós e as saídas até o momento:

  • executionId, status, errorMessage e um summary com as contagens total, completed, failed, skipped e skippedForEmptyInput.
  • nodeStates, uma entrada por nó, na ordem do workflow: id, label, nodeType, status, error, jobId, text e media. text é a saída de texto do nó, cortada em 1.500 caracteres, com textTruncated: true quando foi cortada. media lista cada URL de imagem, vídeo e áudio que o nó produziu, cada uma como { kind, url }. skipReason: "empty_input" significa que nada chegou à entrada do nó nesta execução.
  • outputs, cada URL de mídia da execução, com o prompt, o model e o createdAt da tarefa que a gerou.
  • resumeHint, em uma execução que falhou e que run_workflow pode continuar (um workflow salvo no projeto mcp, não uma execução de app): a chamada de run_workflow que a continua de onde ela parou. Veja Continuar uma execução que falhou. Uma execução de app que falhou traz, em vez disso, o Tentar novamente do app: a chamada de retry_app_run que o cota. Só a execução atual da execução de app o traz, então, depois de um Tentar novamente ou de um novo começo, a execução anterior não recebe nenhum. A chamada indica a version da própria execução quando o app mudou desde a execução.

Quando a execução termina, ela também traz outcome. O resultado é "nothing_new" quando pelo menos um nó foi pulado porque nada chegou à entrada dele e nada falhou, por exemplo um feed que não encontrou posts novos. Caso contrário, é "succeeded". Uma execução com falha ou cancelada tem um status, não um outcome.

list_favorites

Lista os IDs de tarefa dos seus resultados favoritos, dos mais recentes para os mais antigos.

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

ParâmetroTipoObservações
limitintegerDe 1 a 100.
cursorstringO cursor da página anterior.

Retorna: os IDs de tarefa dos seus favoritos. Uma renderização sua do Aplicar EDL marcada como favorita também aparece, com preview: true em uma Prévia. A renderização de outra pessoa não aparece. Em uma implantação que não permite trabalhos públicos (outputs.allowPublic: false), só as suas próprias tarefas são retornadas.

favorite_asset

Adiciona um resultado aos seus favoritos ou o remove deles. O resultado pode ser uma das suas próprias tarefas ou uma tarefa pública de outro usuário. Em uma implantação que não permite trabalhos públicos (outputs.allowPublic: false), você só pode marcar as suas próprias tarefas. Remover um favorito sempre funciona. list_jobs com favorited: true lista as tarefas que você marcou como favoritas.

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

ParâmetroTipoObservações
job_idstringObrigatório. O resultado a marcar.
favoritedbooleanObrigatório. true adiciona o favorito, false o remove.

Retorna: uma confirmação.

Perguntas frequentes

Como vejo a minha galeria do Nodaro no Claude?

Peça para ver a sua galeria. browse_gallery mostra as suas imagens e vídeos recentes numa grade clicável e também pode buscar nos seus prompts, por exemplo todas as imagens com um coelho.

Qual é a diferença entre browse_gallery e browse_uploads?

browse_gallery mostra os resultados que o Nodaro gerou para você. browse_uploads mostra os arquivos que você mesmo enviou, para que você escolha um deles como entrada de uma nova geração.

O assistente pode usar um resultado da galeria pública?

Sim. get_asset e display_asset retornam as suas próprias tarefas e as tarefas públicas e concluídas de qualquer outro usuário, então o assistente pode passar a URL de um resultado público para outra ferramenta. Uma implantação que não permite trabalhos públicos retorna só as suas próprias tarefas.

Como acompanho uma execução de workflow que um assistente iniciou?

Chame get_app_run com o ID de execução que run_workflow ou run_app retornou. A ferramenta mostra o status da execução, o estado de cada nó e todas as saídas produzidas até o momento.

Última atualização

Nesta página