- Visão Geral
- APIs
Smart Tables são um recurso de gerenciamento de dados estruturados dentro da Base de Conhecimento (KB) que permitem armazenar, organizar e extrair informações em formato tabular. Diferente de planilhas padrão, as Smart Tables são integradas com capacidades de IA, permitindo extração automática de dados a partir de documentos, mapeamento de relacionamentos entre diferentes conjuntos de dados (Collections) e consulta direta via Agentes de IA.Principais capacidades incluem:
O agente executa uma consulta na Smart Table e retorna a resposta em linguagem natural.
- Definir esquemas estruturados — colunas, tipos de dados e formatos
- Extrair dados automaticamente de arquivos carregados (ex.: Currículos, Faturas)
- Visualizar dados por meio de dashboards integrados
- Consultar dados da tabela usando linguagem natural via Agentes
Acessando as Smart Tables
As Smart Tables são acessadas por meio da seção Knowledge Base (KB) da aplicação. Uma vez criadas, você pode visualizar e gerenciar suas Smart Tables navegando até a seção KB Data, onde todas as tabelas estão listadas e podem ser abertas para visualização ou edição.Criando Smart Tables
Existem três métodos principais para criar uma Smart Table dentro da Base de Conhecimento. Acesse essas opções clicando no menu de criação na interface da KB.Método A: Criar Smart Table Vazia
Esta opção cria uma tabela em branco com colunas padrão do sistema (Title, Description, Number). Um painel de configuração na barra lateral abre automaticamente, permitindo que você defina seu esquema personalizado do zero. Você pode manter esses campos padrão, modificá-los ou excluí-los para criar sua própria estrutura.Método B: Criar a partir de Template
Você pode selecionar entre templates pré-definidos para configurar rapidamente tabelas para casos de uso comuns. Vários templates estão disponíveis para diferentes cenários. Por exemplo, o Evaluations Template importa um conjunto pré-definido de colunas projetado para testar respostas de agentes (Question Text, Expected Answer, Actual Response).Método C: Importar de Arquivo
Você pode carregar um arquivo CSV para criar automaticamente uma Smart Table. O sistema analisará os cabeçalhos do CSV para criar colunas e importar as linhas como entradas de dados.Tipos de Coluna e Configuração
Ao configurar uma Smart Table, cada coluna requer definições específicas para garantir armazenamento e extração precisos de dados. Uma coluna consiste em um Nome, Tipo, Formato e Tool Source.Fornecer uma Descrição clara para cada coluna é fundamental. Esta descrição orienta o Large Language Model (LLM) sobre quais informações específicas extrair ou gerar para aquele campo.
Configurando Colunas
Ao criar ou editar uma Smart Table, use o painel da barra lateral para configurar cada coluna. Após definir as propriedades de um campo (Nome, Tipo, Formato, Tool e Descrição), clique em Save Field para aplicar a configuração. Você pode editar campos existentes a qualquer momento clicando no nome do campo no painel de configuração da coluna, fazendo alterações e salvando novamente.Tipos de Campo e Formatos
| Tipo de Campo | Descrição | Opções de Formato |
|---|---|---|
| Text | String alfanumérica padrão | Text, Phone Number, Email |
| Number | Valores numéricos | Number, Decimal, Currency |
| Single Select | Selecione um valor de uma lista pré-definida | Dropdown com opções (ex.: Skill Level: Beginner, Intermediate, Expert) |
| Multi-select | Selecione múltiplos valores de uma lista pré-definida | Lista de opções (ex.: Languages: Python, Java, HTML, CSS) |
| Checkbox | Valores booleanos (Verdadeiro/Falso) | True/False (ex.: Is Female?) |
| Date | Datas de calendário | Formatos de data (DD/MM/YYYY, etc.) |
| User | Referência a um usuário no sistema | Nome de usuário ou E-mail do Usuário |
| File | Campo de anexo para documentos | Upload de arquivo |
| Collection | Vínculo com outra Smart Table (relacional) | Selecione a Smart Table de destino |
Fontes de Tool
A configuração Tool define como os dados entram na célula:- User Input — Dados inseridos manualmente pelo usuário ou extraídos diretamente de um arquivo sem modificação
- LLM Generated — O modelo de IA gera o conteúdo com base na descrição da coluna e no contexto (ex.: resumindo um currículo)
- Agent Generated — Um Agente processa uma consulta e preenche este campo com a resposta
-
Comparison — Compara dois campos e determina se correspondem ou calcula pontuações de similaridade
Extração de Dados (Processamento de Documentos)
As Smart Tables podem preencher linhas automaticamente extraindo dados de documentos carregados. Isso é particularmente útil para processar documentos padronizados como currículos ou formulários. Cada documento carregado cria uma linha na Smart Table, embora múltiplos documentos possam ser carregados e processados para criar múltiplas linhas na mesma tabela.Fluxo de Trabalho: Exemplo de Extração de Currículo
Definir Esquema
Crie uma Smart Table chamada “Resumes” com as seguintes colunas:
- Name (Text)
- Contact Number (Text — formato Phone Number)
- Years of Experience (Number — formato Decimal)
- Languages (Multi-select: Python, Java, HTML, CSS)
- Is Female (Checkbox)
- Resume File (File)
Carregar Documento
Navegue até a Base de Conhecimento e carregue um arquivo (ex.: um currículo em PDF).
Extração
O sistema processa o documento e mapeia o conteúdo para as colunas definidas — por exemplo, encontrando “3 years” no texto e preenchendo Years of Experience, ou extraindo um número de telefone para Contact Number.
Collections e Relacionamentos
Collections permitem mapeamentos muitos-para-muitos entre Smart Tables. Isso é útil quando uma única linha em uma tabela principal contém dados de lista complexos que requerem sua própria estrutura.Exemplo: Mapeamento de Habilidades
Em vez de armazenar habilidades como uma simples string separada por vírgulas (ex.: “Python, Java”), você pode criar uma estrutura relacional com informações detalhadas de habilidades:-
Crie a Tabela “Skills” — Defina colunas:
- Skill Name (Text) — Nome da habilidade que o usuário possui
- Skill Level (Single Select) — Opções: Beginner, Intermediate, Expert
- Configure a Tabela Principal — Na tabela “Resumes”, crie uma coluna chamada “Skills”.
- Defina o Tipo como Collection — Defina o tipo da coluna como Collection e vincule à Smart Table “Skills”.
-
Resultado — Quando um currículo é processado, o sistema extrai as habilidades e preenche a tabela “Skills” com linhas detalhadas (ex.: “Python - Expert”, “Java - Beginner”, “AWS - Intermediate”) vinculadas de volta ao candidato específico por meio do relacionamento muitos-para-muitos.
Visualizando Dados de Collection
Ao visualizar a tabela principal (ex.: Resumes), o campo Collection exibe um vínculo para as entradas relacionadas. Clicando nele, você navega até a tabela vinculada (ex.: Skills) onde pode ver todas as entradas detalhadas para aquele candidato. O relacionamento é bidirecional — você pode visualizar a qual currículo cada habilidade pertence verificando a Content Key na tabela Skills.Gerenciamento de Dados
Uma vez que os dados são preenchidos, você tem várias ferramentas para gerenciá-los e organizá-los.Visualizações e Abas
As Smart Tables fornecem duas visualizações:- Table View — A visualização padrão estilo planilha para visualizar e editar linhas e colunas
-
Dashboard View — Uma visualização onde você pode criar gráficos e widgets para analisar seus dados
Adicionando e Gerenciando Linhas
- Inserir Linha — Clique em Add Row ou Insert Row para adicionar manualmente uma nova linha em branco
-
Criação Automática de Linhas — Quando um documento é carregado e atribuído a uma Smart Table, uma nova linha é automaticamente criada e preenchida com dados extraídos
Editando e Recalculando
- Edição Manual — Clique em qualquer célula para atualizar manualmente o valor
- Executar Célula/Linha — Para campos gerados por LLM ou Agente, clique em Execute Cell ou Execute Row para calcular ou atualizar os dados daquela linha
-
Recalcular Tudo — Atualiza todas as linhas simultaneamente. Útil após atualizar descrições de colunas ou configurações de agentes para reprocessar todo o conjunto de dados
Cada linha recebe automaticamente um identificador único Content Key que a vincula de volta ao documento fonte. Isso permite rastreabilidade entre dados extraídos e arquivos originais.
Agrupando e Organizando
Você pode agrupar dados por colunas específicas para organizar a visualização. Por exemplo, agrupar uma lista de candidatos pelo campo multi-select “Language” permite ver todos os desenvolvedores Python juntos. As colunas também podem ser reorganizadas arrastando e reposicionando-as na visualização de tabela.Renomeando Smart Tables
Clique no nome da tabela no topo e insira um novo nome. Isso ajuda a organizar múltiplas tabelas com identificadores descritivos (ex.: “Resumes”, “Skills”, “Evaluations”).Excluindo Campos e Linhas
- Excluir Coluna — Ao editar a configuração de uma coluna, selecione Delete Field para remover a coluna inteiramente
- Excluir Linha — Clique em uma linha e selecione Delete para remover entradas individuais
Dashboards e Visualização
As Smart Tables incluem uma visualização de Dashboard integrada para visualizar os dados armazenados.Criando Widgets
- Navegue até a aba Dashboard dentro da Smart Table
- Clique em Add Widget
-
Configure o gráfico:
- Widget Title — Forneça um título descritivo (ex.: “Total de Candidatos por Gênero”)
- Chart Type — Selecione entre Pie Chart, Bar Chart, Line Chart e outros
- X-Axis (Category) — Selecione o campo de agrupamento (ex.: Is Female)
- Y-Axis (Value) — Selecione a métrica a medir, com funções de agregação como Contagem, Soma ou Média
- Y-Series Column Name — Opcionalmente personalize o rótulo exibido na legenda do gráfico
-
Salve o widget para adicioná-lo ao dashboard
Consultando Smart Tables via Agentes
Uma das funcionalidades mais poderosas das Smart Tables é a capacidade de consultar dados estruturados usando linguagem natural por meio de um Agente.Processo de Configuração
Selecionar Smart Tables
Nas configurações do toolkit, selecione uma ou mais Smart Tables que o agente deve ter acesso. Isso permite que o agente consulte múltiplas tabelas relacionadas simultaneamente.
Configurar Opções de Consulta
Desmarque opções desnecessárias como “Database Query” ou “Database Schema” se você deseja que o agente acesse apenas dados de Smart Tables.
Templates
Os Templates aceleram a configuração fornecendo estruturas de colunas pré-configuradas para casos de uso comuns. Você pode selecionar entre templates existentes, mas não pode criar templates personalizados por meio da interface.Template de Avaliação
Projetado para testar o desempenho de Agentes e validar respostas de IA. Inclui:- Question Text — O prompt de entrada para o agente (User Input)
- Expected Answer — A resposta correta ou padrão-ouro (User Input)
- Actual Response — Preenchida pelo agente durante a execução da avaliação (Agent Generated)
- Evaluation Status — Compara Actual Response com Expected Answer e retorna uma porcentagem de aprovação/reprovação (Comparison)
- Crie uma Smart Table a partir do template Evaluations
- Adicione linhas com suas perguntas de teste e respostas esperadas
- Configure o campo Agent para conectar ao seu agente de IA
- Execute linhas individuais ou execute Re-compute All para testar todas as perguntas
-
Revise a Actual Response e o Evaluation Status para avaliar o desempenho do agente
Melhores Práticas
- Descrições de Colunas — Escreva texto claro e descritivo para cada coluna para guiar o LLM durante a extração. Por exemplo, nomeie uma coluna “Years of Experience” e adicione: “Total de anos de experiência profissional encontrados no currículo.”
- Tipos de Dados — Use tipos específicos (Number vs. Text) para habilitar ordenação, filtragem e criação de gráficos precisos. Use Number para “Years of Experience” em vez de Text.
- Seleção de Formato — Escolha formatos apropriados por tipo de campo. Use o formato Phone Number para campos de contato; use o formato Currency para valores monetários.
- Collections — Use Collections para listas complexas (Habilidades, Certificações, Histórico Educacional) para manter a integridade dos dados e habilitar consultas mais profundas.
- Testes — Teste com um ou dois documentos primeiro para verificar se as descrições das colunas estão orientando a IA corretamente antes de fazer upload em lote.
- Quick Upload — Habilite o Quick Upload ao atribuir uma Smart Table durante o carregamento para extrair e preencher dados imediatamente.
- Reaplicar Extração — Se você modificar as definições das colunas, reatribua a Smart Table aos documentos existentes para reextrair dados com a configuração atualizada.
- Campos de Comparação — Use Comparison para cenários de validação, como comparar resultados esperados vs. reais em fluxos de trabalho de QA.
As Smart Tables também podem acionar e interagir com Workflows (Actions), habilitando lógica avançada como “Se o Currículo Qualificar, enviar e-mail.” Consulte a documentação de Workflow Automation para mais detalhes.