Diska

Knowledge Base

Como a Diska armazena e recupera conhecimento para os agentes.

Knowledge Base

A Knowledge Base (KB) permite que os agentes respondam com base em documentos, páginas web e texto manual.

Conceito

  • Uma organização pode ter várias KBs.
  • Cada KB tem uma instrução própria que orienta a recuperação.
  • Cada KB contém documentos.
  • Um agente pode ter várias KBs atribuídas.

Tipos de fonte

TipoDescrição
manualTexto inserido directamente na plataforma.
pdfPDF carregado; o backend extrai texto e divide em chunks.
urlPágina web importada.
crawlConjunto de páginas de um domínio com sincronização periódica.

Ciclo de vida de um documento

  1. pending: aguarda processamento.
  2. uploading: carregamento em curso (PDF).
  3. processing: extração e chunking.
  4. ready: documento pronto para recuperação.
  5. failed: erro no processamento.

Indexação

Após o processamento, os chunks passam por embedding e são indexados. O estado pode ser:

  • indexing_pending
  • indexed
  • failed
  • skipped

Recuperação

No runtime, o agente pode usar modos de recuperação:

  • retrieval: chunks relevantes.
  • full_doc_fallback: documento completo quando o chunk não é suficiente.
  • instructions_only: só usa a instrução da KB.
  • empty: nenhum documento incluído.

Atribuir a um agente

  1. Abra o agente.
  2. Aceda ao separador Knowledge.
  3. Escolha as KBs a ativar.
  4. Guarde e teste com a ferramenta de diagnóstico de KB.

Citações

Quando a KB é usada, o runtime pode devolver citações indicando qual documento e chunk originaram a resposta.

Seguinte

Depois de configurar a Knowledge Base, valide o agente no Centro de Testes.

Copyright © 2026