# Chatbot com IA

Um assistente de IA é um verdadeiro avanço: agora você pode configurar chatbots com IA para interagir com seus clientes usando funções prontas e previamente configuradas.

<div data-with-frame="true"><figure><img src="/files/55abc2bf6228c9c1b43ec592258eafbcf79a5ede" alt="" width="375"><figcaption></figcaption></figure></div>

Ao configurar um chatbot com IA, você poderá:

1. Criar um consultor para todos os serviços disponíveis na sua filial.
2. Gerar textos para newsletters e apresentações: basta fornecer ao chatbot uma tarefa e uma mensagem-chave e depois aproveitar o resultado.
3. Desenvolver uma loja online usando o Google Sheets.
4. Agendar clientes online diretamente no seu sistema de CRM.
5. Combinar diferentes assistentes de IA com várias configurações.

{% hint style="success" %}
Ele responde e gera respostas com precisão com base nas suas configurações exclusivas — uma ferramenta poderosa totalmente personalizada para atender exatamente às suas necessidades e exigências.

Basta explicar sua tarefa para o bot (como se fosse uma pessoa), relaxar e aproveitar o trabalho dele!
{% endhint %}

{% hint style="warning" %}

## Importante

Uma mensagem do assistente de IA equivale a **10 mensagens comuns** no uso do seu construtor de funis.
{% endhint %}

{% hint style="success" %}

## Observe

O assistente de IA é multilíngue e pode se comunicar com clientes em vários idiomas. Observe que, para idiomas diferentes do seu conjunto principal de treinamento, a precisão da sintaxe e da ortografia pode variar.
{% endhint %}

{% hint style="danger" %}

## Atenção

O sistema prioriza os blocos do construtor de funis acima do assistente de IA. Todos os blocos no construtor de funis são executados antes de qualquer resposta do assistente de IA, inclusive blocos sem lógica condicional.
{% endhint %}

{% hint style="danger" %}

## Atenção&#x20;

A interface de testes é compartilhada entre o **Assistente de IA** e o **construtor de chatbot**.

**Comportamento principal a entender:**

1. **Sistema unificado:** O **Assistente de IA** e **Construtor de chatbot** não são ferramentas separadas; elas funcionam juntas como um único, **chatbot unificado**.
2. **Prioridade de processamento:** **Os blocos do construtor de chatbot sempre têm precedência.** Se você receber uma mensagem inesperada durante os testes, provavelmente é porque um bloco do Construtor de Funis foi acionado primeiro.
3. **Etapa de solução de problemas:** se o assistente de IA se comportar de forma inesperada ou enviar mensagens que não correspondam às suas configurações, sempre **verifique primeiro os blocos do Construtor de Funis**, pois eles substituem as respostas do assistente.
   {% endhint %}

{% hint style="warning" %}

## Observe

O assistente de IA não funciona em chats em grupo.
{% endhint %}

## O que são funções de chatbot

As funções definem as tarefas funcionais específicas e as características comportamentais que o assistente de IA é configurado para executar e exibir durante as interações com o usuário.

<div data-with-frame="true"><figure><img src="/files/998fe4208f2c3c668bb3d5c314947948432448a9" alt="" width="563"><figcaption></figcaption></figure></div>

Para sua comodidade, a equipe da MaviBot já configurou várias funções prontas para usar em seus projetos.

No entanto, se esses bots não atenderem às suas necessidades específicas e você souber trabalhar com IA, sinta-se à vontade para escolher a **opção "Sem configurações predefinidas"**.

Se você precisar de um chatbot com IA adaptado a um modelo de comportamento específico, pode escolher entre as seguintes funções padrão

### **Assistente de respostas baseadas em texto**

O modelo é estritamente limitado ao conhecimento e às informações contidas em suas configurações. Ele responde apenas a perguntas relacionadas ao texto incorporado em sua configuração.

<div data-with-frame="true"><figure><img src="/files/57c58e6e67f4680ab5740e721b2ffe2fde7ed3a5" alt="" width="563"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/b1bbe48bba8037bfdf0851d49adff77e20aef989" alt="" width="375"><figcaption></figcaption></figure></div>

### **Assistente universal**&#x20;

Este modelo tem restrições mínimas na geração de texto, o que o torna muito adequado para tarefas que exigem criatividade, como copywriting.

<div data-with-frame="true"><figure><img src="/files/aa31627e3bf3eebd66b95ad224afec8394947a10" alt=""><figcaption></figcaption></figure></div>

