# Treinando o Agente de IA

## Configurações iniciais

Para implementar corretamente nos seus clientes o Agente de IA da Bolten, é necessário, primeiramente, realizar algumas configurações base:

1. Conexão do número do WhatsApp
   1. Oriente-o a escanear o QR-code que aparecer na tela da ferramenta de WhatsApp
2. Ative o Agente de IA no número conectado:

<figure><img src="/files/NiuecuKRIJHqAwpKd2ux" alt=""><figcaption></figcaption></figure>

3. Configure a os períodos comerciais, onde o Agente poderá escalonar para um humano:

<figure><img src="/files/ee6i98HEO2VltdUzmid5" alt=""><figcaption></figcaption></figure>

Feitas as configurações iniciais, agora está na hora de configurar a conteúdo e conhecimento do Agente!

obs.: Lembre-se de clicar em "Atualizar Chatbot" depois de qualquer modificação nos horários!

### O Script do Agente (prompt)

Para configurar o Agente de IA com eficiência, é fundamental entender as duas estruturas disponíveis: Instrução Estruturada e Instrução Livre.

#### Instrução Estruturada

Neste modo, o sistema apresenta diversas caixas de texto com funções pré-definidas (como Tom da Conversa, Links Úteis, etc.).

* Vantagem: Facilita a organização do raciocínio, garantindo que você não esqueça nenhum pilar essencial da configuração.
* Funcionamento: O Agente já sabe o contexto de cada campo, o que torna a configuração mais intuitiva e guiada.
* Limites: Cada caixa possui seu próprio limite de caracteres, otimizando a distribuição das informações.

#### Instrução Livre

No modo Livre, você utiliza uma única caixa de texto com um limite de caracteres expandido.

* Vantagem: Oferece total liberdade para instruir o Agente de maneira "desconstruída" ou personalizada.
* Funcionamento: Ideal para quem prefere redigir um texto único e corrido, integrando todas as diretrizes em um só lugar.
* Recomendação: Exige uma organização textual mais rigorosa por parte do usuário para garantir que a IA compreenda todos os comandos.

### A Base de Conhecimento

<figure><img src="/files/R5etcU6DVCoRNwyFWyVK" alt=""><figcaption></figcaption></figure>

Esta seção permite o upload de arquivos que ajudam o Agente a aprofundar o conhecimento sobre a sua empresa, projetos específicos, produtos ofertados e muito mais.

Como o Agente processa as informações: Nas configurações internas, a IA foi instruída para, primeiramente, ler e incorporar as diretrizes do Prompt (Instruções) e, em seguida, consultar os arquivos da Base de Conhecimento para detalhamento técnico.

Dica de Ouro: É extremamente produtivo citar, dentro do seu prompt, quais arquivos estão presentes na Base de Conhecimento. Isso direciona o Agente a buscar respostas específicas nesses documentos, aumentando a precisão do atendimento.

### Dicas para configurar o prompt do Agente

Recomendamos utilizar outras Inteligências Artificiais como suporte na criação do seu script. Dessa forma, o Agente de IA será o mais otimizado possível, cobrindo todas as bases de conhecimento e interação!

#### O que requisitar à IA?

Primeiramente, é fundamental que a IA compreenda o contexto, o tema e as limitações de espaço para cada resposta. Em outras palavras, ela deve estar ciente de quais campos serão preenchidos e qual o limite de caracteres permitido para cada um.

Quanto ao conteúdo, o ideal é inverter o processo: peça que a IA faça perguntas sobre a empresa do cliente ou o nicho de mercado. Após ela entender o cenário, responda a esses questionamentos com clareza para que ela possa gerar uma configuração muito mais assertiva.

Para que a IA gere um conteúdo útil, ela precisa conhecer as "regras do jogo". Explique literalmente o espaço disponível e o que se espera de cada campo:

> Preciso que crie um prompt para esse Modelo, o Agente tem as seguintes caixas de texto:
>
> **Definição de Função** - 2500 caracteres
>
> **Sobre a Empresa, Produtos e Serviços** - 10000 caracteres
>
> **Tom da Conversa** - 2500 caracteres
>
> **Orientações sobre a Base de Conhecimento** - 2500 caracteres
>
> **Prevenção de Informações Incorretas** - 2500 caracteres
>
> **Encaminhamento para Atendimento Humano** - 2500 caracteres
>
> **Links Úteis** - 2500 caracteres
>
> **Exemplos de Conversa** - 5000 caracteres

<figure><img src="/files/WZ2ltztzPcB7l2GK8Bog" alt=""><figcaption></figcaption></figure>

Caso opte pelo modo de Instrução Livre, siga o mesmo processo de contextualização, mas solicite à IA um texto único e fluido. Lembre-se de indicar o limite total de caracteres da caixa e reforce que o conteúdo deve ser conciso, direto e escrito em formato de texto corrido.

> Preciso que crie um prompt para esse Modelo, o Agente tem uma única caixa de texto, com um limite de 30000 caracteres.

<figure><img src="/files/Q2p1SN5ChQqw4vcmXzhj" alt=""><figcaption></figcaption></figure>


---

# 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://bolten.gitbook.io/bolten-docs/manual-de-uso-para-plataforma/treinando-o-agente-de-ia.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.
