Tables — Visão Geral

As Tables na Zaia Endless são estruturas de dados dinâmicas que permitem aos seus Agentes armazenar, acessar e gerenciar informações em tempo real.
Elas funcionam como bancos de dados leves e amigáveis para IA, que os Agentes podem ler e nos quais podem gravar — dando suporte a workflows estruturados como cadastro de contatos, rastreamento de leads, dúvidas não respondidas e coleta de feedback.

Uma Table pode ser totalmente gerenciada dentro da interface do Builder, com ferramentas para criar, editar e vinculá-la a um ou mais Agentes.

🧩 Conceitos Fundamentais

Conceito	Descrição
Table	Um conjunto de dados dinâmico usado por Agentes para armazenar ou recuperar informações.
Columns	Definem a estrutura da sua Table — de forma semelhante aos campos de um banco de dados.
Rows	Cada entrada ou registro na sua Table.
Semantic Search	Um recurso que permite aos Agentes consultar dados usando significado e contexto, não apenas palavras-chave. Com a opção ligada, a grade mostra a coluna Embedding.

Cada célula string aceita até 4.000 caracteres. Se a Table tiver uma coluna de texto, o Workspace mostra um aviso de que células com muitos caracteres podem afetar a performance do agente. Detalhes de criação, importação e o aviso: Criando Tables.

💡 Por que as Tables São Importantes

As Tables ampliam as capacidades de memória e lógica dos seus Agentes ao fornecer:

Armazenamento persistente — Agentes podem registrar interações de usuários ou perguntas não respondidas.
Inteligência estruturada — os dados podem ser filtrados, consultados e usados como base para raciocínio.
Colaboração — conjuntos de dados compartilhados podem ser usados em múltiplos Agentes ou Squads.
Automação — as Tables se integram perfeitamente a workflows, triggers e tools.

Exemplos de casos de uso:

Registro de “Unanswered Questions” para treinamento ou revisão.
Table de “Contacts” para gestão de leads.
Table de “Feedbacks” para acompanhamento de qualidade.

Carregando listas mais longas

Listas suportadas carregam a próxima página automaticamente quando você chega ao fim da área de rolagem. Isso substitui a ação manual Load more nas listas já migradas e mantém a navegação contínua.

Esse comportamento se aplica às listas de Agentes, Squads, Tools, Workflows, Automações, Datagrids, Datasets, Executions, Tiers, External Groups e API Keys.

Se a primeira página não preencher a altura disponível, a Zaia continua carregando até que a lista possa rolar ou não restem mais resultados.
Atualizar a página, mudar uma busca ou aplicar um filtro impede que resultados de uma requisição anterior sejam anexados à nova lista.
Chegar ao fim depois que a paginação se esgota não dispara novas requisições.
Remover um item preserva a posição do usuário sempre que possível.

Algumas listas mantêm uma ação manual de Load more quando a paginação automática não é adequada. A lista de External Users atualmente segue essa exceção.

Ordenar listas do Builder

Nas listas de Agentes, Ferramentas, Workflows, Conhecimento, Tabelas, Squads e Gatilhos, clique no cabeçalho de uma coluna de texto ou data para ordenar a lista inteira.

Cada clique cicla crescente → decrescente → ordem padrão. Detalhes e colunas por tela: Como ordenar as listas do Builder.