Oportunidades de Aprendizado (AutoLearn)

Oportunidades de Aprendizado são perguntas que seus usuários fizeram e que o agente não conseguiu responder com o conteúdo atual das bases. Em vez de descobrir isso depois pelos logs, o SquadOS as registra automaticamente para o admin revisar.

A lista fica em Admin → Bases de Conhecimento → AutoLearn. O contador ao lado da aba mostra quantas oportunidades estão aguardando revisão.

Pré-requisitos no agente

Para o agente gerar oportunidades, ele precisa ter as duas ferramentas nativas ativas:

• Consultar Base de Conhecimento, com pelo menos uma base marcada;
• AutoLearn.

Sem a busca à base, o AutoLearn não tem como saber que faltou conteúdo.

Como funciona

Quando o agente consulta a base e não acha resposta suficiente, ele aciona o AutoLearn por baixo dos panos. A ferramenta registra:

• a pergunta original do usuário;
• o agente que estava na conversa;
• uma base de destino sugerida (quando aplicável);
• uma sugestão de resposta inicial (quando o agente conseguiu propor uma).

Perguntas parecidas são agregadas automaticamente por similaridade. Se dez usuários diferentes perguntam essencialmente a mesma coisa, você vê uma única linha com 10x no contador de ocorrências, não dez linhas repetidas.

A tabela

Cada linha mostra:

• Pergunta — texto agregado.
• Agente — agente de origem.
• Ocorrências — quantas vezes a pergunta apareceu.
• Última ocorrência — tempo desde a última aparição.
• Base de destino — base sugerida (ou — quando não há sugestão).
• Ações: Ignorar e Revisar (botão primário roxo).

Use os filtros Todos os agentes e Todas as bases no topo direito para focar.

Revisar e incluir na base

Clicar em Revisar abre o modal “Revisar e incluir na base”:

1. Base de destino — vem pré-selecionada (a base sugerida quando houver, senão a primeira da lista). Você pode trocar.
2. Pergunta — editável; ajuste para deixar mais clara se precisar.
3. Resposta — pré-preenchida com a sugestão do agente quando disponível. A responsabilidade do conteúdo final é sua — revise antes de incluir.
4. Clique em Criar item na base.

O novo item entra na fila de processamento normal da base. Quando ficar Processado, o agente já consegue usar essa resposta nas próximas conversas. A notificação de sucesso traz um atalho Editar item para abrir o item recém-criado e fazer ajustes adicionais.

Ignorar uma oportunidade

Use Ignorar quando a pergunta não deve virar conteúdo, por exemplo:

• pergunta fora do escopo do agente;
• assunto sensível que o agente não deve responder;
• duplicata de algo que já existe e só precisa de ajuste no item original;
• ruído (texto sem sentido, teste, spam).

Você pode ignorar uma de cada vez ou selecionar várias com os checkboxes e usar Ignorar selecionadas na barra de ações em massa. Ignorou por engano? A notificação traz a opção Desfazer por alguns segundos.

Boas práticas

• Revise com frequência. Quanto mais cedo as oportunidades viram conteúdo, menos usuários passam pela mesma experiência ruim.
• Cuidado com a base de destino sugerida. Quando não fizer sentido, troque para a base correta antes de criar. Conteúdo no lugar certo melhora a recuperação.
• Priorize por ocorrências. Perguntas com muitas ocorrências afetam mais gente.
• Se a mesma pergunta volta após você já ter criado a resposta, o conteúdo provavelmente existe na base mas está confuso ou usa termos diferentes dos usuários. Reescreva o item original em vez de criar um novo.
• Considere também o prompt. Se o agente não está citando a base de forma explícita, ajuste o prompt para reforçar quando consultar.