Concept

Visão geral

Uma tabela é uma grade de colunas tipadas no seu workspace, como uma planilha com schema. Use uma para guardar dados de referência, coletar o que seus workflows produzem ou armazenar os registros estruturados que seus agentes leem e escrevem.

Tipos de coluna

Toda coluna tem um tipo, que decide como seus valores são armazenados e validados.

TipoGuardaExemplo
TextUma string livre"Acme Corp"
NumberUm valor numérico42
Booleantrue ou falsetrue
DateUma data2026-03-16
JSONUm objeto ou array{ "tier": "pro" }

Os tipos são aplicados conforme você digita os valores, então uma coluna Number só aceita números.

Editando uma tabela

Abra a seção Tables na barra lateral e clique em New table para criar uma. Adicione colunas pelo cabeçalho, digite em uma célula para editá-la e cole linhas de uma planilha para carregar em massa. Filtre e ordene pela barra de ferramentas sem alterar os dados subjacentes. O editor tem suporte completo a teclado; veja atalhos de teclado.

Tabelas em workflows

Um bloco Table lê e escreve linhas de dentro de um workflow: consulte linhas para dados de referência, grave resultados de volta ou processe um lote. Uma coluna de workflow vai além e executa um workflow contra cada linha por conta própria. Tudo em uma tabela também está disponível pela API REST.

Próximos passos

Common Questions

Tabelas foram feitas para conjuntos de trabalho. Para as muito grandes (100 mil+ linhas), pagine as leituras pela API ou divida os dados em várias tabelas.
Sim. Copie linhas de qualquer planilha e cole direto na tabela; os valores são validados contra os tipos das colunas.
Não. Tabelas armazenam dados brutos. Use a lógica do workflow (um bloco Function ou Agent) para calcular valores e gravá-los de volta.
Sim. As escritas são atômicas no nível da linha, então vários workflows podem escrever na mesma tabela ao mesmo tempo.
Use o bloco Table: selecione a tabela, escolha uma operação (query, insert, update) e configure os campos.
Sim. Tabelas têm escopo de workspace e estão disponíveis a todos os membros com as permissões certas.
No editor de tabela, Cmd/Ctrl+Z desfaz edições recentes de célula, inserções e exclusões de linha. Alterações feitas pela API não entram no histórico de desfazer do editor.

On this page