AutoLearn

O que é

AutoLearn registra perguntas que o agente deveria responder com as bases vinculadas, mas para as quais a busca não encontrou material adequado. Cada registro vira uma oportunidade de aprendizado para revisão humana.

O recurso não publica respostas sozinho e não treina o modelo. Depois da revisão, ele cria um item de texto na base escolhida; esse item só fica disponível para novas consultas quando o processamento do índice termina.

Ativar no agente

AutoLearn é gerenciado na seção Conhecimento, não em Ferramentas:

1. Abra Agentes, selecione o agente e entre em Conhecimento.
2. Marque pelo menos uma base em Bases de conhecimento. Isso ativa Consultar Base de Conhecimento e faz o painel AutoLearn aparecer.
3. Ative o interruptor AutoLearn.
4. Se já houver oportunidades pendentes desse agente, confira até três delas no painel ou selecione Revisar todas.
5. Selecione Salvar na barra de alterações.

Se a última base for desmarcada, AutoLearn também é desligado no mesmo salvamento. Para salvar a configuração, a pessoa precisa das capacidades agents.write e bases.write.

Quando uma oportunidade é registrada

AutoLearn só está disponível no runtime quando suas duas condições estão ativas: o próprio interruptor e a busca com pelo menos uma base vinculada.

Quando search_knowledge_base devolve exatamente “Nenhuma informação relevante encontrada na base de conhecimento.”, a instrução interna exige que o modelo chame report_missing_knowledge antes de responder. O modelo também pode chamar a ferramenta quando os trechos encontrados tratam claramente de outro assunto. Ele não deve registrar conversa casual, tema fora do escopo ou pergunta que o agente não deveria responder.

A chamada envia:

• question: obrigatória, reescrita como pergunta genérica e reutilizável;
• suggested_answer: rascunho opcional para a pessoa revisar;
• suggested_base_id: base vinculada sugerida, quando houver uma adequada;
• reasoning: motivo opcional da classificação.

Nome, e-mail, telefone, documento, número de pedido e outros dados do caso não devem entrar nesses campos. Essa proteção depende da instrução seguida pelo modelo; revise o texto antes de incluí-lo na base.

O retorno da ferramenta é interno. Depois de registrar ou reencontrar a lacuna, o agente continua a resposta normalmente; o cliente não recebe o status técnico do registro.

Como perguntas parecidas são agrupadas

Antes de criar uma oportunidade, o runtime procura uma pergunta pendente parecida para o mesmo agente e organização. A comparação usa similaridade de texto com limiar superior a 0,7.

Quando encontra uma correspondência, o sistema:

• aumenta Ocorrências;
• atualiza Última ocorrência;
• acrescenta a conversa à lista de origem, sem repetir o mesmo ID.

O agrupamento não cruza agentes e considera somente oportunidades pendentes. Uma pergunta semelhante a uma oportunidade já ignorada ou aprovada pode criar um novo registro. Chamadas simultâneas também podem escapar da conferência e gerar duplicatas; trate a lista como uma fila de triagem, não como uma contagem exata de intenções únicas.

Revisar a fila

Abra Bases de Conhecimento → AutoLearn. A rota mostra apenas oportunidades pendentes e ordena primeiro as mais recorrentes, usando a ocorrência mais recente como desempate.

A tabela exibe Pergunta, Agente, Ocorrências, Última ocorrência, Base de destino e Ações. Você pode:

• filtrar por agente;
• filtrar pela base sugerida, inclusive Sem base sugerida;
• exportar as linhas filtradas em CSV;
• selecionar uma ou várias linhas para ignorar;
• abrir Revisar e incluir em uma oportunidade.

A página exige bases.view. Na implementação auditada, os controles de criação e descarte não aplicam uma segunda trava visual de bases.write; conceda acesso à fila somente a funções autorizadas a alterar o acervo.

Revisar e incluir na base

1. Selecione Revisar e incluir.
2. Escolha a Base de destino. A sugestão do agente é apenas um ponto de partida e pode ser trocada.
3. Revise a Pergunta e a Resposta. Os dois campos são obrigatórios para continuar; a resposta sugerida pode ser apenas uma hipótese e deve ser validada contra a informação oficial.
4. Remova qualquer dado pessoal ou específico da conversa.
5. Selecione Criar item na base.

A pergunta vira o nome do novo item e a resposta vira seu conteúdo. Embora o campo aceite até 2.000 caracteres, o nome gravado é limitado silenciosamente a 200 caracteres; mantenha a pergunta curta e confira o item pelo atalho Editar item exibido após a criação.

O novo item nasce com processamento pendente. A criação do item e a resolução da oportunidade são duas gravações sequenciais; se a segunda falhar, confira a base antes de tentar novamente para não criar uma duplicata.

Ignorar e diagnosticar

• Ignorar: muda o status para descartado e remove a oportunidade da lista pendente. A confirmação diz que a remoção é permanente, mas o registro não é apagado; o toast oferece Desfazer por cinco segundos. Depois disso, a interface atual não possui histórico para restaurá-lo.
• Nenhuma oportunidade aparece: confirme que existe uma base vinculada, AutoLearn foi ativado e as alterações do agente foram salvas. O registro ainda depende de o modelo chamar a ferramenta no estado de lacuna.
• A pergunta existente não foi agrupada: o agrupamento usa texto, agente e status. Formulações diferentes, agentes diferentes ou itens já resolvidos podem gerar outra linha.
• A resposta ainda não é encontrada: abra o item criado e confira se o processamento do índice terminou sem erro. Aprovar a oportunidade não torna o conteúdo consultável imediatamente.
• Erro ao registrar: falhas na busca de similares, atualização ou inserção fazem a ferramenta retornar um erro interno ao modelo. A conversa continua, mas a oportunidade pode não ter sido salva.