Pular para o conteúdo principal

Como adicionar conhecimento

Alimente seus agentes com documentos, sites e coleções organizadas para respostas precisas (RAG).

Este guia explica como adicionar e organizar conhecimento para que seus agentes possam usá-lo ao responder aos usuários. O conhecimento é gerenciado em três partes: Fontes (sites e documentos), Coleções (grupos de fontes) e Vínculos (qual agente usa qual coleção).

Como acessar​

  1. No menu, vá em Treffen AI → Agentes.
  2. Na lista de Agentes, clique no botão Conhecimento do Agente (ou abra a página de Conhecimento pela navegação do app).

A página de Conhecimento fica em /agents/knowledge.

Visão geral​

No topo da página você vê um resumo: total de fontes, total de coleções, quantidade de documentos, de sites e quantas fontes estão em processamento.

A página tem três abas:

AbaFinalidade
FontesAdicionar e gerenciar sites e documentos que alimentam a base de conhecimento.
ColeçõesCriar e gerenciar grupos de fontes (ex.: “Documentação do produto”, “FAQ”).
VínculosVincular agentes a coleções para que cada agente use o conhecimento correto.

Os agentes só usam conhecimento das coleções às quais estão vinculados. O fluxo usual é: criar coleções → adicionar fontes às coleções → vincular agentes às coleções.

Aba Fontes​

O que são fontes?
Fontes são as entradas da sua base de conhecimento: sites (URLs) ou documentos (arquivos enviados). O sistema processa esses dados para que os agentes possam recuperar conteúdo relevante ao responder.

Formatos suportados​

  • Sites: Qualquer URL que você adicionar.
  • Documentos: PDF, DOC, DOCX, TXT, MD, JSON, CSV. Tamanho máximo do arquivo: 50 MB.

Adicionar uma fonte​

  1. Clique em Adicionar fonte.
  2. Escolha o tipo de fonte: Site ou Documento.
  3. Site: Informe a URL.
    Documento: Use o seletor de arquivo ou arraste e solte para enviar um arquivo.
  4. Selecione a Coleção à qual esta fonte pertence (obrigatório). É preciso ter pelo menos uma coleção antes de adicionar fontes; crie uma na aba Coleções se necessário.
  5. Opcionalmente defina prioridade, categoria e tags se o formulário oferecer.
  6. Salve. A fonte aparece na lista e passará pelo processamento (Pendente → Processando → Concluído ou Falhou).

Gerenciar fontes​

  • Use Pesquisar e Filtrar por coleção para encontrar fontes rapidamente.
  • Use Editar para alterar URL, arquivo, coleção ou outros campos.
  • Use Excluir para remover uma fonte. Confirme quando solicitado.

Status​

Cada fonte tem um status:

  • Pendente – Ainda não processada.
  • Processando – Em processamento.
  • Concluído – Pronta para uso.
  • Falhou – O processamento falhou; pode ser necessário corrigir a URL ou o arquivo e tentar novamente.

Aba Coleções​

O que são coleções?
Coleções (também exibidas como “Buckets” na interface) são grupos de fontes. Elas ajudam a organizar o conhecimento (ex.: “Documentação do produto”, “FAQ”, “Preços”) e depois atribuir esse conhecimento a agentes específicos por meio dos Vínculos.

Adicionar uma coleção​

  1. Abra a aba Coleções (ou “Buckets”).
  2. Clique em Adicionar coleção (ou “Adicionar bucket”).
  3. Informe o nome (obrigatório) e, se quiser, uma descrição.
  4. Você pode Definir como padrão se quiser que esta coleção seja a padrão para novas fontes.
  5. Salve. A coleção aparece na lista.

Gerenciar coleções​

  • Use Editar para alterar nome ou descrição.
  • Use Excluir para remover uma coleção. Atenção: Excluir uma coleção também afeta as fontes nela (elas deixam de pertencer a essa coleção). Qualquer vínculo entre agentes e esta coleção deixa de valer.

Aba Vínculos​

O que são vínculos?
Vínculos conectam agentes a coleções. Um agente só usa conhecimento das coleções às quais está vinculado. Depois de ter coleções e fontes, você vincula as coleções certas a cada agente.

Adicionar um vínculo​

  1. Abra a aba Vínculos.
  2. Clique em Adicionar vínculo (ou “Criar vínculo”).
  3. Selecione um Agente na lista (obrigatório).
  4. Selecione uma Coleção na lista (obrigatório).
  5. Salve. O novo vínculo aparece na tabela (nome do agente + nome da coleção).

Gerenciar vínculos​

  • A tabela lista todos os vínculos agente–coleção.
  • Use Excluir (ou a ação de excluir na linha) para remover um vínculo. O agente deixará de usar o conhecimento dessa coleção. Confirme quando solicitado.

Ordem sugerida para novos usuários​

  1. Criar coleções – ex.: “FAQ”, “Documentação do produto”.
  2. Adicionar fontes – Adicione sites ou envie documentos e atribua cada fonte a uma coleção.
  3. Vincular agentes às coleções – Na aba Vínculos, vincule cada agente às coleções que devem alimentar suas respostas.

Depois disso, seus agentes usarão o conhecimento vinculado ao responder. Você pode adicionar mais fontes ou vínculos a qualquer momento.