Visão geral em vídeo

{% embed url="<https://www.youtube.com/watch?v=DDleWZYuyR0>" %}

### **Assistente de vendas**

Nesta função, o bot pode apresentar produtos aos clientes, compartilhar detalhes sobre os itens disponíveis e — se configurado — calcular o custo final.

<div data-with-frame="true"><figure><img src="/files/dc001724f47d27a92b3110ec456e9c3ba0c2acde" alt=""><figcaption></figcaption></figure></div>

Este modelo é construído em torno do comando **"Vender por qualquer meio."** Ele funciona especialmente bem em combinação com uma tabela ou com a configuração "conhecimento do bot", sendo ideal para listagens dinâmicas de produtos e cálculos de preços.

a) crie uma tabela e adicione os detalhes necessários dos produtos;

b) incorpore os valores da sua tabela ao conhecimento do bot usando uma função especificamente criada para o Google Sheets.

{% hint style="info" %}
Instruções sobre como usar [a função do Google Sheets](/doc/pt/chatbot/ai/google-sheets-para-assistente-de-ia.md) ou [a função de tabela da MaviBot](/doc/pt/chatbot/ai/tables.md) podem ser encontradas na seção com o mesmo nome.&#x20;
{% endhint %}

### **Assistente baseado em algoritmo**

Este modelo exige um plano de ação claro, passo a passo — semelhante a um bot estruturado criado em um construtor de funis.&#x20;

**Configurar comportamento e respostas baseados em algoritmo nas configurações do bot**

<div data-with-frame="true"><figure><img src="/files/b14be795a935ead4472dca42eff0391288d03be0" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}

## **Observe**

Escrever um algoritmo personalizado é um processo demorado que exige atenção meticulosa aos detalhes.

Se você precisar de lógica algorítmica para o seu assistente de IA, recomendamos fortemente usar um **modelo de chatbot pronto** do construtor de funis. Depois, você pode ativá-lo e personalizá-lo por meio da **integração do assistente de IA** função.
{% endhint %}

#### Como trabalhar com colchetes

Colchetes são usados para permitir que o modelo insira a palavra necessária por conta própria, a seu critério. Principalmente, o modelo se baseará nas informações do contexto e do histórico da conversa.

Exemplos:

1. **Conte-me mais sobre \[produto]**\
   Neste exemplo, o modelo fornecerá mais detalhes sobre o produto mencionado na conversa. Se nenhum produto for mencionado no contexto ou na conversa, ele inventará um.
2. **Ajude-me a escrever uma carta para um \[amigo/colega/parente]**\
   Aqui, a barra é usada para que o modelo escreva uma carta universal que possa ser enviada a qualquer pessoa da lista.
3. **A resposta não deve exceder \[30-50] palavras**\
   Isso estabelece limites para o modelo, restringindo o tamanho da resposta.
4. **Conte-me sobre \[cidade]**\
   **O modelo gerará um texto sobre uma cidade aleatória se nenhuma cidade específica tiver sido mencionada antes.**
5. **Você é um vendedor em uma loja. Sua tarefa é vender ao cliente um \[produto/serviço]**\
   O bot agirá como um gerente de vendas e ajudará a vender o produto.

Os colchetes também podem ser usados ao escrever um algoritmo para o bot

### **Assistente de agendamento online**

O assistente com a função "Agendamento online" automatiza os agendamentos de clientes utilizando valores incorporados por meio de variáveis e funções.

Este bot foi projetado para funcionar com o sistema de agendamento online e usa uma ramificação de agendamento pré-configurada para orientar os clientes pelos serviços disponíveis, datas abertas e horários — enquanto cria automaticamente os agendamentos na seção de calendário dos Serviços.

<div data-with-frame="true"><figure><img src="/files/2b40aa1c61adf1b0e75bf546376fc34bfd59781e" alt=""><figcaption></figcaption></figure></div>

### **Assistente RAG** <a href="#rag-assistent" id="rag-assistent"></a>

O assistente RAG será necessário para trabalhar com documentos e fornecer respostas precisas com base no seu contexto.

<div data-with-frame="true"><figure><img src="/files/53ceefacc33f949b8f6700201ed921b21c24e7be" alt="" width="375"><figcaption></figcaption></figure></div>

Adicione arquivos: FAQs, instruções, artigos ou materiais internos. O assistente os usa para encontrar respostas às perguntas dos usuários.

