# 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:\
\
\&#xNAN;*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="" %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://sejasuri.gitbook.io/centraldeajuda/master/funcoes-administrativas/suri-assistant-ia-generativa.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.