Base de Conhecimento

A Base de Conhecimento é o repositório de informações que o assistente consulta ao responder. Ela implementa RAG (Retrieval-Augmented Generation): documentos são convertidos em vetores semânticos e, a cada mensagem recebida, os trechos mais relevantes são recuperados e injetados no contexto do LLM.

Como funciona

Documento enviado
      ↓
Extração de texto e vetorização
      ↓
Armazenamento em banco vetorial
      ↓
Usuário envia mensagem
      ↓
Busca por similaridade semântica
      ↓
Trechos relevantes injetados no prompt
      ↓
LLM responde com base nos trechos

Adicionando conteúdo

Acesse Assistente → Conhecimento e escolha uma das três formas de adicionar conteúdo:

Upload de arquivo

Arraste um arquivo para a área indicada ou clique para abrir o seletor. Formatos suportados:

Formato	Caso de uso típico
PDF	Manuais, políticas, catálogos, contratos
TXT / MD	Documentação técnica, textos simples
MP3 / MP4 / MPEG	Gravações de reuniões, aulas, podcasts (transcrição automática)

O progresso do upload é exibido em tempo real.

Adicionar site

Extrai e indexa o conteúdo de uma URL via web scraping.

Campo	Obrigatório	Descrição
Título	Sim	Identificador do conteúdo (3–48 caracteres)
URL	Sim	Endereço da página a ser coletada
Busca recursiva	Não	Coleta também páginas vinculadas do mesmo domínio

Use Busca recursiva com cuidado — ela pode indexar centenas de páginas e aumentar significativamente o tempo de processamento.

Adicionar texto

Cole ou escreva diretamente o conteúdo a ser indexado, sem precisar de um arquivo.

Campo	Obrigatório	Descrição
Título	Sim	Identificador do conteúdo (3–48 caracteres)
Texto	Sim	Conteúdo em texto livre (mínimo 10 caracteres)

Status de processamento

Após o envio, o conteúdo passa pelas seguintes etapas:

Status	Progresso	O que está acontecendo
`READY_TO_PROCESS`	0%	Na fila, aguardando processamento
`CONVERTING_TO_PDF`	25%	Extraindo e convertendo o conteúdo
`GENERATING_VECTORS`	50%	Gerando embeddings semânticos
`SAVING_VECTORS`	75%	Persistindo no banco vetorial
`DONE`	100%	Pronto — o assistente já pode consultar este conteúdo
`ERROR`	—	Falha no processamento; tente novamente

O status é verificado automaticamente a cada 5 segundos enquanto o processamento está em andamento.

Gerenciando arquivos

Visualizar conteúdo

Clique no ícone de olho para ver o texto extraído do documento, renderizado em markdown. A visualização usa scroll infinito para arquivos longos.

Editar

Permite alterar o título e o link de referência de um arquivo já indexado. O conteúdo vetorizado em si não pode ser alterado — para atualizar o conteúdo, exclua e recrie o arquivo.

Excluir

Remove o arquivo e todos os seus vetores permanentemente. Esta ação não pode ser desfeita.

Usando o conhecimento no prompt

Quando CustomPrompt está ativo, use a variável ${{conhecimento}} para controlar exatamente onde os trechos recuperados aparecem no prompt:

Você é um especialista em suporte técnico da Empresa X.
Responda APENAS com base nas informações abaixo:

=== DOCUMENTAÇÃO ===
${{conhecimento}}
=== FIM ===

Se a resposta não estiver na documentação acima, diga:
"Não encontrei essa informação. Posso conectar você com a nossa equipe técnica?"

Sem CustomPrompt, os trechos são inseridos automaticamente após o prompt principal. Veja Agentes Generativos para mais detalhes sobre CustomPrompt e ${{conhecimento}}.