9.2 Base de conhecimento no Agentes de IA
3 min
Criado por Maria Malheiro em 09/11/2026 18:54
Atualizado por Maria Malheiro em 10/11/2026 10:01

A Base de conhecimento serve para criar e configurar uma Base de Conhecimento (Knowledge Base ou KB) para um assistente de inteligência artificial. Em termos simples, ela funciona como a criação de um "manual de instruções" ou "cérebro externo" personalizado que você dará ao seu agente de IA para que ele consulte antes de responder aos usuários.

  • Para acessar essa funcionalidade vá em Zenvia Customer Cloud > Agentes de IA.
  • Clique em Bases de conhecimento. 

Crie, edite e gerencie suas bases de conhecimento. Clique em Criar base de conhecimento +.

  1. Nome: Informe um nome para identificar a base.

  2. Nome da tool: Defina um nome da ferramenta que será utilizada pelo agente. Por exemplo: manual_suporte.

  3. Descrição: Adicione uma descrição explicando em quais situações o agente deverá consultar essa base.

  4. Clique em Salvar para enviar os documentos que serão utilizados como fontes de informação.

  5. Aguarde o processamento e a indexação dos arquivos. Quando a base estiver indexada, ela ficará disponível para utilização pelos agentes. Associe a base ao agente ao criar uma nova versão dele.


1. Entenda os status de indexação

Após o envio dos documentos, a plataforma acompanha o processamento de cada arquivo por meio de status.

Status

O que significa

Pendente

O documento foi enviado e aguarda o processamento.

Processando

A plataforma está realizando a indexação do arquivo.

Indexado

O processamento foi concluído e o documento está disponível para consulta.

Falhou​​

O processamento não foi concluído. É necessário verificar o arquivo e corrigir o problema.​​

A base de conhecimento só poderá ser utilizada pelo agente quando estiver indexada.

2. Como atualizar os documentos da base

Caso precise atualizar o conteúdo de um documento, substitua o arquivo correspondente na fonte de dados. Após a substituição, a plataforma iniciará um novo processo de indexação.

⚠️ Atenção: A substituição de um arquivo só é permitida quando a fonte de dados estiver com o status Indexado ou Falhou.

3. O que fazer quando um documento não é indexado?

Se um documento apresentar o status Falhou, verifique principalmente:

  • Se o arquivo ultrapassa o limite de 25 MB.

  • Se o formato é diferente de PDF, DOCX ou texto puro.

Para corrigir o problema:

  1. Verifique o tamanho do arquivo.

  2. Caso ultrapasse o limite, reduza seu tamanho ou divida o conteúdo em arquivos menores.

  3. Se necessário, converta o documento para um dos formatos aceitos.

  4. Substitua o arquivo na fonte de dados.

  5. Aguarde uma nova tentativa de indexação.