Visão Geral

No SquadOS, Bases de Conhecimento é a área para organizar o conteúdo que os agentes podem consultar ou receber durante uma conversa. No painel administrativo, abra Bases de Conhecimento. O acesso à seção exige a permissão bases.view.

O que existe na área de conhecimento

As abas têm finalidades diferentes:

Aba	Para que serve	Quando o conteúdo chega ao agente
Bases Vetorizadas	Organiza textos, FAQs e documentos pesquisáveis.	Somente quando o agente pesquisa uma base vinculada.
AutoLearn	Reúne perguntas que o agente não conseguiu responder pelas bases.	Não envia conteúdo ao agente; cria uma fila de revisão.
Contextos	Mantém blocos curtos de informação fixa.	O bloco vinculado é enviado por completo em toda resposta.
Arquivos	Organiza documentos que agentes podem ler, buscar e arquivar.	Depende do fluxo que usa o arquivo. Esta aba está em preview e pode não aparecer para sua organização.

Use Contextos para regras ou fatos curtos que precisam acompanhar todas as respostas. Use uma base vetorizada para materiais maiores que só devem ser consultados quando forem relevantes. Veja também Oportunidades de Aprendizado (AutoLearn).

O que a lista de bases mostra

A aba Bases Vetorizadas contém uma busca por nome e apresenta, em cada base:

• nome e descrição;
• quantidade de itens;
• tamanho total em tokens;
• data da última atualização.

Selecione a linha da base no computador, ou o card no celular, para abrir seus itens. A listagem não oferece ações por linha: renomear, editar a descrição e excluir a base acontecem dentro da própria base.

Se várias bases que você sabe estarem preenchidas aparecerem ao mesmo tempo com 0 itens e 0 tokens, recarregue a página e abra uma delas para conferir o conteúdo. A listagem atual pode transformar uma falha na leitura dos totais em zeros; esses números, isoladamente, não provam que a base está vazia.

Criar uma base

É preciso ter bases.write para criar ou editar uma base.

1. Na aba Bases Vetorizadas, selecione Nova Base.
2. Leia a confirmação Criar nova base de conhecimento e selecione Criar base.
3. O SquadOS cria a base sem pedir campos nessa etapa e abre sua página.
4. Edite o nome e a descrição diretamente no cabeçalho da base.
5. Adicione documentos ou texto e espere cada item concluir o processamento antes de testar o agente.

O nome inicial é gerado no idioma da interface, como Base de conhecimento #1. A numeração considera os nomes genéricos em português e inglês que já existem na organização. Para excluir uma base, também é necessária a permissão bases.delete; a ação fica no menu dentro da base.

Escreva uma descrição específica. O agente recebe os nomes e as descrições das bases vinculadas e usa esse catálogo para decidir onde pesquisar. Uma base sem descrição fornece apenas o nome como pista.

Como a consulta funciona

O SquadOS processa os itens da base em trechos pesquisáveis. Na estratégia padrão atual, a consulta combina busca semântica por vetores com busca textual por termos, une e reordena os resultados e entrega ao agente apenas os trechos selecionados. Se a estratégia híbrida não estiver disponível, o runtime usa a busca vetorial legada como fallback.

Isso é RAG (Retrieval-Augmented Generation): a base inteira não é anexada ao prompt. Uma execução bem-sucedida da ferramenta também não garante que o trecho certo foi encontrado. Títulos claros, conteúdo processado e termos usados pelos clientes melhoram a recuperação. Teste perguntas reais e confirme tanto o que o agente encontrou quanto o que ele deixou de encontrar. Veja os limites e o diagnóstico da ferramenta Buscar Base de Conhecimento.

Conectar a base ao agente

Criar e preencher a base não a conecta automaticamente.

1. Abra o agente que deve consultar o conteúdo.
2. Entre em Conhecimento.
3. Em Bases de conhecimento, marque uma ou mais bases.
4. Opcionalmente, escreva uma regra exclusiva para esse agente.
5. Salve as alterações do agente.

Ao menos uma base precisa estar marcada. Quando isso acontece, a ferramenta nativa de consulta é ativada automaticamente; ela não é adicionada pela área Ferramentas. Consulte o passo a passo em Conectando a Agentes.

Base, contexto ou prompt?

• Use o prompt do sistema para comportamento, tom, limites e processo decisório.
• Use uma base vetorizada para conteúdo extenso e pesquisável, como políticas, catálogos, manuais e procedimentos.
• Use um contexto para informação curta que deve acompanhar toda resposta, mesmo quando não houver pesquisa.

Não dependa apenas do prompt para armazenar um manual inteiro e não use uma base para esconder uma regra de segurança que o agente deve seguir em todas as mensagens.

Checklist de validação

Antes de colocar o agente em atendimento:

1. confirme que os itens terminaram o processamento;
2. dê à base um nome e uma descrição que diferenciem seu conteúdo;
3. organize os itens e remova versões conflitantes;
4. vincule somente as bases necessárias ao agente;
5. faça perguntas com a linguagem real dos clientes;
6. confira as fontes retornadas e teste também uma pergunta que a base não deve responder.