Passo 1 — Crie uma Nova Tabela
No menu lateral, acesse Tabelas (ou Datagrids). A tela exibe todas as tabelas existentes no workspace. Para criar uma nova:
- Clique em + Adicionar tabela no canto superior direito
- Um modal de criação será exibido com dois campos obrigatórios
- Nome: até 50 caracteres. Escolha um nome descritivo — o agente usa o nome para identificar qual tabela consultar quando há múltiplas disponíveis. Exemplos: “Catálogo de Produtos”, “Agenda Outubro 2025”, “Leads WhatsApp”.
Passo 2 — Adicione Colunas
Com a tabela criada, adicione as colunas que estruturam os dados. Clique em + Adicionar coluna na tela da tabela. O formulário de criação de coluna é aberto.
Para adicionar uma coluna:
Preencha os campos do formulário:
| Campo | Descrição | Requisitos |
|---|
| Nome | Identificador da coluna. O agente usa o nome para entender o que cada campo representa. | Máximo 50 caracteres. Use nomes claros: preco_reais, disponivel, descricao_produto. |
| Descrição | Explicação do propósito da coluna para o agente. Quanto mais específica, melhor o agente entende quando e como preencher o campo. | Mínimo 3 caracteres, máximo 250. |
| Tipo | Define qual valor a coluna aceita. Não pode ser alterado após a criação. | String, Number ou Boolean. |
| Busca semântica | Quando ativada, vetoriza os valores para busca por linguagem natural. Disponível apenas para colunas String. | Opcional. Recomendado para colunas com texto descritivo. |
O tipo da coluna é permanente. Planeje os tipos antes de criar as colunas — se precisar mudar de Number para String depois, será necessário criar uma nova coluna e migrar os dados manualmente.
Tipos de Coluna Suportados
| Tipo | Descrição | Exemplos |
|---|
String | Texto livre de qualquer comprimento. Suporta busca semântica quando ativada. | nome do produto, descrição, status, URL, categoria |
Number | Valor numérico, inteiro ou decimal. Permite comparações numéricas pelo agente. | preço em reais, quantidade em estoque, nota de 1 a 5, capacidade |
Boolean | Verdadeiro ou falso. Ideal para flags e condições binárias. | disponível, ativo, destaque, aceita parcelamento |
Passo 3 — Adicione e Edite Linhas
Com as colunas definidas, popule a tabela com dados. Há três formas de adicionar linhas:
- Adição manual: clique em + Adicionar linha na grade de dados e preencha os valores célula a célula diretamente na interface. Útil para tabelas pequenas ou para registros individuais.
- Importação via CSV: na tela da tabela, clique em Importar CSV. O arquivo deve ter cabeçalhos correspondentes exatamente aos nomes das colunas criadas. Valores de tipo incompatível geram erros de importação.
O editor de grade funciona como uma planilha — clicar em uma célula abre o editor inline, Tab avança para a próxima célula e as alterações são salvas individualmente por célula de forma imediata.
Passo 4 — Atualize ou Exclua Tabelas
Tabelas podem ser editadas a qualquer momento: adicione novas colunas, renomeie colunas existentes ou ajuste as descrições. Para excluir uma tabela:
- Na lista de tabelas, clique no menu de opções da tabela desejada.
- Selecione Excluir tabela.
- Confirme a exclusão na caixa de diálogo.
A exclusão de uma tabela é permanente e irreversível. Todos os dados (linhas e colunas) são apagados, e os agentes que usavam a tabela deixam de ter acesso a ela imediatamente. Desconecte a tabela dos agentes antes de excluí-la para evitar erros nas conversas em andamento.
