Criar um app ao vivo no canvas

"A exportação está lenta demais." "No celular, o texto fica minúsculo." "Por favor, adicionem modo escuro." "O feedback está espalhado por todo lado." Depois de duas semanas de entrevistas com clientes, uma equipe de produto encheu um canvas livre de notas assim, e a última é a mais sincera: o feedback está em todo lugar, e ninguém sabe dizer qual pedido apareceu cinco vezes e qual apareceu uma só.

A saída de sempre é copiar cada nota para uma planilha em outro lugar. Funciona por uma semana. Depois chega feedback novo no canvas, a planilha fica para trás e a equipe passa a discutir com base em duas listas diferentes. Um app ao vivo fecha essa lacuna. Você descreve a ferramenta de que precisa, o ALLO constrói um app funcional, e ele roda no canvas bem ao lado das notas que o pediram. Ali a equipe inteira pode alimentá-lo, votar e, mais tarde, compartilhá-lo com pessoas de fora do espaço de trabalho.

Este guia acompanha essa equipe de produto do pedido até a versão 2 do quadro de feedback de clientes e mostra quem pode fazer o quê em cada etapa.

Resumo

Em um canvas livre, clique em Adicionar app ao vivo na barra de ferramentas, descreva o app de que você precisa e envie. Responda às perguntas que o Lead fizer e deixe a construção rodar enquanto continua trabalhando. Use o app pronto com a equipe no canvas e clique em Publicar em Compartilhar quando alguém de fora precisar do link. Peça mudanças no mesmo chat: cada registro salvo passa para a próxima versão.

Nesta visão geral de 94 segundos, um plano de lançamento e a foto de uma caneca viram um app de pré-venda. Depois, o criador pede ao chat do app que adicione uma lista de espera. O passo a passo abaixo usa um quadro de feedback de clientes para explicar cada etapa.

Confira se o canvas aceita um app ao vivo

Apps ao vivo existem apenas em canvases livres. Canvases de página, de slides e compactos não têm essa ferramenta; se as suas notas estão em um quadro com páginas, crie um canvas livre para o app. A diferença entre os dois formatos está em Canvas de página e quadros brancos sem limites.

Você também precisa de permissão de edição no canvas. Sem ela, clicar na ferramenta mostra um aviso de falta de permissão em vez da janela de criação. Permissões do canvas explica como a permissão de edição é concedida.

Um app ao vivo faz sentido quando o resultado é algo que as pessoas usam: um quadro que recebe novas entradas, um controle que a equipe atualiza, um painel que todos consultam. Se você só quer saber o que uma nota ou um arquivo diz, faça uma pergunta sobre o item do canvas.

Peça o app direto do canvas

Há dois caminhos, e os dois abrem a mesma janela de criação.

1. Pela barra de ferramentas. Clique em Adicionar app ao vivo (o ícone de brilhos) no primeiro grupo da barra, ao lado de Seletor, Desenho, Enviar arquivos e Comentário. A dica da ferramenta diz "Crie um app ao vivo: um artefato construído por chat que funciona no canvas".
2. A partir de uma seleção. Selecione as notas, caixas de texto, tabelas, imagens ou arquivos que devem servir de ponto de partida e clique em Abrir no AI Studio na barra de ferramentas contextual. A janela abre com a seleção já anexada.

A equipe de produto usa a barra de ferramentas, porque o pedido cabe em uma frase. Quando o app precisa partir de notas ou arquivos específicos, o segundo caminho poupa o trabalho de redigitar o conteúdo deles. Abrir no AI Studio não aparece quando a seleção inclui um objeto bloqueado, um espaço reservado, algo que ainda está sendo gerado ou um arquivo de tipo bloqueado.

Neste vídeo, a ferramenta da barra abre a janela e o pedido é escrito com as notas das entrevistas ainda à vista.

Clicar na ferramenta não cria nada por si só. Nada passa a existir até você enviar uma mensagem ou anexar um arquivo.

Escreva o pedido antes de qualquer coisa começar

A janela vazia convida você a escrever no campo Atribua uma tarefa ou pergunte qualquer coisa. Abaixo dele, os chips de tipo definem o que você está criando:

Os chips só aparecem enquanto o tipo ainda pode ser escolhido. Para o quadro de feedback, deixe em Auto.

Se não souber como formular o pedido, abra Comece com uma ideia. Escolher uma ideia preenche o rascunho para você editar, e nada começa até você enviar.

