> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Knowledge base

> Alimente o agente com documentos e URLs que ele pode consultar para responder durante a chamada.

A **knowledge base** são os documentos ou URLs que o agente pode consultar para responder. Serve para que ele resolva perguntas frequentes com informação confiável, sem depender de uma chamada às suas APIs nem de que tudo esteja escrito no prompt.

Fica na aba **Knowledge base** do editor do agente.

<Frame caption="Aba Knowledge base com uma fonte carregada">
  <img src="https://mintcdn.com/jelouai/AQag8di7NYjLixU_/assets/images/voice/agente-knowledge-base.png?fit=max&auto=format&n=AQag8di7NYjLixU_&q=85&s=e589f0e7dfab29346d4e9c1b717136dd" alt="Seção Knowledge base com o botão Adicionar fonte e uma fonte do tipo FILE listada com a ação de excluir" width="1444" height="424" data-path="assets/images/voice/agente-knowledge-base.png" />
</Frame>

## Adicionar uma fonte

Com **+ Adicionar fonte** você incorpora conhecimento de duas formas:

* **Um arquivo**, por exemplo o manual de um produto, uma tabela de preços ou um documento de objeções frequentes.
* **Uma URL**, por exemplo a sua página pública de perguntas frequentes.

Cada fonte aparece na lista com o seu nome e uma etiqueta que indica o tipo, e pode ser excluída dali.

## O que convém colocar aqui e o que não

A knowledge base e o prompt do sistema resolvem coisas diferentes, e confundi-los é o erro mais comum.

| Vai no prompt                           | Vai na knowledge base                     |
| --------------------------------------- | ----------------------------------------- |
| Como o agente deve se comportar         | Qual informação ele deve conhecer         |
| O tom, as regras, a ordem das perguntas | Tarifas, coberturas, políticas, catálogos |
| Quando transferir ou encerrar           | Respostas a perguntas frequentes          |

<Tip>
  Se você se pegar colando tabelas de preços ou listas longas dentro do prompt do sistema, esse conteúdo pertence à knowledge base. O prompt define comportamento; a knowledge base, conteúdo.
</Tip>

<Note>
  Quanto melhor curada essa base estiver, menos o agente dependerá de [ferramentas HTTP](/pt/guias/voice/tools) para resolver intenções simples, e uma consulta à knowledge base não adiciona latência de rede à chamada.
</Note>

## Considerações para voz

Um documento pensado para ser lido não funciona sempre igual quando a resposta vai ser **ouvida**. Duas coisas ajudam:

**Evite tabelas complexas e notas de rodapé.** O agente terá de verbalizá-las e o resultado costuma ser uma resposta longa e difícil de acompanhar. Um parágrafo curto por conceito se escuta muito melhor.

**Escreva os números como são falados.** Se o documento diz "USD 4.500,00", vale também ter "quatro mil e quinhentos dólares" para que o agente não improvise a leitura.

<Warning>
  A knowledge base não substitui a validação. Para dados que mudam, como um saldo, o status de um pedido ou a disponibilidade de uma vaga, use uma ferramenta HTTP contra os seus sistemas. Um documento fica desatualizado sem que ninguém perceba.
</Warning>
