> For the complete documentation index, see [llms.txt](https://sejasuri.gitbook.io/centraldeajuda/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sejasuri.gitbook.io/centraldeajuda/habilidades/suri-assistant-ia-generativa.md).
# Suri Assistant (IA Generativa)
A Suri Assistant se comporta como uma assistente virtual, conversando com seu cliente e serve para explicar processos da sua empresa, tirar dúvidas ou até mesmo auxiliar no suporte.
Um ponto de atenção: a Suri Assistant não é programada para realizar vendas, apenas para interações relacionadas a processos fixos da empresa.
Para ativar a Suri Assistant em sua plataforma, **é necessário verificar junto ao time de Suporte se o seu plano já possui essa funcionalidade ou se é necessária a sua atualização**, que assim que concluída, será ativada em sua plataforma para que o administrador da sua empresa possa realizar as configurações iniciais.
## Diretrizes para Configuração da IA
Siga as orientações abaixo para configurar corretamente o comportamento da sua IA, garantindo uma atuação alinhada com seus objetivos e necessidades:
#### Comportamento e Personalidade
Defina como a sua IA deve se expressar e interagir com os clientes. Para isso, responda:
* Qual será o tom da IA? Exemplo: acolhedora, objetiva, motivadora, descontraída etc.
* Como ela deve se comportar em diferentes situações? (ex.: manter a calma diante de críticas, incentivar o cliente em dúvidas frequentes).
Essas definições ajudam a construir a identidade da IA e tornam a experiência mais humanizada e consistente.\
#### **Funções e Objetivos**
Explique quais serão as atividades realizadas no dia a dia:
* A IA fará perguntas aos clientes? Quais?
* Quais tipos de dúvidas ou informações ela precisa responder? (ex.: acesso à plataforma, horários de atendimento, status de pedidos).
* Ela irá realizar interações proativas ou apenas reagir a comandos?
Definir esses pontos é essencial para guiar o uso correto da IA.\
#### **Tarefas e Comandos** Liste os comandos obrigatórios e as tarefas que a IA deve cumprir. Indique claramente:
* O que ela *sempre* deve fazer ou considerar em uma conversa.
* Quais informações ou documentos ela deve usar como base para suas respostas.
* Regras específicas que precisam ser seguidas (ex.: sempre verificar se o cliente já tem cadastro antes de enviar um link).\
#### Base de Conhecimento
Adicione todos os conteúdos que a IA utilizará como referência para gerar respostas assertivas. Essa base pode incluir:
* Perguntas frequentes (FAQ)
* Manuais, regulamentos, políticas da empresa
* Scripts de atendimento
* Informações específicas sobre produtos ou serviços
Quanto mais completa e atualizada for essa base, mais precisas serão as respostas da sua IA.
## Boas práticas de configuração da Suri Assistant
Para que a Suri Assistant funcione de forma eficiente e ofereça uma experiência fluida, orientamos que configurem dentro dentro de um menu, seguindo estas práticas:
1. **Evitar ativar no início da conversa ou no Boas-Vindas.**
* Se o cliente digitar algo logo após receber o menu, o sistema pode priorizar os botões ou frases gatilho em vez do *Suri Assistant*. Isso pode gerar confusão.
2. **Incluir o Suri Assistant em opções específicas do menu.**
* Exemplo:
* O cliente seleciona a opção Suporte no menu inicial.
* Dentro dessa opção, ele escolhe o assunto que pode ser Problemas.
* Nesse subfluxo, o Suri Assistant será habilitado e perguntará qual é o problema. O cliente poderá descrever o que está acontecendo (ex.: "Esqueci minha senha", "Conversas em branco", "Falhas de mensagens").
* O Suri Assistant analisará o texto, buscará a solução no banco de dados e oferecerá uma devolutiva conforme o assunto. Ele continuará a conversa, esclarecendo dúvidas e ajustando a resposta da forma mais adequada à necessidade do cliente.
3. **Evitar usar o Suri Assistant para qualificação de leads.**
* O Suri Assistant não foi projetado para realizar qualificações de leads, aquelas perguntas que algumas empresas fazem para segmentar ou entender melhor os clientes. Ele funciona melhor para resolver problemas específicos e oferecer soluções rápidas e precisas.
4. **Garantir um fluxo claro e funcional.**
* O cliente precisa de um menu inicial para se orientar e chegar até o tema ou problema que deseja resolver. Assim, o Suri Assistant poderá atuar de maneira direcionada, sem conflitos com botões ou gatilhos.
5. **Configuração das instruções.**
Especifique os objetivos e a finalidade do seu assistente priorizando por tópicos invés de colocar informações em formato de blocos. Abaixo iremos exemplificar como você deve realizar essa configuração do Suri Assistant:
*Você irá atender os clientes e ira tirar dúvidas sobre produtos para pets, promoções, compras, informações sobre entregas, informações sobre clinica veterinária, informações e diferença sobre o site e o aplicativo e enviar os links para acesso, informar endereços das lojas, horários de funcionamento das lojas. e ira explicar para os clientes por onde se faz compras para entregas. eu não quero que o assistente mude as palavras que estão na base de conhecimento.*
Use tópicos de instrução para o Suri Assistant, assim as informações presentes em sua base de conhecimento funcionarão de forma assertiva e com respostas precisas. Exemplo:
Você irá atender os clientes e irá tirar dúvidas sobre:
* produtos para pets, promoções, compras, informações sobre entrega
* informações sobre clinica veterinária
* informações e diferença sobre o site e o aplicativo, enviando os links de acesso
* informar endereços e horários de funcionamento das lojas
* tirar dúvidas sobre parcelamento de produtos seguindo a tabela de preços disponibilizada na base de conhecimento. Quando perguntado sobre parcelamento, sempre mandar a tabela completa para o usuário, mesmo que não saiba o preço do produto que ele está procurando parcelar
* explicar para os clientes por onde se faz compras para entrega
* recebimento de currículo para trabalhar conosco
* o assistente não deve mudar as palavras que estão na base de conhecimento.
* Quando não souber o preço de um produto que a pessoa está procurando, evitar dizer que não sabe, apenas orientar a compra via site ou app, informando os acessos
\
Em hipótese alguma dê uma resposta com uma informação que não está contido na base de conhecimento
Por que isso é importante?
* Configurar o Suri Assistant dessa forma garante que o seu cliente receba respostas precisas e que o chatbot funcione de maneira fluida.
* Caso contrário, o cliente pode acabar acessando informações fora de contexto, comprometendo a experiência e a percepção do serviço.\
\
\
**Atenção**: A IA não deve ser utilizada para vendas, e apresentar informações de preços, que podem estar presentes no site de sua empresa, pois o valor de um item pode mudar a qualquer momento devido a promoções, reajustes ou variações no estoque, e a IA poderia exibir informações desatualizadas visto que a base é estática e as repostas são generativas.
## Como configurar o Suri Assistant em sua plataforma
Com o acesso liberado dessa funcionalidade, o perfil de Administrador da plataforma irá acessar o menu lateral >> Habilidades >> Perfil >> Habilitar assistente no fluxo automático, no atendimento e no Suri Shop
\
Após habilitar o seu assistente virtual você irá escolher a forma de comunicação e tom de voz do assistente, onde há uma apresentação de cada comunicação, seguida de um exemplo:
Em seguida você deverá especificar os objetivos do Suri Assistant, priorizando as instruções em forma de tópicos, conforme apresentado no campo ***5. Configuração das instruções.***
Com o devido preenchimento das instruções de configuração você irá incluir a sua base de conhecimento que pode conter arquivos de extensões em .txt, .pdf, .html, .doc, .docx, .pptx além de sites que serão usados para orientar a Suri sobre como responder os clientes
**Pontos importantes:**
* a inclusão de sites serve apenas como material de apoio e não deve ser o único arquivo presente em sua base de conhecimento.
* os arquivos da base de conhecimento **NÃO DEVEM** conter imagens, sendo exclusivamente em formato de texto. Segue exemplo de um arquivo incorreto:
exemplo de arquivo incorreto na base de conhecimento
Priorize em sua base de conhecimento o uso de de arquivos, exemplo:
Exemplo de uma base conhecimento com arquivos em .txt, .docx, .pdf e com apenas dois sites complementares
\
Com a construção da sua base de conhecimento você poderá salvar as configurações no canto superior direito da página
\
Para casos em que a empresa queira que a IA informa valores, mesmo que já mencionado que isso não deve ser feito, indicamos que realizem uma configuração para que, sempre que o cliente pedir informações sobre preço, ele seja direcionado automaticamente para o catálogo de produtos. Assim, ele acessa os valores em tempo real, exatamente como estão no sistema de vendas, evitando qualquer divergência.\
\
Segue abaixo um prompt de exemplo a ser incluso na base de conhecimento para os casos em que a IA deva informar os valores:\
\
*IMPORTANTE: DIRETRIZ SOBRE VALORES E PREÇOS*\
*Você está estritamente proibida de informar valores, preços ou condições de pagamento, independentemente do produto.*\
*Se o cliente perguntar sobre qualquer item relacionado a preço ou formas de pagamento, responda da seguinte forma:*\
\
*“As informações sobre valores e detalhamento serão fornecidas por meio do nosso catálogo de produtos. Posso te encaminhar agora para que você visualize todo o nosso catálogo?”*\
\
*Essa resposta deve ser feita de forma persuasiva, incentivando o cliente a visualizar o catálogo.*\
\
*Em hipótese alguma tente estimar, sugerir ou supor preços.*
## Assista o vídeo tutorial abaixo:
{% embed url="" %}
### Ajuste de Temperatura
Agora é possível configurar a Temperatura, um recurso que define o nível de criatividade e variedade das respostas geradas.
#### Como funciona a escala
O valor da temperatura varia de 0 a 2 e funciona como uma balança entre precisão e imaginação.
**Temperatura 0 (Foco e Precisão):** O assistente prioriza a precisão técnica ao seguir a base de conhecimento e as instruções principais. É a escolha ideal para contextos que exigem dados concretos, pois as respostas são estruturadas com termos e palavras-chave extraídos diretamente da fonte. Ao evitar paráfrases ou alterações terminológicas, o modelo garante maior fidelidade às informações originais e minimiza o risco de alucinações.
**Temperatura 1 ou superior (Criatividade e Liberdade):** O assistente assume mais riscos e ganha liberdade para usar termos menos comuns, resultando em textos mais originais e fluídos.
#### Pontos de atenção e recomendações
Cada nível de configuração possui particularidades que você deve considerar ao configurar seu bot:
**Limitação por Rigidez:** Com a temperatura em 0, o assistente pode ter dificuldade em ajudar o cliente caso ele saia do tema previsto, já que o robô está muito preso ao roteiro original.
**Risco de Imprevisibilidade:** Em valores próximos a 1 ou superiores, o assistente pode se tornar hiper criativo e, em alguns casos, ignorar instruções básicas em favor de uma resposta mais elaborada.
**O Equilíbrio Ideal:** O segredo está em adaptar o valor ao contexto. Para um assistente jurídico ou médico, onde a precisão é vital, valores entre 0,2 e 0,3 são recomendados. Para um assistente de conversas gerais ou marketing, um valor próximo a 0,8 costuma funcionar bem.
**Dica de Especialista:** Embora a escala chegue a 2, recomendamos manter a temperatura abaixo de 1 para garantir que seu assistente permaneça estável e confiável.
#### Exemplos Práticos
Para ilustrar a diferença, veja como o assistente responderia à pergunta: *Quais são os benefícios de se exercitar?*
**Com Temperatura 0** A resposta será direta e objetiva: O exercício melhora a saúde do coração, aumenta a força muscular e auxilia no controle do peso e na prevenção de doenças.
**Com Temperatura 1** A resposta ganha um tom mais lúdico e variado: Praticar atividades físicas é como uma alquimia que transforma o esforço em vitalidade, sendo um ritual que renova o corpo e a mente através do movimento constante.