Anexe os arquivos com que o app deve trabalhar pelo clipe (Anexar) ou arraste-os para o chat. Planilhas (xlsx, xls, csv, tsv), documentos (pdf, doc, docx, ppt, pptx, md, txt, json, html), imagens, áudio e vídeo são aceitos. Imagens anexadas viram referências para a construção.

A equipe escreve uma frase só: um quadro para o feedback de clientes, com um cartão para cada feedback e um jeito de votar. Pressione Enter para enviar.

Deixe a construção rodar enquanto você trabalha

Depois do envio, a conversa mostra o trabalho à medida que ele acontece.

• O Lead pergunta primeiro quando algo não está claro. As perguntas aparecem como linhas de opções ou um pequeno cartão de resposta. A janela mostra Aguardando sua resposta. Continue no chat. até você responder. Se você pular a pergunta, o Lead escolhe um caminho e avisa qual foi.
• Como foi lista cada etapa com a contagem de itens concluídos, do planejamento até a revisão de qualidade e o teste de comportamento.
• No canvas, o cartão diz Criando seu app ao vivo…

Pode fechar a janela e voltar ao canvas: a construção segue rodando. Se lembrar de algo nesse meio-tempo, escreva mesmo assim. Enviar vira Enfileirar próximo pedido, e o pedido espera a vez em vez de interromper a construção. Para cancelar uma construção, clique no botão de parar. O resultado aparece como Interrompido, e nenhuma versão publicada muda.

Às vezes uma construção concluída espera por você em vez de entrar no ar. O chat mostra Precisa da sua revisão com Ver o resultado, Corrija de novo e Não usar. Ver o resultado abre uma prévia desligada dos dados reais, então nada do que você digitar ali é salvo. Escolha Corrija de novo para mandar de volta ou Não usar para descartar o resultado e manter a versão atual. Quando as correções automáticas se esgotam, Corrija de novo deixa de aparecer; nesse caso, envie um novo pedido no chat.

Quando a construção termina, o quadro aparece no canvas bem ao lado da nota que o pediu. Observe o canto inferior direito quando ele chegar: é ali que surge a contagem de Apps ao vivo.

Use em equipe e saiba quem pode alterá-lo

O quadro agora é um app funcional em um canvas compartilhado. Quem consegue abrir o canvas pode usá-lo: a designer adiciona "No celular, o texto fica minúsculo" como cartão, um engenheiro vota no pedido de exportação, e os dois veem as mudanças um do outro no mesmo app.

Neste vídeo, dois colegas adicionam feedback e votam ao mesmo tempo, e cada cartão e cada voto vão parar no mesmo quadro.

Usar o app e alterar o app são permissões diferentes. O cabeçalho da janela mostra Criado por com o nome do criador, e só dois tipos de pessoa podem conversar com um app ao vivo ou alterá-lo:

O criador adiciona pessoas em Administração → Visão geral → Administradores do app, com Adicionar administrador. Ter permissão de edição no canvas não transforma ninguém em administrador do app. Isso é intencional: quem reorganiza post-its não deveria conseguir reescrever o quadro de feedback por acidente.

O que as pessoas podem fazer com os dados do app é outra configuração. Em Administração → Dados, cada coleção mostra suas Permissões da coleção. O proprietário e os administradores sempre têm acesso total. A linha Todas as outras pessoas vale para membros do canvas, convidados e visitantes de um link publicado. O criador altera essa linha com Alterar acesso:

• Ver e Adicionar ficam ativados ou desativados.
• Atualizar e Excluir ficam em Desativado, Apenas os próprios ou Todos.

Clique em Salvar para aplicar. Quando você ativa Ver, o ALLO mostra antes o aviso de exposição, e você confirma com Compartilhar registros. Para o quadro de feedback, uma configuração sensata ativa Ver e Adicionar, define Atualizar como Apenas os próprios e deixa Excluir em Desativado.

Publique e envie o link

A equipe quer que os entrevistados adicionem feedback diretamente. Um app ao vivo fica restrito ao canvas até você publicá-lo. Nada sai sozinho.

1. Abra o app ao vivo e clique no ícone de compartilhar para abrir Compartilhar.
2. Clique em Publicar. O painel explica: "Compartilhe esta versão por link. As edições posteriores ficam privadas até você publicar de novo."
3. Clique em Copiar link (ou em Abrir em nova aba para conferir você mesmo) e envie o link.

