Consultar Base de Conhecimento
O que é
Seção intitulada “O que é”Ferramenta nativa que permite ao agente fazer busca semântica em uma ou mais bases de conhecimento da sua organização. Quando o agente precisa de informação específica (documentação de produto, FAQ, políticas internas, manuais), ele chama essa ferramenta e recebe trechos relevantes para usar na resposta.
É o coração do padrão RAG (Retrieval-Augmented Generation) no SquadOS.
Quando usar
Seção intitulada “Quando usar”- Atendimento que precisa responder com base em manuais, documentação de produto ou base de FAQ.
- Agentes internos que consultam políticas, procedimentos ou regras da empresa.
- Vendas que precisa citar especificações técnicas, preços ou descrições de produto.
- Qualquer caso em que você quer reduzir alucinação do modelo, ancorando as respostas em conteúdo controlado.
Configuração
Seção intitulada “Configuração”- Na aba Ferramentas do agente, clique em + Adicionar Ferramenta.
- Em FERRAMENTAS NATIVAS, escolha Consultar Base de Conhecimento.
- Ative o switch no topo do formulário.
- Preencha Descrição — explica para a IA quando usar a busca (ex.: “Use para consultar informações sobre nossos produtos, preços e políticas internas”).
- Marque as bases de conhecimento que esse agente pode consultar (uma ou várias).
- Clique em Salvar e Fechar.
A descrição é o sinal mais importante para o modelo decidir quando chamar a busca. Quanto mais específica, melhor — evite “use sempre que precisar de informação”.
Pré-requisito: criar a base
Seção intitulada “Pré-requisito: criar a base”Você precisa ter pelo menos uma base de conhecimento criada na organização. Se a lista estiver vazia, vá em Bases de Conhecimento no menu lateral e crie uma, adicionando documentos, URLs ou texto livre. Veja Bases de Conhecimento.
Como o agente invoca
Seção intitulada “Como o agente invoca”O agente decide chamar essa ferramenta quando a pergunta do usuário casa com a descrição que você preencheu. Por exemplo, com a descrição “consulta informações sobre nossos produtos”, o agente chama a busca quando alguém pergunta “quanto custa o plano Pro?”.
O retorno é um conjunto de trechos relevantes (com pontuação de similaridade). O agente então usa esses trechos para formular a resposta — e pode citar a fonte se você orientar isso no prompt.
Limitações e notas
Seção intitulada “Limitações e notas”- Sem base selecionada = ferramenta inútil. A ferramenta aparece como não configurada (amarelo) e o agente não consegue usar.
- Qualidade depende do conteúdo. Documentos mal organizados, repetidos ou desatualizados produzem respostas ruins. Cuide da curadoria da base.
- Busca semântica, não busca exata. O agente acha trechos por significado, não por palavra-chave literal. Para casos onde você precisa de match exato (código de produto, número de pedido), considere uma ferramenta HTTP customizada apontando para seu banco.
- Custo do prompt aumenta. Cada trecho retornado entra no contexto do modelo, consumindo tokens. Bases muito grandes podem encarecer cada turno.
- Combine com AutoLearn. Essa segunda ferramenta loga automaticamente as perguntas que a base atual não respondeu, ajudando você a evoluir o conteúdo.