<div data-with-frame="true"><figure><img src="/files/152722b664ed29a98eff9aebe5bfc0f5fc7a521e" alt="" width="563"><figcaption></figcaption></figure></div>

Como funciona:

* **Busca preliminar:** Antes de responder, o assistente procura as informações necessárias diretamente no documento enviado.
* **Respostas precisas:** Os usuários recebem respostas diretamente dos seus materiais.

### Uma configuração de chunk (para a função RAG)

Um chunk é um bloco/fragmento de um documento.

<div data-with-frame="true"><figure><img src="/files/9e0b6221a7a271e47319d47f8579abf94b49dbd0" alt="" width="563"><figcaption></figcaption></figure></div>

O RAG divide um documento em partes (chunks), realiza uma busca preliminar entre essas partes, encontra a(s) parte(s) mais semelhante(s) à consulta original e adiciona apenas alguns chunks ao contexto em vez do documento inteiro. Há uma alta probabilidade de que a resposta necessária seja encontrada entre os chunks anexados.

**Como a função RAG funciona:** o documento é dividido em partes (chunks). Por padrão, um chunk tem aproximadamente 500 caracteres.

O tamanho recomendado de um fragmento de texto é de 1000 a 2000 caracteres (especificado no campo de tamanho do chunk).

A divisão do documento é feita automaticamente, e é melhor para o assistente se uma parte contiver um fragmento significativo: por exemplo, uma pergunta e uma resposta de uma FAQ, ou um/dois parágrafos completos de um documento.

<div data-with-frame="true"><figure><img src="/files/d7d0c35b11b2a8b0f78c0b5bd01fa4d4f827a6d6" alt="" width="563"><figcaption></figcaption></figure></div>

Você pode ajustar esses chunks após a divisão automática pela interface: cortar alguns, adicionar informações a outros, excluir alguns ou adicionar chunks totalmente novos.

#### **Como configurá-lo**

**Etapa 1:** Envie o documento.

<div data-with-frame="true"><figure><img src="/files/1f08b50b97827d7d6277ce467f44733fbaf9b996" alt="" width="563"><figcaption></figcaption></figure></div>

E, se necessário, especifique o tamanho do chunk e a sobreposição do chunk.

**Etapa 2:** Clique em "Enviar documento" (isso iniciará o processamento do seu documento e sua divisão em partes (chunks)).

<div data-with-frame="true"><figure><img src="/files/ad73b50bc26f010cc434a37622b4a07fbfbefa28" alt="" width="563"><figcaption></figcaption></figure></div>

**Etapa 3:** Você pode verificar os chunks: por exemplo, se uma parte de uma resposta for dividida no meio de uma palavra, você pode editá-la.

<div data-with-frame="true"><figure><img src="/files/e88a823abec84cb347f399c8416d33f255ff095b" alt="" width="563"><figcaption></figcaption></figure></div>

Depois disso, você pode testar o assistente na janela de chat à direita.

{% hint style="warning" %}

#### **Importante**

* Você pode excluir qualquer chunk (parte) nas configurações do assistente a qualquer momento.
* Você também pode adicionar informações extras sem precisar reenviar o documento inteiro toda vez: basta enviar um arquivo txt e criar chunks.
* Você pode substituir informações desatualizadas diretamente dentro de um chunk sem enviar documentos.
  {% endhint %}

{% hint style="info" %}
Você pode inserir uma frase no campo "Conhecimento do Bot", como: "Os nomes dos documentos são indicados entre parênteses no contexto; consulte-os sempre que possível." Assim, o assistente adicionará entre parênteses o nome do documento onde encontrou a informação.
{% endhint %}

## Configurações predefinidas

As configurações predefinidas são instruções já definidas que orientam o comportamento do chatbot.

<div data-with-frame="true"><figure><img src="/files/5c4f113cc1ecce67f3d61c82440158fb145fa5c4" alt="" width="360"><figcaption></figcaption></figure></div>

**Botões**\
Esta opção é essencial para criar botões quando a resposta exige escolher entre várias opções. Funciona muito bem para as funções de vendas e agendamento online.

Exemplo:

<div data-with-frame="true"><figure><img src="/files/6b7b21ef3716c4ceee156379bff6eb1624eb519c" alt="" width="375"><figcaption></figcaption></figure></div>