Por padrão, Qualquer pessoa com o link pode ver fica ativado. O link abre sem login, e os visitantes podem usar o app, mas não alterá-lo nem ver a conversa. Desative a opção e o link passa a abrir só para membros do canvas. O ícone de compartilhar aparece para o criador e para administradores com acesso às conversas. Apps que pareçam phishing, falsificação de identidade, golpe ou spam não podem ser compartilhados por link.

Acompanhe a entrega completa: o quadro é publicado, o link é copiado e enviado, e o entrevistado o abre no navegador, sem conta no ALLO, e adiciona um registro.

O entrevistado conseguiu adicionar um registro porque a coleção permite Adicionar para Todas as outras pessoas. As permissões da coleção valem para os visitantes do link exatamente como valem para os membros do canvas.

O status em Compartilhar mostra em que pé você está: Publicado, Alterações não publicadas (uma versão anterior está no ar e suas edições mais recentes ainda não foram compartilhadas) ou Não publicado. Cancelar publicação fecha o link. O canvas continua como está.

Peça a próxima versão

Uma semana depois, o quadro está cheio e a equipe precisa saber quais cartões já estão sendo tratados. O pedido vai no mesmo chat: adicionar um status a cada cartão.

Os pedidos seguintes ficam na mesma conversa (Continue com outro pedido…). Cada alteração concluída que gera uma versão salva recebe um checkpoint (Checkpoint v1, Checkpoint v2 e assim por diante), e o cabeçalho mostra a Versão atual, com um painel Versões em que você pode usar Restaurar para voltar a uma versão anterior.

No vídeo, a versão 2 adiciona um status a cada cartão e ocupa o mesmo lugar no canvas, e todos os registros da versão 1 continuam lá.

Esta é a regra que vale guardar: os dados ficam com o app quando o código muda. Os feedbacks, os votos e o registro do entrevistado passam todos para a versão 2. O contrário também vale: restaurar um código antigo não traz de volta dados que foram excluídos.

Depois da versão 2, confira Compartilhar. O painel mostra Alterações não publicadas até você clicar em Publicar de novo, então os visitantes do link continuam usando a versão 1 enquanto isso.

Às vezes um pedido seguinte é, na verdade, outra coisa. Peça um resumo de uma página com o feedback, e o ALLO pergunta onde ele deve ficar, marcando a opção que recomenda:

• Criar neste objeto substitui este objeto pelo novo resultado. A versão anterior continua disponível para restauração no histórico de versões.
• Novo objeto mantém este objeto e a conversa dele intactos. Só este pedido vai para um novo objeto, então anexe de novo os arquivos de que ele precisar.

Para o quadro de feedback, escolha Novo objeto: o quadro continua funcionando e o resumo vira um objeto próprio. Um objeto de documento, tabela, imagem ou áudio não pode virar um app web, então um pedido assim vai para um novo objeto.

Gerencie dados, chaves e agendamentos em Administração

Quem pode gerenciar o app vê as abas Pré-visualização, Código e Administração. Código é somente leitura e mostra Registro de execução, Atividade e Arquivos. Administração é onde você cuida do app no dia a dia, e Gerenciar um app ao vivo em Administração percorre cada seção. Em resumo:

• Dados. Edite registros, use Adicionar de arquivo CSV e acompanhe o Uso de registros: cada app guarda até 10.000 registros, enquanto os arquivos anexados aos registros contam para o armazenamento do espaço de trabalho. Veja Acompanhe o limite de registros em Dados.
• Alterações pelo chat. Quando você pede à IA (o modelo) para alterar ou excluir um registro salvo, nada muda até você escolher Aplicar na linha de revisão, e Descartar cancela a proposta. Veja Revise as alterações da IA.
• Segredos. Só o criador gerencia as chaves do app, a IA (o modelo) nunca vê os valores, e Mostrar valores não pede senha. Veja Proteja as chaves em Segredos.
• Automação. Reexecutar a tarefa do app repete o seu último pedido e consome créditos de IA, enquanto Só atualizar os dados busca dados novos sem custo. Veja Agende tarefas em Automação.
• Compartilhamento. A versão publicada, o endereço do app e a descrição da prévia do link. Veja Publique versões e defina o link em Compartilhamento.

