> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.gdash.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Como configurar Agente de IA para atendimento na caixa de entrada

O Agente de IA do GDASH é uma ferramenta inteligente que auxilia na automação dos atendimentos pela Caixa de Entrada. Ele interpreta mensagens, fornece respostas e apoia a equipe na gestão das conversas. Com ele, é possível agilizar o atendimento, aumentar a produtividade da equipe e oferecer uma experiência mais rápida e organizada aos clientes.
Saiba abaixo como configurar e utilizar o Agente de IA:

### **Configurando o Agente de IA**

1. Acesse a **Caixa de Entrada** e clique em **Agente de IA;**

![Acesse o Agente de IA.](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_1bwq1rt.png =850xauto)

2. Clique em **Configurações**;

![Configurações do agente.](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_1bdydf4.png =862xauto)

3. Começando pelo **Modelo do Agente**, você pode escolher entre alguns modelos de IA, qual você deseja aplicar para gerar as respostas do Agente;

![Escolha o modelo do Agente de IA.](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_wj1f0j.png)

4. Defina em quais canais a IA deve atender e se ela deve ou não responder mensagens somente em horário comercial;

![Escolha os canais de atendimento do agente.](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_14fpjnx.png)

||| Caso você habilite para a IA responder somente em horário comercial, você deve configurar as faixas de horário de atendimento, explicadas no passo 5 da configuração.

![Atendimento apenas em horário comercial configurado.](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_ened6.png)

5. Você pode configurar **horário comercial** definindo **faixas** diárias de horário de atendimento e o **fuso horário** desejado. Ex: Segunda a sexta, de 08:00 até 18:00, horário de Brasília;

![Configure horário comercial.](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_qf7w32.png)

6. Defina quando o agente de IA deve fazer o **escalonamento para um atendente humano**. A IA poderá transferir a conversa para um atendente quando houver:

* **Baixa Confiança** - Quando a confiança da IA para dar a resposta for abaixo do limiar de confiança definido pelo usuário;
* **Pedido do cliente** - Quando o cliente solicitar para falar com um humano;
* **Temas sensíveis** - Assuntos como pedido de cancelamento, reclamação, jurídico e semelhantes;
* **Humano assumiu** - Quando um atendente humano entrar na conversa, a IA recua;

![Defina em quais situações o agente deve escalonar a conversa para um atendente humano.](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_1k2b4nh.png)

| Você também pode configurar uma mensagem de transição para o cliente, em que a IA informará ao cliente que a conversa será transferia para um atendente.

![Crie uma mensagem de transição do agente para um atendente humano.](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_knqtbb.png =818xauto)

Após realizar as configurações, é possível começar a dar instruções e diretrizes que especificam **como o agente deve responder** em diferentes cenários (boas práticas e coisas a evitar).

### **Instruções**

1. Acesse **Instruções**;

![Acesse a aba de instruções.](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_15ya9h5.png)

2. Clique em **Novo**, para adicionar uma nova **instrução**;

![Criar nova instrução.](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_5ysaxa.png)

3. Dê um **nome** para a instrução sendo criada e adicione na **descrição** como seu agente deve responder em uma determinada situação. Ex.: pedir uma captura de tela quando o cliente reportar um bug no sistema;

![Dê um nome e adicione descrição da instrução.](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_oaf7nm.png)

| Você pode agrupar suas instruções por tema adicionando um Grupo à instrução.

![Selecione um grupo de instrução.](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_1jm4s9m.png)

![Clique em "Criar novo grupo".](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_y9kfmk.png)

![Selecione um ícone desejado, dê um nome ao grupo e clique em criar.](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_17h5uye.png =614xauto)

4. Feitas as configurações, clique em **Criar grupo**;

![Crie o grupo.](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_muyqgw.png)

5. Criada a instrução, você pode ativá-la ou editá-la a qualquer momento;

![Ativar ou editar instrução.](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_1hbrc2c.png =661xauto)

Pode ser definido também **habilidades** e ações que a IA pode executar sozinha em **negócio** e **clientes**.

### **Habilidades**

1. Clique em **Habilidades**;