Esta opção também é conveniente para o cliente: ele não precisa digitar nada a mais, pois continuar a conversa exige apenas selecionar e clicar no botão de interesse.

**Evitar discutir política**\
O bot permanecerá em silêncio ou recusará responder a perguntas relacionadas à política, religião, reivindicações territoriais e outros tópicos sensíveis.

**Aprimorar respostas**\
Este recurso permite que o bot use listas e formatação organizada ao responder às mensagens dos clientes.

**Minimizar a criatividade**\
Esta opção ajuda a limitar as respostas criativas do bot.

**Entrada de dados passo a passo**\
Este recurso coleta dados do usuário passo a passo — por exemplo, para criar variáveis e passá-las ao sistema (essas variáveis podem ser encontradas posteriormente no perfil do cliente).

Essa abordagem é usada para processar pedidos e preencher formulários que exigem a entrada de informações passo a passo.

{% hint style="info" %}
Para criar variáveis e passá-las corretamente ao sistema, consulte a seção "[Formato de transferência de dados.](#data-transfer-format)"
{% endhint %}

**Não aprender com mensagens**\
Esta opção limita o impacto das mensagens do usuário no bot, protegendo-o de tentativas de usuários mal-intencionados de distorcer deliberadamente o prompt que você definiu.  &#x20;

## Condições de disparo

<div data-with-frame="true"><figure><img src="/files/642c6a5fc4dfe33105c463950f3f02dc714087b6" alt="" width="563"><figcaption></figcaption></figure></div>

Você pode configurar condições de disparo inserindo manualmente os valores das variáveis ou usando o construtor visual de condições.

{% hint style="success" %}
Para que isso serve?

Você pode configurar vários assistentes para funcionar dentro de um único chatbot e alternar entre eles usando condições. Como criar dois ou mais assistentes e coordenar seu trabalho em um único chat é explicado abaixo.
{% endhint %}

### Construtor de gatilhos

<div data-with-frame="true"><figure><img src="/files/70228f939179b23223561e8d2d2f3bd49fbd4a56" alt=""><figcaption></figcaption></figure></div>

Você pode definir manualmente variáveis com valores específicos e escolher um operador de comparação. Os operadores de comparação são padrão, como em todos os gatilhos da MaviBot: igual, diferente; maior que, maior ou igual a; menor que, menor ou igual a, respectivamente.

<figure><img src="/files/e978e89e76c52ee7f0da0cec18410a0234bb051c" alt="" width="360"><figcaption></figcaption></figure>

O **aba "Seleção de bot"** contém bots conectados ao projeto a partir de vários mensageiros, permitindo que você escolha qual chatbot específico executará as configurações de IA.

<div data-with-frame="true"><figure><img src="/files/681986e85c14c8191aab99609757799ca6c2e88c" alt="" width="563"><figcaption></figcaption></figure></div>

É importante mencionar que, no construtor, você pode definir gatilhos para operar apenas na janela de teste, para fins de depuração.

<div data-with-frame="true"><figure><img src="/files/190d4722f2dbc4ed379888bfa37aa65ea339f046" alt=""><figcaption></figcaption></figure></div>

Para usar essa funcionalidade, selecione a aba "Janela de teste" e clique em "Adicionar gatilho"; depois, teste seu bot no painel de teste à direita.

<div data-with-frame="true"><figure><img src="/files/429ba766157b87cb34c525a5d0016f2161a69749" alt=""><figcaption></figcaption></figure></div>

Isso ajuda a evitar situações constrangedoras em que um cliente envia uma mensagem ao seu bot enquanto você está depurando, e a IA responde em vez de você.

## Configurações do bot

<div data-with-frame="true"><figure><img src="/files/7507fcb12ff379660e3d1275b18f29aef749a85b" alt=""><figcaption></figcaption></figure></div>

Neste campo, você precisa especificar:

1. A função que o bot deve assumir;
2. Como ele deve se comportar;
3. Quais ações você espera dele.

As configurações devem ser escritas como pedidos feitos a uma pessoa. Por exemplo:

*"Você é um especialista em suporte que conhece apenas as informações fornecidas no contexto. Sua tarefa é responder às perguntas dos usuários. Você deve ser proativo e amigável."*