Fazer uma cópia (no menu de contexto do objeto) copia o app para um canvas que você pode editar, e as cópias começam sem dados. Excluir o app para sempre, nas configurações de dados, exclui todas as cópias e tudo o que elas salvaram, e não pode ser desfeito.

Encontre todos os apps ao vivo de um canvas

Quando um canvas tem mais de um app ao vivo, use o botão Apps ao vivo no canto inferior direito. Ele mostra quantos existem e abre uma lista com busca ("Buscar por nome ou fonte de dados"), com os atualizados mais recentemente primeiro. Selecione uma linha para abrir aquele app ou use Mostrar no canvas para ir até onde ele está. A paleta de comandos também lista todos eles.

Pague as construções com créditos de IA

As construções usam os créditos de IA do espaço de trabalho, cobrados pelo que cada construção realmente consome. Criar ou alterar um app costuma custar 300-700 créditos. Imagens, narração e música que o app gera consomem créditos adicionais, e uma resposta do chat que não muda nada custa bem menos. Uma construção que falha não cobra nada. Para começar, a construção exige um saldo mínimo de créditos, e as execuções agendadas de Reexecutar a tarefa do app consomem créditos a cada vez.

O chat não mostra preço por rodada. O gasto entra no saldo compartilhado do espaço de trabalho: abra as Configurações do espaço de trabalho e selecione Uso para vê-lo. Administradores do espaço de trabalho podem selecionar Ver histórico para acompanhar a atividade de créditos de IA de todo o espaço de trabalho e compram mais créditos em Comprar e gerenciar créditos de IA.

O que pode dar errado

Você não encontra Adicionar app ao vivo. Confira:

• O canvas é de página ou de slides. Apps ao vivo só funcionam em canvases livres.
• Você não tem permissão de edição no canvas.
• Você está no navegador do celular. Ali a barra de ferramentas não tem Adicionar app ao vivo, mas selecionar objetos e usar Abrir no AI Studio funciona.

A construção parou em "Aguardando sua resposta. Continue no chat." O Lead fez uma pergunta. Abra o app ao vivo e responda no chat.

O resultado diz "Precisa da sua revisão". A construção terminou, mas ainda não está no ar. Abra Ver o resultado para conferir e depois escolha Corrija de novo ou Não usar. Se Corrija de novo não aparecer, as correções automáticas acabaram; descreva a correção em uma nova mensagem.

Aparece "A execução parou por causa de um problema". A execução falhou e nada foi cobrado. Clique em Tentar este pedido de novo. Seu rascunho e seu pedido ficam salvos, e a última versão que funcionava continua igual. Quando o resultado da IA não estiver correto ajuda quando as novas tentativas continuam falhando.

Aparece "Não foi possível concluir algumas mídias". Confira o rótulo de cada item:

• Serviço de geração ocupado. Tente novamente. Nada foi cobrado por esse item. Tente esse item de novo.
• Não confirmado. Não foi possível confirmar o resultado. O ALLO não o compra de novo automaticamente.

Aparece "Seus créditos de IA acabaram." Administradores veem Comprar créditos. As demais pessoas precisam pedir a um proprietário ou administrador do espaço de trabalho que adicione créditos. Veja Entender os créditos de IA.

Um colega não consegue abrir a conversa nem alterar o app. Só o criador e os administradores do app que ele adicionar conseguem. Peça ao criador que adicione o colega em Administração → Visão geral → Administradores do app, com Compartilhar conversas ativado se ele precisar do chat.

Visitantes do link não conseguem adicionar registros. A coleção não permite. O criador abre Administração → Dados, clica em Alterar acesso, ativa Adicionar para Todas as outras pessoas e clica em Salvar.

Aparece "O limite de registros do app foi atingido." O app chegou ao limite de 10.000 registros, ou a alteração que você tentou fazer passaria dele. O criador e os administradores do app clicam em Entrar em contato no aviso para solicitar um limite maior; as demais pessoas pedem isso a um administrador do app. Gerenciar um app ao vivo em Administração explica o limite.

Não é possível anexar um arquivo. "O administrador do espaço de trabalho bloqueou este tipo de arquivo." significa que um administrador restringiu esse tipo. "O armazenamento do espaço de trabalho está cheio." significa que você precisa excluir arquivos ou adicionar armazenamento; veja limites de armazenamento.

Se nada disso resolver, fale com o suporte informando o link do canvas e a mensagem exata que aparece.