Tags permitem anexar metadados estruturados a documentos para que o bloco Knowledge filtre resultados com precisão — por departamento, data, prioridade, status ou qualquer dimensão que você definir.
Como as tags funcionam
Tags têm duas camadas:
- Definições de tag — criadas no nível da base de conhecimento. Uma definição tem um nome (ex.: "Department") e um tipo (Text, Number, Date ou Boolean). Definições são compartilhadas entre todos os documentos.
- Valores de tag — definidos por documento. Depois que uma definição existe, você atribui um valor a ela em cada documento que precisa (ex.:
Department = "engineering").
Slots de tag
Cada base de conhecimento tem 17 slots de tag distribuídos em quatro tipos:
| Tipo | Slots | Valores aceitos |
|---|---|---|
| Text | 7 | Qualquer string — o matching é case-insensitive |
| 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 de cada tipo (ex.: Text (0/7) significa que nenhum dos 7 slots de texto está em uso ainda).
Slots são compartilhados entre todos os documentos e conectores de uma base de conhecimento. Conectores que preenchem tags de metadados automaticamente consomem o mesmo pool. Planeje seu schema com isso em mente.
Definindo tags
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 em 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 precisa ser único na base de conhecimento. O dropdown de tipo só mostra 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. Excluir uma definição remove o valor da tag de todo documento a que estava atribuída — o modal mostra quais documentos são afetados antes de você confirmar.
Clicar em qualquer definição de tag existente abre um diálogo mostrando todos os documentos que têm um valor definido para ela, junto com seus valores de tag atuais.
Definindo valores de tag em documentos
Depois que uma definição existe, você atribui valores documento a 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ê pode definir um valor para cada tag definida.
Vendo tags na lista de documentos
A coluna Tags na lista de documentos mostra os valores de tag atuais de cada documento de relance. Documentos sem tags atribuídas mostram – – –:
Use os controles Filter e Sort no canto superior direito para restringir a lista por valores de tag ou ordenar por eles.
Usando tags no bloco Knowledge
Em um workflow, abra o bloco Knowledge e configure Tag Filters para restringir quais documentos são buscados:
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 comparar
Adicione quantos filtros precisar com o botão +. Vários filtros são combinados com lógica AND — um documento precisa corresponder a todos os filtros para ser incluído 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 |
Valores de tag nos campos de filtro podem ser strings estáticas ou referências a variáveis de workflow (ex.: <start.department>), então a filtragem pode se adaptar dinamicamente em runtime.
Modos de busca
O bloco Knowledge se comporta de forma diferente conforme o que você fornece:
| O que você fornece | Comportamento |
|---|---|
| Só tags (sem search query) | Busca todos os documentos que correspondem aos filtros de tag — matching puro de tags, sem busca vetorial |
| Só query (sem filtros de tag) | Busca semântica vetorial em todos os documentos da base de conhecimento |
| Tags e query | Filtros de tag rodam primeiro para restringir o conjunto de documentos, depois a busca vetorial roda nesse subconjunto |
O modo combinado é o mais preciso — a filtragem por tags reduz o conjunto de candidatos de forma barata antes da comparação de similaridade vetorial, mais cara.
Tags preenchidas por conectores
Conectores podem preencher tags automaticamente com metadados da fonte. Um conector Notion pode definir Last Modified e Labels; um conector GitHub pode definir Repository e File Path. Elas funcionam exatamente como tags definidas manualmente e ficam disponíveis nos filtros do bloco Knowledge.
Você pode desabilitar tipos específicos de tag de metadados na configuração do conector ou nas settings do conector para liberar slots para uso manual. Veja Conectores para detalhes.