{% hint style="success" %}
Se o modelo não seguir as instruções corretamente, você pode adicionar exemplos de perguntas e respostas para esclarecer:\
\&#xNAN;*"Você não deve responder a mensagens sem sentido que não tenham relação com o contexto. Aqui estão alguns exemplos:*\
*Contexto — uma lebre é um mamífero peludo*\
*Pergunta — Olá*\
*Resposta — Não sei a resposta para sua pergunta.*\
*Contexto — O carvão é extraído de uma mina*\
*Pergunta — Desligue a água*\
*Resposta — Não sei a resposta para sua pergunta."*
{% endhint %}

Se você configurou o bot para responder a certas mensagens, mas definiu as mesmas condições em um bloco do construtor de funis, o bloco do construtor de funis terá prioridade!

Isso acontece porque os blocos do construtor de funis têm prioridade maior do que as configurações do assistente.

{% hint style="danger" %}

## Importante

O assistente de IA tem **menor prioridade de processamento** do que os blocos no Construtor de Funis. **Os blocos do Construtor de Funis são sempre executados primeiro.**

**Comportamento principal:**

* Blocos como **"Gatilho", "Início",** ou **"Fallback"** serão executados **mesmo que não tenham condições**, tendo precedência sobre o assistente de IA.
* Somente depois que os blocos relevantes do Construtor de Funis tiverem sido processados é que o cliente prosseguirá pelo fluxo de chatbot configurado.
* O **O assistente de IA entra em ação depois**, com base no estado resultante da conversa.
  {% endhint %}

Exemplo:

Você especificou certas palavras/frases nos gatilhos do bloco:

<div data-with-frame="true"><figure><img src="/files/33698eb87a9f00e3fbe6c0a496183c3b7e0f2492" alt=""><figcaption></figcaption></figure></div>

Você também definiu gatilhos nas configurações do assistente:

<div data-with-frame="true"><figure><img src="/files/1fc7d8026559951e2c075535410ec17de53caf10" alt=""><figcaption></figcaption></figure></div>

O assistente de IA opera como uma camada complementar dentro dos funis de chatbot existentes.

**Como funciona:**

1. **Fluxo principal:** Os blocos configurados no construtor de funis são sempre executados primeiro, de acordo com sua lógica e prioridade.
2. **Papel do assistente de IA:** O assistente é ativado para lidar com casos **não cobertos** pelas condições predefinidas do funil. Ele responde às perguntas dos clientes que ficam fora do fluxo principal.

**Benefício principal:**\
Essa integração garante que todas as dúvidas dos clientes sejam atendidas, aumentando a satisfação do usuário e promovendo maior fidelidade.

## Conhecimento do bot

O modelo de IA subjacente é treinado em um amplo conjunto de dados gerais da internet. Embora poderoso, ele não possui conhecimento específico sobre **os detalhes exclusivos do seu projeto**, como:

* O catálogo de produtos da sua marca
* As ofertas de serviços específicas da sua empresa
* Suas políticas ou procedimentos internos

**Por que este campo é essencial:**

<div data-with-frame="true"><figure><img src="/files/e53e8976b51a6b8fbcc370bf490e08b7737a0133" alt=""><figcaption></figcaption></figure></div>

{% hint style="success" %}
Ao fornecer uma breve descrição dos seus produtos ou serviços, você permite que o bot os promova de maneira mais envolvente, vívida e eficaz.
{% endhint %}

Neste campo, você precisa fornecer as principais informações sobre seu produto nas quais o bot se baseará ao responder. Você pode escrever isso como texto ou usar uma variável.

<div data-with-frame="true"><figure><img src="/files/0c68243aa4348568acd6e8a972296d1d9a30125a" alt="" width="438"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/42d48122e470a18dbb63d1f9c53f8cbc54c191a5" alt="" width="563"><figcaption></figcaption></figure></div>

Ao usar uma variável, o bloco do construtor de funis especifica os dados que o bot deve conhecer:

<div data-with-frame="true"><figure><img src="/files/bf44fcc4668ce9effad1e8847f340cd23a53ccc3" alt="" width="498"><figcaption></figcaption></figure></div>

O exemplo acima mostra o intervalo de serviços configurado na correspondente "[Agendamentos](/doc/pt/booking/settings.md)".

<figure><img src="/files/55abc2bf6228c9c1b43ec592258eafbcf79a5ede" alt="" width="375"><figcaption></figcaption></figure>

<div data-with-frame="true"><figure><img src="/files/5e2f68e1a98b048f7eb1822ce8f4f35b028afa04" alt=""><figcaption></figcaption></figure></div>