![Acesse a aba de Habilidades.](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_2mrwin.png)

2. **Negociações** - Configure o que a IA pode ou não fazer com o cadastro e gestão de negócios em conversas com clientes;
* **Gerenciar negócios existentes -** permite o agente atualizar a negociação vinculada à conversa, movendo etapas, ajustando dados e fazendo anotações na linha do tempo;

![Habilidades de gerenciar negócios.](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_1m931ml.png)

* **Qualificar e criar negócios** - permite ao agente fazer a qualificação de leads (clientes em potencial) e criar negócios;

![Habilidade de qualificar e criar negócios.](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_kn7iij.png)


3. **Clientes** - Configure se a IA pode cadastrar novos clientes quando ainda não houver nenhum cadastrado na conversa, bem como atualizar dados (nome, email, telefone);

![Habilidade de criação de clientes.](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_1l83f12.png)

4. **Atividades** - Defina se o agente pode agendar ou remarcar atividades, sugerindo ao cliente horários livres, agendando reuniões/ ligações ou reagendando quando solicitado pelo cliente, delimitando duração da reunião, janela de dias e tempo mínimo antes do horário agendado;

![Habilidades de agendar e editar atividades.](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_1mhcsfk.png)

### Base de conhecimento

A base de conhecimento é o espaço onde você reúne informações que ajudam o agente de IA a responder de acordo com a realidade da sua empresa. Nela, é possível incluir materiais como políticas comerciais, serviços oferecidos, dúvidas frequentes, regras de atendimento, informações sobre garantia, processos internos e orientações para clientes.
Quando recebe uma pergunta, o agente busca os trechos mais relevantes dentro dos conteúdos cadastrados e usa essas informações como contexto para elaborar a resposta. Por isso, prefira materiais claros, atualizados e específicos. A base complementa as instruções do agente: enquanto as instruções definem como ele deve agir e se comunicar, a base fornece o conteúdo que ele pode consultar durante os atendimentos.

1. Acesse **Base de conhecimento**;

![Acesse a aba da Base de conhecimento.](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_ac5e4m.png)

2. Em **Tipo de conteúdo**, escolha uma das opções;

![Escolha o tipo de conteúdo.](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_va54x9.png)

* **Texto**: para colar uma informação diretamente na plataforma;
![Conteúdo de texto.](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_1lq8x84.png)

* **Link:** para informar a URL de uma página que contenha o conteúdo desejado;

![Conteúdo de link.](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_1kh9o0n.png)

||| Não recomendamos treinar o agente com links de vídeos como Youtube, mas link para páginas com documentações em texto e imagem.

* **Arquivo:** para enviar um documento em PDF, TXT ou Markdown (.md);
![Conteúdo de arquivo.](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_16dxu1j.png)

3. Preencha um **título** para facilitar a identificação do material depois. Esse campo é opcional, mas recomendado;
![](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_z9ykr1.png)

4. Informe o texto, link ou arquivo e clique em **Adicionar à base**. Ex. Link da central de ajuda;
![Adicione o conteúdo.](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_13foo3y.png)

5. Aguarde o processamento. O conteúdo é preparado e dividido em trechos para que o agente consiga encontrar as informações mais adequadas em cada conversa.

![Conteúdo adicionado à base de conhecimento.](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_f1uq8a.png)

| Na lista da base também há a opção **Histórico de conversas da caixa de entrada**. Ao ativá-la, o agente pode usar conversas qualificadas do atendimento como referência de contexto e de estilo de resposta. A primeira ativação pode exigir um processamento do histórico e consumir créditos de IA da organização, de acordo com o volume de conversas.

![Habilitar histórico de conversas da caixa de entrada.](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_1e1uy7b.png)

||| Algumas boas práticas podem ser adotadas para garantir o melhor funcionamento do agente de IA:

\- Cadastre informações oficiais e mantenha-as atualizadas;
\- Organize conteúdos por assunto e use títulos descritivos;
\- Evite materiais contraditórios ou versões antigas da mesma política;
\- Inclua exemplos de dúvidas frequentes e respostas aprovadas pelo time;
\- Revise a base sempre que houver mudanças em serviços, condições comerciais ou processos de atendimento.

