Trabalhar com IA

Tipo

Como fazer

Para

Analista, Desenvolvedor

Com a skill instalada, você descreve o resultado e o agente de IA escolhe os comandos do lumo, escreve o YAML e confere o que o servidor gravou. O seu papel é dar o contexto, revisar e decidir a publicação.

Antes, o lumo precisa estar instalado e com sessão aberta, e a skill no seu agente. Veja Instalar o Lumo CLI e Agentes de código.

O que é seu e o que é do agente

Você	O agente
Instala o lumo e a skill	Inicializa e sincroniza o workspace
Abre a sessão com lumo auth login	Cria e edita Dataflows, tabelas, Aplicações, Dashboards
Abre o agente na pasta do workspace	Roda Dataflows, consulta dados, exporta imagem do Dashboard
Revisa e decide publicar	Valida com lumo lint, dá push e confere a resposta

A sessão é sua. O agente usa a que você abriu e nunca deve pedir a sua senha. Se a sessão expirar no meio do trabalho, a skill orienta o agente a rodar lumo auth login --web e pedir que você aprove no navegador.

Pedir

Diga o resultado que você quer, de onde vem o dado e como vai saber que deu certo. O agente escolhe os comandos.

Em vez de	Peça
"roda o lumo aí"	"carrega as vendas de 2025 e me diz quantas linhas entraram"
"cria um flow"	"cria um Dataflow que extrai os pedidos do Postgres do ERP e grava no HorusDW, recarregando os últimos 30 dias"
"faz um dashboard"	"monta um Dashboard de faturamento mensal por filial e me mostra a imagem"
"publica tudo"	"está bom: publica o Dataflow na Mesa Operação e a Aplicação na Mesa Comercial"

Dizer a fonte evita que o agente escolha a credencial errada. Pedir a contagem de linhas ou a imagem do Dashboard troca "enfileirado" por prova de que carregou e de que o visual está certo.

Publicar é decisão sua

O agente constrói tudo como rascunho, na Minha Mesa. A skill proíbe publicar por conta própria: "cria o Dashboard" ou "faz funcionar" não autorizam publicação, só um "publica" explícito. Quando for a hora, diga onde: o nome da Mesa.

Publicar compartilha o recurso com quem tem acesso à Mesa e, quando o recurso é um clone, substitui a versão publicada. Desfazer pede clonar, editar e publicar de novo, então revise antes de pedir. As regras de cada tipo estão em Conceitos.

Quando o agente para e pergunta

Espere uma pergunta, e não uma tentativa às cegas, quando:

• for publicar (o agente pede confirmação e o destino);
• houver ambiguidade, como duas Mesas de nome parecido ou duas fontes possíveis;
• o push voltar com drift, porque alguém mudou o recurso pela tela (veja Drift e conflitos);
• o servidor estiver num estado que não se resolve insistindo, como um Dataflow publicado ligado a uma tabela em rascunho.

"Deixa como rascunho que eu reviso" é uma resposta válida para qualquer uma delas.

Revisar

Tudo o que o agente faz vira arquivo no workspace, então dá para revisar como código.

1. Peça "o que você mudou?". O agente resume e pode rodar lumo status (o que mudou nos arquivos desde a última sincronização) e lumo diff <tipo>:<id> (a diferença de um recurso).
2. Se o workspace está no Git, git diff mostra cada linha que entrou.
3. Confira o que só aparece rodando:
   • Dashboard: peça a imagem (lumo app export). Os números podem estar certos e o visual quebrado.
   • Tabela: peça a prévia ou a contagem de linhas (lumo table preview).
   • Nomes e destino: os nomes dos recursos e a Mesa onde vão ser publicados.

WARNING

git checkout desfaz o arquivo, não o servidor. O que já foi enviado com push continua gravado no Tenant. Para voltar, reverta o arquivo e dê push de novo, ou peça ao agente.

O que volta sozinho

O agente conhece estas regras, mas é bom saber por que um campo "volta ao normal" depois de um push:

• id, kind, lumo e tenantId no cabeçalho são fixos.
• deskId é da publicação. Editá-lo no YAML não muda a Mesa.
• Nome e tipo de coluna de uma tabela vêm do Dataflow que a alimenta. Para mudar, edite o nó do Dataflow. A chave da tabela (key_type, key_columns) é editável, mas recria a tabela física e apaga as linhas; veja a referência de table.
• A pasta .lumo/ é cache do CLI.

Depois de cada push, o CLI reescreve o arquivo com o que o servidor guardou e imprime os campos ignorados. O arquivo e o servidor ficam iguais.

Relacionado

• Conceitos
• Drift e conflitos
• Agentes de código