Colunas de workflow

Uma tabela é uma grade de colunas tipadas. Normalmente você digita os valores de uma coluna. Uma coluna de workflow é diferente: seus valores vêm de um workflow que roda uma vez por linha. Para cada linha, o workflow lê as colunas que você escolhe como entrada, executa seus blocos e grava os resultados de volta nas colunas dessa mesma linha.

É isso que torna uma tabela ativa. Em vez de rodar um workflow na mão e colar os resultados, você anexa o workflow à tabela e ele preenche cada linha sozinho — um pouco como uma macro de planilha que roda em cada linha, só que cada passo é um workflow completo.

O exemplo em andamento é uma tabela de startups de IA, ai_startup_customers. A empresa é digitada; três grupos de workflow preenchem o resto:

• Company Domain encontra o domain de cada empresa.
• Company Info lê o domínio e preenche employee_count e description.
• Lead Score Enrichment roda o workflow de lead scoring e grava lead_score, priority e score_reasoning.

O cabeçalho de cada grupo cobre as colunas que ele possui, cada linha tem um botão de execução (▷), e a barra de ferramentas mostra o trabalho em andamento: aqui, 21 running, com Stop all ao lado.

domain            │ employee_count │ lead_score │ priority
──────────────────┼────────────────┼────────────┼─────────
openai.com        │ 5K-10K         │ 75         │ Warm
gominimal.ai      │ Not found      │ 92         │ Hot
genspark.net      │ 51-250         │ 20         │ Cold

Dois tipos de grupos

A unidade que você configura é um grupo: algo que roda uma vez por linha, alimentado por colunas de entrada, gravando colunas de saída. Há dois tipos, e o menu + New column oferece ambos — Enrichments acima dos tipos de coluna comuns, Workflow abaixo deles. Eles compartilham toda a maquinaria de execução descrita a seguir.

Enrichments

Um enrichment é uma busca pronta que o Zoen fornece e mantém — explore o painel Enrichments para ver o que está disponível. Escolha um, vincule suas entradas às colunas e nomeie as colunas que suas saídas devem preencher; não há workflow para construir. Por baixo dos panos, um enrichment tenta uma cascata de provedores de dados em ordem, por isso uma célula pode voltar Not found: todos os provedores rodaram e nenhum tinha a resposta.

Grupos de workflow

Um grupo de workflow roda um dos seus próprios workflows por linha — use quando o trabalho por linha é algo que você construiu, como o lead scorer. O painel Configure workflow guarda tudo que o define, com uma prévia do workflow que ele vai rodar:

• Workflow escolhe qual workflow roda por linha; aqui, Lead Score Enrichment.
• Add column inputs mapeia colunas para as entradas do workflow, que chegam no trigger Start.
• Output columns escolhe quais saídas do workflow gravar de volta; aqui, 3 estão selecionadas.
• Auto-run workflow e Run after controlam quando as linhas rodam (ambos abaixo).

Um grupo pode produzir várias colunas de resultado a partir de uma única execução por linha: Lead Score Enrichment preenche lead_score, priority e score_reasoning juntos.

Como os grupos rodam

Tudo a partir daqui vale para os dois tipos. A configuração de um grupo é um conjunto de vínculos: cada entrada é ligada a uma coluna, e cada saída é ligada ao nome da coluna que ela grava. Aqui, a entrada obrigatória Company domain de Company Info lê a coluna domain, e suas saídas gravam employee_count_0 e description:

Quando um grupo roda uma linha, os valores das colunas vinculadas viram suas entradas; ele só vê as colunas que você mapeou, o resto da linha não é tocado, e as entradas são somente leitura durante a execução. Toda saída que você selecionou é gravada na sua coluna, e as que você não selecionou são descartadas.

Run after

Run after é o conjunto de colunas que precisam estar preenchidas antes do grupo rodar em uma linha. Company Info roda depois de domain: uma linha com domain vazio espera, e no momento em que Company Domain o preenche, essa linha fica elegível. Lead Score Enrichment roda depois das colunas de info, as seis dependências no painel acima.

Uma dependência pode ser uma coluna digitada ou a coluna de saída de outro grupo. Esse segundo caso é o que faz as cascatas funcionarem (abaixo). Pelo menos uma dependência é obrigatória quando o auto-run está ligado.

Auto-run

Auto-run decide se um grupo dispara sozinho. Com auto-run ligado, um grupo roda uma linha assim que as colunas de Run-after dessa linha estão preenchidas, sem clique; é assim que 21 linhas acabam rodando ao mesmo tempo no exemplo. Com ele desligado, você dispara na mão.

Você dispara um grupo manualmente pelo menu do cabeçalho da coluna:

• Run this row roda só aquela linha.
• Run all rows roda todas as linhas, e reexecuta linhas que já terminaram.
• Run empty rows roda só as linhas cujas colunas de saída ainda estão vazias.
• Run selected rows roda as linhas que você marcou.

O auto-run só roda linhas que ainda não tentou. Para reexecutar uma única linha, use Re-run cell no menu da célula; para reexecutar tudo, use Run all rows.

Status de execução

Enquanto um grupo trabalha uma linha, suas células de saída mostram o estado em vez de um valor:

Quando um valor chega, ele substitui o badge, e células que terminam ficam preenchidas mesmo enquanto outras colunas da linha ainda estão rodando. Você vê isso na tabela de exemplo: a maioria das linhas está totalmente pontuada, enquanto algumas mostram Not found onde um enrichment voltou vazio. O lead scorer ainda rodou nessas linhas, trabalhando com o que tinha.

Inspecionando a execução de uma linha

Todo valor em uma coluna de workflow vem de uma execução real de workflow, e cada um é inspecionável. Abra o menu de uma célula para agir nessa linha:

View execution abre o rastreamento da execução: cada bloco com status, tempo e custo em créditos, a mesma visão da página de Logs. Aqui, a pontuação da linha veio de uma execução de 1,86s do workflow LeadScorer:

Re-run cell roda o grupo de novo só para aquela linha, substituindo seus valores quando a execução termina.

Cascadas

Como um grupo pode rodar depois da coluna de saída de outro grupo, você pode encadear grupos pela tabela — enrichments e grupos de workflow misturados livremente. O exemplo é uma cascata em três estágios: Company Domain preenche domain a partir do nome da empresa, Company Info roda depois de domain e preenche as colunas de info, e o grupo de workflow Lead Score roda depois dessas e grava a pontuação. Cada linha avança pelos estágios de forma independente: no momento em que suas próprias colunas de Run-after estão preenchidas, ela fica elegível para o próximo grupo. Por isso algumas linhas na captura já estão totalmente pontuadas enquanto outras ainda estão no meio do pipeline.

Quando usar uma coluna de workflow

Use uma coluna de workflow quando você tem um trabalho linha a linha: enriquecer cada registro, classificar cada entrada, pontuar cada lead. O trabalho tem o mesmo formato em toda linha, e você quer que os resultados fiquem ao lado dos dados de origem.

Use um workflow sozinho quando o trabalho não é por linha: uma transformação pontual, uma agregação em várias linhas, ou uma decisão em tempo real ligada a um único pedido. Para puxar dados de tabela para um workflow em vez de empurrar resultados de workflow para uma tabela, veja usando tabelas em workflows.

Próximos passos