Pular para o conteúdo

Busca Semântica

A busca semântica melhora a forma como os Agentes consultam Tables: as consultas usam significado e contexto, não só a palavra exata.

Quando Habilitar busca semântica está ligado em uma coluna, a Zaia indexa o texto dessa coluna. O Agente pode então encontrar linhas relacionadas mesmo quando o vocabulário da pergunta é diferente do texto gravado.

Se um usuário perguntar:

“Mostre quem perguntou sobre campanhas”

O Agente pode recuperar linhas de uma coluna Question mesmo que nenhuma mencione a palavra “campanhas”, desde que o significado esteja alinhado (por exemplo, “fluxos de marketing” ou “mensagens em massa”).


Ative em campos descritivos ou em linguagem natural (string):

  • Question, Feedback, Message, Description

Não ative em campos curtos, categóricos ou estruturados:

  • ID, Status, Type, flags booleanas

Na coluna, o interruptor se chama Habilitar busca semântica. Detalhes de criação: Criando Tables.


Quando pelo menos uma coluna da Table tem busca semântica habilitada, a grade mostra uma coluna somente leitura Embedding, com um ícone de informação no cabeçalho.

Cada linha mostra um destes estados:

Estado O que significa
Pendente Aguardando indexação para busca semântica
Processando Gerando o índice da linha
Concluído Disponível para busca semântica
Erro Falha no processamento

O tooltip do cabeçalho Embedding descreve esses quatro estados.

Grade de Table com a coluna Embedding e os estados Pendente, Processando, Concluído e Erro

A linha pode já estar visível na grade e ainda assim não entrar na busca do Agente. A tool de busca semântica encontra a linha quando o estado é Concluído.

Se o estado for Erro, a coluna não oferece botão para reprocessar. Recarregue a Table para ver se o estado mudou; se o Erro permanecer, fale com o suporte.


  1. Abra Builder → Tabelas.
  2. Abra a Table que tem ao menos uma coluna com Habilitar busca semântica.
  3. Na grade, localize a coluna Embedding.
  4. Confira o estado da linha antes de esperar que o Agente a encontre por significado.

Linhas novas ou células recém-editadas em colunas semânticas voltam para Pendente ou Processando até o índice ficar pronto.