### Playground

O Playground permite simular uma conversa com o agente de IA antes de liberá-lo para atender clientes nos canais integrados. Ele é útil para validar as instruções, a base de conhecimento, o tom das respostas e as regras de escalonamento para atendimento humano.

Para testar:

1. Acesse a aba **Playground** na configuração do agente de IA;

![Acesse a aba de playground.](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_nqgx8o.png)

2. Digite uma mensagem como se fosse um cliente. Por exemplo: “Oi! Quanto custa o software para gestão de créditos de energia?”

![Exemplo de mensagem no playground.](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_1cn8xty.png)

3. Envie a mensagem e aguarde a resposta do agente.

![Aguarde a resposta do agente.](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_9d1rj1.png)

4. Continue a conversa para avaliar se o agente mantém o contexto das mensagens anteriores.

![Exemplo de conversa.](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_7hwdrf.png)

5. Use o botão **Limpar conversa** para iniciar uma nova simulação.

![Limpar conversa e iniciar novo teste.](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_488fsu.png)

|| O Playground utiliza as configurações atuais do agente, incluindo instruções, perfil de comunicação, base de conhecimento, histórico de conversas — quando habilitado — e regras de escalonamento. A simulação não envia mensagens para clientes nem para os canais da caixa de entrada.

|| Após cada teste, são exibidas informações como:

\- Se o agente responderia automaticamente ou encaminharia a conversa para uma pessoa;
\- O motivo do escalonamento, quando aplicável;
\- O nível de confiança da resposta;
\- A latência da geração;
\- A quantidade de trechos da base de conhecimento utilizados.

![Exemplo em que o Agente conseguiria responder a uma mensagem.](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_7ble15.png)![Exemplo em que o agente não conseguiria responder uma mensagem](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_9pvemh.png)

||| Os testes do Playground **consomem créditos** da carteira do usuário. Por isso, faça simulações conscientes, especialmente ao testar conversas longas.

### Análises

A aba **Análises** reúne informações sobre o uso e o desempenho do agente de IA. Ela ajuda a acompanhar o consumo de recursos, os modelos utilizados, o tempo de resposta e o resultado das interações.

![Acesse a aba de Análises.](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_1xxypve.png)

1. Gráficos de acompanhamento: na parte superior da tela, são apresentados três gráficos dos últimos 30 dias:
* **Consumo de tokens por dia:** mostra a quantidade de tokens utilizados em embeddings, prompts e respostas geradas;
* **Créditos consumidos por dia:** apresenta os créditos debitados, separados por modelo de IA;
* **Uso de modelos por dia:** mostra a quantidade de interações realizadas por cada modelo.

![Gráficos de acompanhamento.](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_96nery.png)

|| Quando não há dados no período, o gráfico informa que não existem dados disponíveis.


2. Interações: a parte inferior da aba apresenta uma lista paginada das interações do agente. Para cada interação, é possível consultar:
* data e hora;
* canal utilizado;
* mensagem enviada pelo cliente;
* nível de confiança da resposta;
* créditos consumidos;
* modelo utilizado;
* latência da geração;
* ações executadas pelo agente;
* status da interação, como resposta enviada ou encaminhamento para atendimento humano.

![Histórico de interações.](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_1qzh9vh.png)

| As colunas podem ser ordenadas. Também é possível navegar entre as páginas para consultar interações mais antigas. Essa área facilita a identificação de respostas que precisam ser revisadas, escalonamentos frequentes, aumento no consumo de créditos ou lentidão no atendimento.

| Recomenda-se usar o Playground durante a configuração inicial e consultar a aba **Análises** regularmente após a ativação do agente. Assim, a empresa consegue ajustar a base de conhecimento e as instruções com base no comportamento observado nas conversas reais.

Com todas as configurações feitas, Instruções criadas, habilidades e base de conhecimento definidas e testes no playground realizados, o agente de IA pode ser ativado e colocado em ação nas conversas com os clientes de sua organização.