1. Introdução

Este documento descreve o funcionamento do sistema web integrado ao ambiente ISOCRM, para gerenciamento de agentes virtuais e FAQs (perguntas frequentes). O objetivo é fornecer uma visão clara sobre como utilizar a aplicação, suas principais funcionalidades e fluxos de uso.

O sistema permite:

• Interagir com agentes virtuais por meio de uma interface de chat.

• Gerenciar agentes, definindo configurações como comportamento, prompts iniciais e bases de treinamento.

• Criar e editar FAQs para respostas automatizadas.

• Administrar agentes e FAQs em um painel com tabelas e formulários.

2. Visão Geral do Sistema

O sistema é composto por dois módulos principais:

1. Chat: Interface de chat para interação com agentes.

2. Agente: Painel administrativo para gerenciar agentes e FAQs.

2.2. Fluxo Geral

1. O usuário acessa a interface de chat para interagir com um agente virtual, selecionando-o em um dropdown e enviando mensagens.

2. O administrador utiliza o painel (Agente) para:

   • Criar/editar agentes, definindo personalizações (ex.: temperamento, nível de detalhamento).

   • Configurar prompts iniciais que aparecem como sugestões no chat.

   • Criar/editar FAQs associados aos agentes.

   • Treinar agentes com base em FAQs e prompts.

3. Módulo IsoAgente: Interface de Chat

O componente IsoAgente é a interface principal para interação com os agentes virtuais. Ele exibe um chat onde os usuários podem enviar mensagens e receber respostas automáticas.

3.1. Funcionalidades

• Seleção de Agente: Dropdown na parte superior para escolher um agente (ex.: Suporte Técnico).

• Prompts Iniciais: Sugestões de perguntas predefinidas exibidas em um dropdown abaixo do chat, baseadas no agente selecionado.

• Envio de Mensagens: Campo de texto para digitar perguntas.

• Exibição de Mensagens: Mensagens do usuário (à direita) e do agente (à esquerda).

• Atualização de Agentes: Botão para recarregar a lista de agentes disponíveis.

• Estado de Carregamento: Indicador visual quando o agente está "digitando" uma resposta.

3.2. Como Usar

1. Acesse a página do chat.

2. No topo, clique no dropdown de agentes e selecione um (ex.: isoCRM Agente).

3. Veja as sugestões de prompts iniciais no dropdown abaixo do chat. Clique em uma opção para preenchê-la no campo de texto.

5. Agora clique no passo 2 e  selecione o motivo cadastrado anteriormente e na descrição digite a ocorrência, essa ocorrência será utilizada para agrupar os FAQs, ao cadastrar as ocorrências desejadas aperte em "Salvar"

6. No passo 3, coloque no campo "Descrição" o valor "Agente" e salve

7. No passo 4, selecione o motivo, ocorrência e classificação da causa cadastrados anteriormente e preencha no campo "Descrição" o valor "Agente", caso tenha mais de uma ocorrência vai ser preciso inserir todas essas ocorrências na causa que está cadastro, apenas repita o mesmo passo mas alterando a ocorrência

8. Em seguida, feche o modal e clique no botão para vincular unidade, posicionado no canto inferior direito

9. Preencha todos os campos com os valores cadastrados anteriormente e selecione um unidade para vincular, caso tenha mais de uma ocorrência vai ser preciso vincular todas essas ocorrências na unidade selecionada 

4. Módulo Agente: Painel Administrativo

O componente Agente é o painel de administração, com duas abas: Agentes e FAQs.

4.1. Funcionalidades

• Abas de Navegação:

  • Agentes: Exibe uma grid com agentes cadastrados, permitindo ativar/desativar e editar.

  • FAQs: Exibe uma grid com FAQs, permitindo criar e editar.

• Criação/Edição de Agentes: Modal com formulário para configurar agentes, incluindo personalizações e prompts iniciais.

• Criação/Edição de FAQs: Modal com formulário para definir perguntas e respostas, com editor de texto rico.

• Busca e Filtros: Campo de busca para filtrar agentes e FAQs na tabela.

• Notificações: Mensagens de sucesso/erro para ações como salvar ou treinar agentes.

4.2. Como Usar

4.2.1. Gerenciando Agentes

1. Clique no botão "Configuração" e acesse o painel administrativo Agente.

2. Para criar um novo agente, clique no botão Adicionar Agente no topo.

3. No modal que abrir, preencha o formulário:

• Selecione um Usuário responsável.

• Insira uma Descrição para o agente.

• Escolha uma Base de Treinamento (ex.: Suporte interno).

• Defina Personalizações (ex.: Temperamento: Amigável, Foco: Preciso).

• Adicione Prompts Iniciais (perguntas e respostas sugeridas).

4. Clique em Salvar. Uma notificação confirmará o sucesso.

5. Para editar um agente, clique em uma linha da tabela. O mesmo formulário abrirá com os dados preenchidos.

6. Para ativar/desativar um agente, use o switch na coluna correspondente ou o botão "Desativar" que aparece ao clicar na linha correspondente ao agente desejado

7. Para treinar um agente, no formulário de edição, clique em Treinar. Uma notificação confirmará a conclusão.

4.2.2. Gerenciando FAQs

1. Clique na aba FAQs.

2. Para criar um novo FAQ, clique no botão Novo FAQ no topo.

3. No modal que abrir, preencha o formulário:

• Selecione uma Ocorrência (ex.: Suporte Técnico).

• Escolha uma Situação (ex.: Aberto).

• Digite a Pergunta.

• Escreva a Resposta usando o editor de texto rico.

4. Clique em Salvar. Uma notificação confirmará o sucesso.

5. Para editar um FAQ, clique em uma linha da tabela. O formulário abrirá com os dados preenchidos.

5. Considerações Finais

Com isso, já é possível utilizar os serviços de agentes para interagir com clientes, gerenciar respostas automatizadas e otimizar o atendimento no ambiente ISOCRM.