As tags permitem anexar metadados estruturados aos documentos, para que o bloco Knowledge filtre os resultados com precisão — por departamento, data, prioridade, status ou qualquer dimensão que você definir.
Como as tags funcionam
As tags têm duas camadas:
- Definições de tag — criadas no nível da base de conhecimento. Uma definição tem um nome (por exemplo, "Department") e um tipo (Text, Number, Date ou Boolean). As definições são compartilhadas por todos os documentos.
- Valores de tag — definidos por documento. Depois que a definição existe, você atribui um valor a ela em cada documento que precisar (por exemplo,
Department = "engineering").
Slots de tag
Cada base de conhecimento tem 17 slots de tag distribuídos entre quatro tipos:
| Tipo | Slots | Valores aceitos |
|---|---|---|
| Text | 7 | Qualquer string — a correspondência ignora maiúsculas e minúsculas |
| Number | 5 | Qualquer número válido |
| Date | 2 | Formato YYYY-MM-DD |
| Boolean | 3 | true ou false |
O dropdown de tipo no formulário de criação mostra o uso atual de slots por tipo (por exemplo, Text (0/7) significa que nenhum dos 7 slots de texto está em uso).
Os slots são compartilhados por todos os documentos e connectors de uma base de conhecimento. Connectors que preenchem metadata tags automaticamente consomem do mesmo conjunto. Planeje o seu esquema com isso em mente.
Definir tags
As definições de tag ficam no nível da base de conhecimento. Para gerenciá-las, clique no nome da base de conhecimento no cabeçalho para abrir o menu de contexto e selecione Tags:
Isso abre o modal Tags, que lista todas as tags definidas e mostra a quantos documentos cada uma está atribuída. Clique em Add Tag para definir uma nova:
Informe um Tag Name, escolha um Type e clique em Create Tag. O nome deve ser único dentro da base de conhecimento. O dropdown de tipo mostra apenas os tipos que ainda têm slots disponíveis. Pressione Enter para enviar ou Escape para cancelar.
Para excluir uma definição de tag, clique no ícone de lixeira ao lado dela. Excluir uma definição remove o valor da tag de todos os documentos aos quais ela estava atribuída — o modal mostra quais documentos serão afetados antes de você confirmar.
Clicar em qualquer definição de tag existente abre um diálogo com todos os documentos que têm um valor definido para ela, junto com os valores atuais.
Definir valores de tag nos documentos
Depois que a definição existe, você atribui os valores documento por documento. Clique com o botão direito em qualquer documento (ou clique no menu …) para abrir o menu de contexto do documento e selecione Tags:
Isso abre o painel de tags daquele documento, onde você define um valor para cada tag existente.
Ver as tags na lista de documentos
A coluna Tags na lista de documentos mostra os valores de tag atuais de cada documento de forma rápida. Documentos sem nenhuma tag atribuída exibem – – –:
Use os controles Filter e Sort no canto superior direito para restringir a lista por valores de tag ou ordenar por eles.
Usar tags no bloco Knowledge
Em um workflow, abra o bloco Knowledge e configure os Tag Filters para restringir quais documentos são pesquisados:
Cada filtro tem três partes:
- Tag — selecione uma definição de tag da base de conhecimento
- Operator — depende do tipo da tag (veja abaixo)
- Value — o valor a ser comparado
Adicione quantos filtros precisar com o botão +. Vários filtros são combinados com lógica AND — um documento precisa atender a todos os filtros para entrar na busca.
Operadores por tipo
| Tipo | Operadores disponíveis |
|---|---|
| Text | equals, not equals, contains, does not contain, starts with, ends with |
| Number | equals, not equals, greater than, greater than or equal, less than, less than or equal, between |
| Date | equals, after, on or after, before, on or before, between |
| Boolean | is, is not |
Os valores de tag nos campos de filtro podem ser strings estáticas ou referências a variáveis do workflow (por exemplo, <start.department>), então a filtragem pode se adaptar dinamicamente em tempo de execução.
Modos de busca
O bloco Knowledge se comporta de formas diferentes conforme o que você fornece:
| O que você fornece | Comportamento |
|---|---|
| Somente tags (sem consulta de busca) | Retorna todos os documentos que atendem aos filtros de tag — correspondência pura por tag, sem busca vetorial |
| Somente consulta (sem filtros de tag) | Busca vetorial semântica em todos os documentos da base de conhecimento |
| Tags e consulta juntas | Os filtros de tag rodam primeiro para reduzir o conjunto de documentos, e a busca vetorial roda dentro desse subconjunto |
O modo combinado é o mais preciso — a filtragem por tag reduz o conjunto de candidatos de forma barata antes da comparação de similaridade vetorial, que é mais custosa.
Tags preenchidas por connectors
Os connectors podem preencher tags automaticamente com metadados da fonte. Um connector do Notion pode definir Last Modified e Labels; um connector do GitHub pode definir Repository e File Path. Elas funcionam exatamente como as tags definidas manualmente e ficam disponíveis nos filtros do bloco Knowledge.
Você pode desativar tipos específicos de metadata tag durante a configuração do connector ou nas configurações dele, liberando slots para uso manual. Veja Connectors para mais detalhes.