Organizar o conhecimento em pastas

Quando a base do agente passa de algumas dezenas de conteúdos, achar um item vira trabalho. As pastas resolvem isso. Elas ficam em Inteligência › Agentes, no agente, aba Conhecimento.

Como uma pasta nasce

Não existe botão de criar pasta. Ela nasce junto com o conteúdo: ao salvar um conteúdo, ligue Organizar em uma pasta, escolha uma existente ou use Criar nova pasta. A pasta é criada ao salvar.

Pelo mesmo motivo, pasta que fica vazia desaparece sozinha — e a pasta acima dela também, se ficar vazia. Não há lixo acumulado de organização antiga.

Ler a lista sem precisar de legenda

  • O ícone diz o tipo. Pasta é amarela, como em qualquer explorador de arquivos: dá para ver de longe onde se entra. Os outros tipos têm cada um a sua cor, e o nome do tipo aparece ao passar o mouse sobre o ícone.
  • Embaixo do nome da pasta vem o que ela tem: quantos conteúdos, quantas subpastas e a descrição, quando você escreveu uma. Descrição é opcional, e pasta sem descrição simplesmente não mostra nada ali.
  • O contador acima da lista conta o galho inteiro: 1019 conteúdos nas pastas quando não há nada solto no nível, ou 6 conteúdos aqui · 300 com as subpastas quando há os dois. Com busca ou filtro ligado, ele mostra quantos apareceram do total.
  • A busca e o filtro de tipo só aparecem a partir de 10 conteúdos no galho. Abaixo disso, a lista é a tela.

Navegar e buscar

Clique no card da pasta para entrar. A trilha no topo começa em Conhecimento e volta em um clique. Buscar dentro de uma pasta varre também as subpastas; se você quiser sair do galho, use Buscar em todo o conhecimento.

Para renomear ou escrever a descrição, use o lápis no card da pasta.

Nada aqui precisa ser salvo

A aba Conhecimento não tem botão Salvar. Adicionar conteúdo, criar e renomear pasta, aceitar sugestão, ativar e desativar: tudo grava na hora. As abas Geral e APIs continuam com Salvar, porque ali são formulários.

Para quem integra: montar a estrutura pela API

Dá para criar pastas vazias por API, antes de existir conteúdo — útil ao migrar de outra ferramenta ou espelhar uma árvore de arquivos. Use POST /api/v1/ai/knowledge-folders com a chave de API no cabeçalho Authorization.

  • {"name": "Financeiro"} cria uma pasta num nível. Com parent_id, cria dentro de outra.
  • {"path": "Financeiro / Boletos / Sicoob"} cria a cadeia inteira, aproveitando o que já existe. Repetir a chamada não duplica nada — devolve a mesma pasta —, o que é justamente o que um script precisa.
  • description é opcional e só é aplicada à última pasta do caminho, e apenas se ela ainda não tiver uma. Repetir a chamada não apaga o que alguém escreveu na tela.
  • Nome repetido entre pastas irmãs é recusado. O mesmo nome num nível abaixo é outra pasta, e é aceito.

Dois avisos: não existe exclusão de pasta pela API, e a pasta que esvaziar depois vai embora sozinha. Na tela nada mudou — o botão de criar pasta continua não existindo; a pasta segue nascendo junto com o conteúdo.