Page:
Knowledge Base e Agente Virtual
1
Knowledge Base e Agente Virtual
Rafael Alves Lopes edited this page 2026-05-27 16:51:03 -03:00
Knowledge Base e Agente Virtual
Base tecnica:
- Controller:
src/modules/admin/knowledge-base.controller.ts - Service:
src/modules/admin/knowledge-base.service.ts - Prefixo:
/admin/knowledge
Responsabilidade
Permite configurar o fluxo do Agente Virtual Sothis:
- arvore visual de decisao;
- nos de pergunta, encerramento e transferencia para agente;
- publicacao de versao;
- fluxo legado de audiencia/intencao;
- palavras-chave de roteamento por area.
Endpoints da arvore do bot
| Metodo | Rota | Descricao |
|---|---|---|
| GET | /admin/knowledge/bot-flow |
Retorna versao ativa/rascunho da arvore |
| GET | /admin/knowledge/bot-flow/versions |
Lista versoes |
| POST | /admin/knowledge/bot-flow/nodes |
Cria no |
| PUT | /admin/knowledge/bot-flow/nodes/:id |
Atualiza no |
| DELETE | /admin/knowledge/bot-flow/nodes/:id |
Remove no |
| POST | /admin/knowledge/bot-flow/publish |
Publica versao |
Endpoints de fluxo legado
| Metodo | Rota | Descricao |
|---|---|---|
| GET | /admin/knowledge/triage-flow |
Consulta fluxo configuravel |
| PUT | /admin/knowledge/triage-flow |
Atualiza perguntas/mensagens |
| POST | /admin/knowledge/triage-flow/audiences |
Cria audiencia |
| PUT | /admin/knowledge/triage-flow/audiences/:id |
Atualiza audiencia |
| POST | /admin/knowledge/triage-flow/intents |
Cria intencao |
| PUT | /admin/knowledge/triage-flow/intents/:id |
Atualiza intencao |
Endpoints de keywords
| Metodo | Rota | Descricao |
|---|---|---|
| GET | /admin/knowledge/routing-keywords |
Lista palavras-chave |
| POST | /admin/knowledge/routing-keywords |
Cria keyword |
| PUT | /admin/knowledge/routing-keywords/:id |
Atualiza keyword |
| DELETE | /admin/knowledge/routing-keywords/:id |
Remove keyword |
Relacao com WhatsApp
O WhatsApp chama routeIncomingMessage() em whatsapp-assignment.service.ts. Esse metodo tenta:
- fluxo builder publicado;
- fluxo configuravel legado;
- deteccao por keyword/area;
- fallback para suporte.
Code review
- Fluxo builder e fluxo legado coexistem; manter claro qual esta ativo.
- Publicacao de versao deve ser protegida por perfil.
- Textos do bot devem ser revisados para acento e tom.