{% hint style="success" %}
Você também pode alimentar o conhecimento do bot com valores especificados em uma planilha do Google — por exemplo, para uma loja online.

A IA entende perfeitamente os dados da tabela e os usa em suas respostas.

Para mais detalhes, veja a seção "[Trabalhando com Google Sheets](/doc/pt/chatbot/ai/google-sheets-para-assistente-de-ia.md)."
{% endhint %}

## Formato de transferência de dados

No formato de transferência de dados, você especifica os dados reais que estão sendo coletados (por exemplo, um nome), depois escreve uma frase com a "chave" e atribui um valor a essa chave:\
"Nome com a chave 'name', sobrenome com a chave 'surname':"

<div data-with-frame="true"><figure><img src="/files/4eff6594901cb5941b5e522f9aed59357eacc5f7" alt=""><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/86476244961673e78b5d81859cb14cc576ea1cc9" alt=""><figcaption></figcaption></figure></div>

Os dados são exibidos no cartão de perfil do cliente da seguinte forma:

<div data-with-frame="true"><figure><img src="/files/9a263d8305ac2a02036c531ea84664b4396569ad" alt=""><figcaption></figcaption></figure></div>

Este parâmetro é opcional e é usado quando você precisa transferir informações para o sistema.

{% hint style="danger" %}

## Observe

Se você precisar que os dados inseridos pelo cliente sejam passados ao bot como variáveis e não como uma matriz ou dicionário, especifique as configurações apropriadas no prompt do assistente de IA. Por exemplo, você pode configurar as definições para que as respostas sejam enviadas como texto em vez de como lista ou dicionário.

A forma como os valores são transmitidos ao bot e registrados no perfil do cliente (no sistema) depende do formato de dados gerado pelo assistente de IA.
{% endhint %}

### Como passar dados para o bot

Para enviar dados ao bot, você precisa inserir um dos seguintes comandos no <mark style="color:azul;">**configurações do bot**</mark>:&#x20;

1. <mark style="color:$warning;">**Depois execute o comando "Block call 123123"**</mark> — onde "Block call" é um comando de depuração, e o número representa o ID do bloco.\
   Esse comando é útil para testar e verificar se os dados estão sendo transmitidos corretamente durante a configuração do bot.

Como visto no exemplo acima, o comando gera os dados em formato JSON. Os valores são salvos no projeto, ajudando você a acompanhar a precisão das informações armazenadas e a ajustar o bot durante a fase de depuração.

O comando é especificado nas configurações do bot da seguinte forma:

<div data-with-frame="true"><figure><img src="/files/ffaa1ed04837f39b256916d050c7d6f3c09d3760" alt="" width="563"><figcaption></figcaption></figure></div>

2. O comando <mark style="color:roxo;">**"Depois execute o comando "start\_block\_from\_ai 11916"**</mark>também envia informações ao bot. Substitua o número (destacado em verde) pelo ID do bloco.

<div data-with-frame="true"><figure><img src="/files/22b2f50494c1c71a6a70fe84adabd07bfab16733" alt="" width="563"><figcaption></figcaption></figure></div>

O comando funciona de forma semelhante a "Block call **44**," mas é usado durante interações reais com o cliente porque é “recortado” da mensagem do bot e ocultado dos seus usuários.

**Exemplo de comando:**

*Quando você concluir uma venda ou encerrar a conversa com sucesso, você deve escrever exatamente, sem nenhuma alteração: **"start\_block\_from\_ai 10241"***

#### Qual é a diferença entre o primeiro e o segundo comando para o chatbot de IA

Como mencionado anteriormente, "**Block call N**" é necessário para testes, para que você possa verificar VISUALMENTE se as configurações do block call estão funcionando corretamente ou não.

{% hint style="warning" %}

## Observe

Depois de depurar as configurações do chatbot de IA, substitua o comando "Block call **44**" por "**start\_block\_from\_ai 44**". Dessa forma, o cliente NÃO verá o comando block call, e o diálogo do chat continuará sem alterações, enquanto os dados inseridos pelo usuário ainda serão transmitidos ao sistema.
{% endhint %}

{% hint style="info" %}
Quando um bloco é acionado pelo assistente, o histórico do chat com o assistente é apagado.
{% endhint %}

Exemplo de uso:

* Se alguém pedir para você acender a luz, <mark style="color:$warning;">**execute o comando "Block call 123123"**</mark>
* Se alguém perguntar sobre o período de plantio da rúcula, <mark style="color:$warning;">**execute o comando "Block call 123123"**</mark>

