Trabalhando com a IA

O Lumo foi desenhado para ser operado por um agente de IA (Claude Code, Codex…), não digitado comando a comando. Na prática, você descreve o que quer e a IA traduz isso para os comandos e YAMLs do lumo.

Esta página não é um passo a passo de comandos — é um guia de como colaborar com a IA: o que cabe a você, o que a IA faz sozinha, e como pedir as coisas de um jeito que dá certo.

O que é seu, o que é da IA

Há uma fronteira simples: algumas coisas você faz uma vez, por fora (no terminal); o resto acontece dentro da conversa, comandado pela IA.

Você faz (por fora, uma vez)	A IA faz (por dentro, na conversa)
Instalar o lumo (Primeiros Passos)	Inicializar e sincronizar o workspace
Autenticar com lumo auth login — é a sua sessão	Criar e editar flows, tabelas, apps, dashboards
Instalar a skill no agente (Integrações)	Rodar flows, carregar dados, exportar imagens
Apontar o agente para a pasta do workspace	Validar, dar push, conferir resultados

IMPORTANT

O login é seu e fica por fora. Você roda lumo auth login no terminal — a IA não tem suas credenciais, ela apenas usa a sessão que você já abriu. Se a IA disser que não está autenticada, é você quem faz o login.

E há uma coisa que é sempre sua, nunca da IA: decidir publicar. Veja abaixo.

Sendo claro com a IA

Quanto mais claro o pedido, melhor o resultado. Algumas dicas:

• Fale o objetivo, não o comando. Diga "quero um dashboard de vendas por região", não "rode lumo app query". A IA escolhe os comandos.
• Diga a fonte. "extrai do nosso Postgres de produção", "a partir desta planilha do Google" — assim ela sabe qual credencial/entrada usar.
• Peça pra ver antes de fechar. "me mostra o dashboard antes" — a IA exporta uma imagem para você conferir o visual, não só os números.
• Publicar é decisão sua — e explícita. A IA constrói tudo como rascunho e só publica quando você disser "publica". Quando for a hora, diga onde: "publica o flow na mesa Operação", "publica o app na mesa Comercial".
• Confirme por evidência. "confirma que carregou" — peça a contagem de linhas ou a prévia da tabela. "Enfileirado" não é "pronto".

Exemplos de pedido

Em vez de…	Prefira…
"roda o lumo aí"	"carrega as vendas de 2024 e me mostra quantas linhas entraram"
"cria um flow"	"cria um flow que extrai pedidos do Postgres e carrega no DW"
"publica tudo"	"está bom — publica o flow na mesa Operação e o dashboard na mesa Comercial"
"faz um dashboard"	"monta um dashboard de faturamento mensal por filial, e me mostra a imagem"

A IA vai parar e te perguntar — e isso é bom

A skill orienta a IA a não agir sozinha em decisões que são suas ou em estados ambíguos. Espere que ela pare e pergunte quando:

• For publicar algo (sempre pede confirmação e o destino).
• Houver ambiguidade (duas mesas com nomes parecidos, qual fonte usar).
• O servidor estiver num estado inconsistente que não se resolve insistindo.

Isso é proteção, não lentidão. Um "deixa como rascunho que eu reviso" é uma resposta perfeitamente válida.

Rede de segurança

• Use Git no workspace. A IA trabalha em arquivos YAML versionáveis; com Git você tem histórico e rollback do que ela fez. Veja como conferir em Revisando o trabalho da IA.
• Mantenha o CLI atualizado. O lumo avisa quando há versão nova; a IA costuma te alertar e pode rodar lumo update com seu ok — vale manter atualizado para a skill acompanhar os comandos.

Próximo passo

Depois que a IA fizer o trabalho, aprenda a conferir: Revisando o trabalho da IA.