Criando Tables

Criar uma nova Table na Zaia Endless é rápido e flexível.
Você pode criar uma Table manualmente ou importar uma a partir de um arquivo XLSX, e depois personalizar suas colunas, tipos e capacidades semânticas.

---

🪄 Passo 1 — Criar uma Nova Table

Opção A — Criar manualmente

1. Navegue até Builder → Tables.
2. Clique em Create new table + no canto superior direito.
3. Informe os seguintes detalhes:
   • Name — o identificador da Table (ex.: Unanswered Questions, Feedbacks, Contacts).
   • Description (opcional) — para uso interno, descrevendo o propósito dessa Table.

Clique em Create Table para finalizar.

Opção B — Importar de XLSX

1. Navegue até Builder → Tables.
2. Inicie a ação de importação a partir da lista de Tables.
3. No modal de importação:
   • Informe o Table name.
   • Baixe o arquivo modelo (template), se necessário.
   • Faça upload de um único arquivo XLSX.
4. Confirme a importação.

Se o arquivo for válido, a Zaia Endless cria a Table, redireciona você até ela e exibe uma mensagem de sucesso.

⚠️ Revise as colunas importadas:
Após a importação, a Zaia Endless mantém um aviso visível até que a descrição e o tipo de dado de cada coluna importada tenham sido revisados.

Regras e validações da importação

• Apenas arquivos XLSX são suportados.
• Você só pode fazer upload de um arquivo por vez.
• O arquivo anexado mostra seu nome, tamanho e uma ação de remoção antes da importação.
• Use nomes de coluna únicos na planilha. Nomes de coluna duplicados impedem a importação.
• Se o formato do arquivo for inválido, a Zaia Endless exibe um erro e oferece novamente o download do template.
• Se o arquivo tiver problemas de contagem de linhas ou colunas, a Zaia Endless mostra o erro diretamente na área de upload.

---

📋 Passo 2 — Adicionar ou Revisar Colunas

As colunas definem a estrutura e o comportamento da sua Table.
Elas determinam que tipo de dado cada registro vai armazenar e como o Agente vai interpretá-lo.

➕ Para adicionar uma coluna:

1. Abra sua Table.
2. Clique em Add Column +.
3. Configure os seguintes campos:

Campo	Descrição
Name	O nome da coluna. Cada um deve ser único dentro da Table.
Description	Descreva claramente o que a coluna representa — o Agente usa isso para interpretar e interagir com os dados corretamente.
Type	Escolha um dos tipos de campo suportados (string, boolean, number ou file).
Enable Semantic Search	Quando ativado, permite que o Agente consulte essa coluna com base em significado e contexto, e não apenas em correspondência exata de texto. Recomendado para campos descritivos ou de texto livre.

Clique em Add Column para salvar.

🧠 Dica: escreva descrições claras e específicas — o Agente as lê para inferir a intenção e entender como usar os dados.

Se você importou a Table de um XLSX, revise cada coluna importada antes de usá-la em produção.

---

🔧 Tipos de Coluna Suportados

A Zaia Endless atualmente suporta quatro tipos de dado para colunas de Table:

Tipo	Descrição	Exemplo
string	Informação textual, como nomes, mensagens ou identificadores.	"John Doe", "user_123", "Asked about campaign creation"
boolean	Valores lógicos representando true ou false. Ideal para flags ou lógica condicional.	true, false
number	Dados numéricos, como contadores, pontuações ou avaliações.	42, 3.14
file	Arquivos enviados e armazenados na Table. Suporta arquivos PNG e PDF de até 10 MB.	contract.pdf, receipt.png

⚙️ Boa prática:
Use string para a maioria dos campos de texto descritivo e ative a busca semântica para campos em que os Agentes precisam interpretar o significado — por exemplo, perguntas, feedbacks ou mensagens.

📎 Limite de coluna de arquivo:
Colunas do tipo file aceitam apenas uploads PNG e PDF, com tamanho máximo de 10 MB por arquivo.

---

🧱 Passo 3 — Adicionar e Editar Linhas

As linhas representam os dados reais armazenados dentro da Table.
Você pode adicionar linhas manualmente ou deixar que sejam criadas dinamicamente por Agentes ou Workflows.

➕ Para adicionar uma linha:

• Clique em Add row + e preencha o valor de cada coluna.

✏️ Para editar uma linha:

• Passe o mouse sobre um registro, clique no ícone ⋮ (Edit) e faça as alterações necessárias.

Exemplo — Table Unanswered Questions:

chatId	Name	Question
5edca67d-dd2d-41e4-b7c0-23e4858f05e6	—	“User asked if it’s possible to create proactive campaigns…”

---

📤 Exportar uma Table para XLSX

Você pode exportar uma Table em dois lugares:

• Em Builder → Tables.
• De dentro da própria Table.

Ao exportar, a Zaia Endless processa o arquivo e o envia por e-mail.
Ela não inicia um download imediato no navegador.

A interface mostra se a solicitação de exportação teve sucesso ou falhou.

---

🧩 Passo 4 — Atualizar ou Excluir Tables

Você pode modificar os metadados de uma Table a qualquer momento:

• Clique no botão ✏️ Edit para atualizar o nome ou a descrição.
• Clique no menu ⋮ para reorganizar ou excluir uma Table.

⚠️ Aviso:
Excluir uma Table remove permanentemente todos os seus dados — essa ação não pode ser desfeita.