{% hint style="success" %}
Por favor, observe!

Se o seu comando (seja um gatilho ou qualquer outro) não funcionar, adicione “E de outra forma nenhuma” ao final da frase (veja o exemplo abaixo).
{% endhint %}

## Outros parâmetros

### Mensagem para respostas demoradas

Se o bot precisar de mais tempo para gerar uma resposta (por exemplo, durante a geração de texto ou copywriting), você pode definir uma mensagem para o bot enviar:

<div data-with-frame="true"><figure><img src="/files/179d8b5bb555ac407bfc5fb790155c4568e6be5e" alt="" width="563"><figcaption></figcaption></figure></div>

### Momento da notificação de atraso na resposta

<div data-with-frame="true"><figure><img src="/files/cb127287dc6fdfa2cb83e8a2a33c194527567511" alt="" width="563"><figcaption></figcaption></figure></div>

Este campo, que aceita um valor numérico, está relacionado à configuração anterior: ele define o atraso após o qual uma mensagem sobre a resposta demorada é enviada.

Ele aceita um valor numérico em segundos, variando de 2 a 25.

### **Criatividade do modelo**

Este é um parâmetro-chave que revela o potencial criativo do modelo e permite gerar ideias originais que vão além do seu treinamento.

<div data-with-frame="true"><figure><img src="/files/782cc8d70d1d9227aaf6e22912309fac6501eb7c" alt="" width="428"><figcaption></figcaption></figure></div>

O parâmetro é definido com um valor entre 0,0 e 1 (por exemplo, 0,1, 0,2 etc.).

{% hint style="success" %}
Para tarefas que exigem dependência de texto e respostas precisas, é preferível definir valores próximos de zero, pois isso evita que o modelo induza seus clientes ao erro. <br>

Em contrapartida, para tarefas criativas em que a imaginação não é um problema, recomenda-se um valor próximo de 0,9.
{% endhint %}

{% hint style="success" %}
Se você não tiver certeza de qual valor definir para a função de assistente escolhida, basta deixar o campo em branco — cada função já possui valores padrão ideais configurados.
{% endhint %}

### Número máximo de palavras

<div data-with-frame="true"><figure><img src="/files/c7032b9519f641fc99b5637ba4231f42f0d3a561" alt="" width="378"><figcaption></figcaption></figure></div>

Este campo, que aceita apenas valores numéricos, define o número máximo de palavras na resposta do chatbot.

Esse limite é especialmente útil para mensageiros em que o número de caracteres por mensagem é estritamente restrito, pois evita que o bot de IA seja cortado no meio da frase e ajuda a entregar a resposta mais precisa e concisa dentro da mensagem.

{% hint style="warning" %}
Limites de caracteres nos mensageiros:

* Telegram – **4096** caracteres
* Instagram – **1000** caracteres
* WhatsApp – **4096** caracteres
* Viber – **1000** caracteres
  {% endhint %}

## Sobre dicas úteis

### Limite de tokens

O modelo aceita até **128,000** tokens como entrada, onde um token equivale aproximadamente a dois caracteres.

### Prevenção de desinformação do usuário

Se o modelo induzir os clientes ao erro mencionando serviços ou produtos inexistentes, você pode ativar a opção "Minimizar fantasias" e também tentar reduzir a criatividade do modelo.

### Como fazer o Assistente de IA permanecer em silêncio

Insira o seguinte texto do comando no campo de configurações do bot:

"Se alguém perguntar sobre \_\_\_\_\_\_\_, você deve responder que não sabe a resposta.\
Se alguém perguntar sobre eventos dos quais você não tem conhecimento, você deve responder que não sabe a resposta."

Exemplo:

<div data-with-frame="true"><figure><img src="/files/09fb95d6a126619c58b9818fcc57f099d70cae0a" alt=""><figcaption></figcaption></figure></div>

{% hint style="warning" %}

## Observe

O bot lembra do histórico do chat.

Se você alterar as configurações dele, é recomendável excluir a conversa atual e iniciar uma nova. Caso contrário, o bot continuará respondendo com base nas mensagens anteriores, pois o histórico do chat tem prioridade sobre as novas configurações.
{% endhint %}


---

# 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://docs.mavibot.ai/doc/pt/chatbot/ai/assistant.md?ask=<question>
```

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.