Docs do NodaroApps (miniapps)
Um miniapp é um workflow publicado como formulário simples, com URL própria. Escolha as entradas, os layouts, o compartilhamento, o preço e a incorporação.
Um miniapp é um workflow publicado como um app simples. As pessoas preenchem um formulário curto, clicam em Iniciar, e o Nodaro executa o workflow por trás dele e mostra os resultados. Elas nunca veem o canvas, e cada miniapp tem a própria URL, o próprio histórico de execuções e versões.
Como funciona um miniapp
| Você, o criador | As pessoas que executam o app | |
|---|---|---|
| O que vê | O workflow inteiro no canvas | Só as entradas e os resultados que você escolheu |
| O que faz | Monta o workflow, escolhe as entradas e as saídas e publica | Preenche as entradas e clica em Iniciar |
| Quanto custa | Nada para publicar | Os créditos da execução, do próprio saldo, mostrados no botão Iniciar |
Publicar um workflow como miniapp
Abrir a aba Apresentar
Abra o workflow e clique em Apresentar no topo do editor. Na aba Apresentar, você monta o que as pessoas veem: as entradas que elas preenchem, os resultados que recebem e os títulos, grupos e textos curtos em volta deles.
Escolher as entradas e as saídas
Adicione os nós cujos campos as pessoas devem preencher, como um prompt, um envio de imagem ou um seletor. Depois, adicione os nós cujos resultados elas devem ver. Dê a cada um um título e uma descrição. Em uma lista de opções, você pode restringir os valores que as pessoas podem escolher.
Clicar em Publicar e escolher Miniapp
Clique em Publicar, escolha Miniapp e insira um Nome do miniapp e uma descrição. O Slug da URL é opcional; deixe-o em branco, e o Nodaro cria um a partir do nome.
Definir as opções do app e publicar
Escolha as opções da tabela abaixo e clique em Publicar app. Use Abrir miniapp para vê-lo como os seus usuários vão ver.
| Opção | O que faz |
|---|---|
| Listar no marketplace | Lista o app na aba Explorar da página Miniapps, com a categoria, os tipos de saída e as tags que você escolher. Um app não listado continua abrindo pelo link. |
| Aceita RemX | Permite que as pessoas personalizem e remixem o seu app. |
| Somente leitura | As pessoas veem os resultados, mas não podem editar as entradas. |
| Modos de visualização permitidos | Os layouts entre os quais as pessoas podem alternar. Veja Modos de visualização. |
| Modo de visualização padrão | O layout em que o app abre. |
| Padrões da comparação | Os dois nós que o modo Comparar lado a lado mostra no início, à esquerda e à direita. |
| Miniatura da execução | O nó cujo resultado é a miniatura de cada execução na lista de execuções. |
O app publicado fica em app.nodaro.ai/app/ seguido do slug. A URL continua a mesma entre as versões. Publique de novo depois de alterar o workflow, e todos os links compartilhados abrem a nova versão.
Modos de visualização
Quem cria o app escolhe quais modos de visualização ele oferece e em qual deles ele abre. Quem executa o app pode alternar entre os modos permitidos.
| Modo | Como é |
|---|---|
| Divisão horizontal | Entradas à esquerda, resultados à direita. |
| Pilha vertical | Entradas em cima, resultados embaixo. Bom para telas estreitas. |
| Grade de galeria | Entradas e resultados como uma grade de cartões. |
| Slides em tela cheia | Um resultado por vez, em tela cheia. |
| Comparar lado a lado | Dois resultados um ao lado do outro. |
| Chat | Uma barra de entradas na parte de baixo reúne as entradas, e cada execução aparece como uma mensagem em uma conversa. |
Modo chat
O modo chat transforma um app em uma conversa. Ele fica desativado até você adicionar Chat aos modos de visualização permitidos do app e funciona no computador e no celular.
- A barra de entradas é uma fileira de chips. Cada entrada é um pequeno chip: clique nele para editar o valor. Um chip de envio mostra uma miniatura depois que você adiciona um arquivo.
- Iniciar executa o app. Não há um botão separado de nova execução. Iniciar começa uma execução, mostra o preço em créditos e mantém os seus valores na barra de entradas, para que você possa mudar um deles e executar de novo.
- Uma execução por vez. A barra de entradas fica bloqueada enquanto uma execução está em andamento e é liberada quando ela termina.
- Cada execução fica na conversa. Uma execução com várias etapas mostra um chip para cada etapa, que é marcado quando a etapa termina. Use Reutilizar entradas para executar de novo com os mesmos valores, Ver etapas para abrir o resultado de uma etapa ou Baixar para salvar um resultado.
- Resultados em tela cheia. Toque em um resultado para abri-lo em tela cheia. Use ← e → para percorrer as entradas e os resultados daquela execução, ↑ e ↓ para passar de uma execução para outra e Esc para fechar.
O que as pessoas que executam o seu app veem
- Só o que você escolheu. As entradas e os resultados que você colocou na aba Apresentar, com os seus títulos e textos.
- Não o seu texto antes e depois. O texto antes e depois de um nó envolve todo prompt, mas nunca aparece no app. Use-o para o seu estilo padrão.
- Não os seus destinos. O app fixa para onde envia e o que busca: o endereço de uma Saída de webhook (Webhook Output), uma conta de rede social ou o alvo de um scraper. Quem executa o app não pode alterá-los.
- O próprio saldo. As pessoas precisam fazer login para executar um app, e cada execução é paga com os créditos delas. O app informa quantas execuções o saldo delas cobre.
Uma Saída de webhook que envia com uma chave salva precisa usar uma chave vinculada a um único endereço antes que você possa publicar o app. A caixa de diálogo de publicação oferece fazer esse vínculo para você. Veja Saída de webhook.
Compartilhar um link de apresentação, sem publicar
A aba Apresentar também pode compartilhar o workflow sem publicá-lo. A caixa de diálogo de compartilhamento cria um link que qualquer pessoa pode usar para executar o workflow, pagando com os próprios créditos. As Configurações de visualização dela incluem Quem acessa só pode ver os resultados, os modos de visualização permitidos e o modo de visualização padrão. Revogar compartilhamento desativa o link.
Publique um miniapp quando quiser uma URL permanente, histórico de execuções, versões, análises e um lugar na página Miniapps. Use um link de compartilhamento para uma revisão rápida.
Gerenciar seus miniapps
Abra Miniapps na barra lateral. A página tem três abas:
- Explorar: todos os miniapps listados. Pesquise e ordene por Mais populares, Mais recentes ou Mais favoritados.
- Meus miniapps: os apps que você publicou, com as execuções, o preço por execução e os favoritos de cada um. Em cada cartão, você pode abrir o app ou o workflow dele e copiar a URL ou o código de incorporação. Você também pode ver as Análises do app, editar as configurações, listá-lo ou deixar de listá-lo e desativá-lo.
- Favoritos: os apps que você marcou com o coração.
Excluir um miniapp o oculta do marketplace e da sua lista. Você pode restaurá-lo a qualquer momento em Miniapps excluídos, e os ganhos, as análises e o histórico de execuções dele são mantidos.
Cobrar pelo seu miniapp
Disponível em Nodaro Cloud
No Nodaro Cloud, você pode cobrar um acréscimo quando outras pessoas executam o seu miniapp. Abra Editar configurações do miniapp no cartão do app e, em Monetização, defina uma taxa fixa em créditos, uma porcentagem ou as duas. A caixa de diálogo mostra quanto as pessoas vão pagar: o custo base da execução mais o seu acréscimo. Padrões de monetização, na página Miniapps, define a taxa e a porcentagem que um miniapp recebe quando você ativa a monetização dele pela primeira vez.
Os seus ganhos são adicionados ao seu saldo de recarga e valem por 12 meses. A página Cobrança mostra os ganhos em Ganhos com miniapps, para este mês, os últimos 30 dias e todo o período. Veja Créditos.
Incorporar um miniapp ou executá-lo por código
Incorpore em um site. Clique em Incorporar no cartão do app para copiar o código de incorporação. Antes, adicione os sites que podem exibir o app em Configurações de incorporação › Domínios permitidos para incorporação. A incorporação fica bloqueada até você adicionar pelo menos um domínio.
Execute pelo seu próprio código. O seu site ou app também pode executar um miniapp publicado pela API REST. O seu servidor lê as entradas do app, inicia uma execução e espera o resultado. O identificador do app é o slug dele, a última parte da URL. As execuções são assíncronas, então o seu servidor inicia uma execução e depois verifica o resultado. O fluxo completo, com código, está em Incorporar um miniapp.
Os assistentes conectados via MCP também podem listar e executar os seus apps, e a CLI executa um app com nodaro apps run.
Para reutilizar um workflow dentro de outros workflows, e não como formulário, publique-o como componente. Um workflow pode ser publicado tanto como miniapp quanto como componente.
Perguntas frequentes
Páginas relacionadas
Incorporar um miniapp
Componentes e sub-workflows
Créditos
Texto antes e depois do prompt
Workflows e projetos
Última atualização
Créditos
Créditos pagam as execuções de IA no Nodaro Cloud. Veja o preço antes de executar, como funcionam créditos grátis, de assinatura e recarga e quando voltam.
Componentes e sub-workflows
Junte um grupo de nós em um nó reutilizável: um sub-workflow editável ali mesmo ou um componente publicado com entradas, configurações e preço próprios.