> For the complete documentation index, see [llms.txt](https://docs.chatlayer.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/integrateandcode/app-integrations/openai-gpt-3-chatgpt-and-gpt-4.md).

# OpenAI: GPT-3, ChatGPT e GPT-4

<figure><img src="/files/3027284fa998a5cfaee9107063e49b396ee3b665" alt=""><figcaption><p>Como seu fluxo de fallback deve ficar se você usar o GPT como uma mensagem de Não Entendido</p></figcaption></figure>

## O que é GPT

**GPT** é uma série de sistemas avançados de Processamento de Linguagem Natural desenvolvidos pela OpenAI que permitem executar várias tarefas baseadas em texto.

A **Integração OpenAI** permite gerar respostas no seu chatbot. Como construtor de bots ou designer de conversas, tudo o que você precisa fazer é selecionar o **GPT-3, ChatGPT ou GPT-4** modelo e informar a ele a consulta certa que define o tipo de resposta que você gostaria, e ele a criará para você!

Para poder usar os modelos GPT no Chatlayer, você precisará [configurar a integração OpenAI](#set-up-the-gpt-3-integration), em seguida [usar essa integração dentro de](#use-gpt-3-inside-a-bot) blocos.

{% hint style="warning" %}
Usar a integração OpenAI significa que seus dados são enviados para os serviços da OpenAI, que ficam nos Estados Unidos. Certifique-se de entender os [termos de serviço da OpenAI](https://openai.com/terms/) e as implicações. Use OpenAI em bots de produção com cautela; a Chatlayer não se responsabiliza pelo conteúdo gerado.
{% endhint %}

## \[Vídeo] GPT em conversas com clientes

Aqui está um vídeo que fizemos sobre como e por que você pode agregar valor ao seu bot se usar GPT.

{% embed url="<https://vimeo.com/911546543?share=copy>" %}

## Configure sua integração OpenAI

Antes de poder usar GPT dentro dos blocos, você precisa conectar uma conta OpenAI à integração OpenAI no Chatlayer. Para isso, você pode precisar de uma chave de API da OpenAI.

{% hint style="success" %}
A Chatlayer fornece aos clientes sua própria **chave de API da OpenAI** para usar GPT com um limite de 100 mensagens por bot. Isso significa que, a partir da 101ª mensagem, o GPT deixará de gerar e enviará erros. Se você quiser poder usar uma quantidade ilimitada de mensagens geradas pelo GPT, você precisará criar [sua própria chave de API no site da OpenAI](https://platform.openai.com/account/api-keys).
{% endhint %}

Para conectar seu chatbot ao GPT:

{% stepper %}
{% step %}
Na página inicial da Chatlayer, vá para **Integrações.**
{% endstep %}

{% step %}
Pesquise por "OpenAI" na barra de busca.

<figure><img src="/files/75aea83b001bc70e9c0bda9f0419304e6f91ad04" alt=""><figcaption><p>Pesquise por OpenAI e você encontrará a integração OpenAI pronta para ser configurada</p></figcaption></figure>
{% endstep %}

{% step %}
Clique em **Open AI**.

<figure><img src="/files/74bc8da26f0490695635ca5c6cad2effc2bc589b" alt=""><figcaption><p>Visualização da integração OpenAI quando aberta.</p></figcaption></figure>
{% endstep %}

{% step %}
Clique em **+ Adicionar conta** para começar a conectar sua conta OpenAI com a integração OpenAI.

<figure><img src="/files/ce94a31906efa993343e09db6e4429acfc65c81c" alt="" width="278"><figcaption><p>Janela pop-up para fornecer as credenciais necessárias para conectar a OpenAI ao Chatlayer</p></figcaption></figure>
{% endstep %}

{% step %}
Cole seu token de acesso no **Token de acesso** campo

{% hint style="success" %}
Se você não tiver um token de acesso da Chatlayer, você pode gerar um [aqui](https://app.chatlayer.ai/settings/api-access/tokens).
{% endhint %}
{% endstep %}

{% step %}
Em **Nome de exibição**, escreva um identificador que poderá ser usado mais tarde para selecionar esse token de acesso específico ao usar a integração OpenAI dentro de um bot. Neste exemplo, usamos o identificador *Exemplo de Token Chatlayer OpenAI*.
{% endstep %}

{% step %}
Opcionalmente, você pode fornecer um **chave de API da OpenAI**.
{% endstep %}

{% step %}
Clique em **Enviar** quando terminar.
{% endstep %}
{% endstepper %}

A conta OpenAI agora deve estar visível na `Contas conectadas` aba. Observe que a palavra "Auth" foi adicionada automaticamente antes do "Nome de exibição".

<figure><img src="/files/f9518037625fa12433678b8371da6995cc367ccc" alt=""><figcaption><p>Você pode ver sua conta OpenAI na aba Contas conectadas.</p></figcaption></figure>

{% hint style="success" %}
Para testar a integração OpenAI, a Chatlayer oferece 100 mensagens por bot. Se isso for suficiente para você, pode deixar o campo da chave OpenAI vazio. Porém, se você quiser deixar ilimitado o seu número de mensagens geradas pelo GPT, você precisará [obter sua própria chave de API no site da OpenAI](https://platform.openai.com/account/api-keys).
{% endhint %}

{% hint style="info" %}
Você configurou sua conta GPT e gostaria de partir direto para a criação do bot? Nós temos o que você precisa com nosso [modelo GPT-3](/chatlayer-documentation-pt-br/comece-rapido/bot-templates/gpt.md) bot. Experimente!
{% endhint %}

Sua integração OpenAI está configurada! Agora é hora de usá-la dentro da conversa.

## Como usar os modelos GPT da OpenAI dentro de um bot

Você precisará fazer duas coisas para que seus clientes possam interagir com GPT-3, ChatGPT ou GPT-4: gerar uma resposta e exibi-la.

### Gerar uma resposta GPT

Para gerar uma resposta GPT-3, ChatGPT ou GPT-4:

{% stepper %}
{% step %}
Crie um [Ação ](https://docs.chatlayer.ai/bot-answers/dialog-state/action-bot-dialog)bloco e abra-o.
{% endstep %}

{% step %}
Pesquise pela integração OpenAI na barra de busca e selecione-a

<figure><img src="/files/0bf689ff97f421015ac7abb8d77f04ef2ca6cf0e" alt=""><figcaption><p>Pesquise pela integração OpenAI na barra de ferramentas do bloco de ação e selecione-a.</p></figcaption></figure>
{% endstep %}

{% step %}
Em **Conta OpenAI**, selecione sua [conta OpenAI que você conectou ao Chatlayer anteriormente.](#how-to-set-up-your-openai-integration)

No nosso caso, ela se chama "Auth *Exemplo de Token Chatlayer OpenAI*".

<figure><img src="/files/ceaffa6e9d1381cf9603587e6955a84e3cae57d2" alt=""><figcaption><p>Insira sua conta OpenAI para conectá-la ao bloco de ação.</p></figcaption></figure>
{% endstep %}

{% step %}
Selecione a ação a executar, chamada "**Resposta GPT**".

Isso significa que a ação enviará a conversa para a OpenAI e recuperará uma resposta.

<figure><img src="/files/6e4f4ae3185984585ccf33d218a36893a56ff9ce" alt=""><figcaption><p>Selecione a ação para a integração GPT-3.</p></figcaption></figure>
{% endstep %}

{% step %}
Agora, forneça à OpenAI as informações necessárias para que ela possa gerar uma resposta. Elas são chamadas de **Campos da ação**:

* Preencha o **Descrição do bot**, que é uma breve descrição sobre o que seu bot faz. Por exemplo, *um bot de restaurante*.
* Preencha o **Prompt do bot**, que é uma descrição da resposta que você gostaria que o GPT gerasse. Exemplo: *gerar uma mensagem personalizada para pedir desculpas por um inconveniente*.
* Selecione a **Tipo de modelo**, que pode ser GPT-3, ChatGPT ou GPT-4. Observe que o GPT-4 está disponível apenas na [Chatlayer US](https://docs.chatlayer.ai/support/saas-regions-and-ip-ranges) devido às regulamentações europeias do GDPR.

{% hint style="info" %}
Tenha em mente: quanto mais longa for a descrição do bot ou o prompt do bot, mais tempo levará para receber uma resposta da OpenAI.
{% endhint %}

<figure><img src="/files/74368568807f8349323b2d9db7876f2b3b38eab9" alt=""><figcaption><p>Preencha os campos da ação para que a OpenAI receba todas as informações necessárias para gerar uma resposta.</p></figcaption></figure>
{% endstep %}

{% step %}
Clique em **Criar** para salvar seu bloco de ação integrado ao GPT
{% endstep %}
{% endstepper %}

Você criou um bloco de ação que usa GPT para gerar uma resposta com base na descrição do seu chatbot! Agora, vamos ver como podemos exibir essa resposta gerada dentro da conversa.

### Exibir uma resposta GPT

A resposta gerada pelo GPT está disponível no [session](/chatlayer-documentation-pt-br/bot-answers/session.md) dados após a execução do bloco de ação acima. Essa resposta é salva em `{apps.openai.gpt.text}` variável.

Para exibir a resposta GPT na conversa:

{% stepper %}
{% step %}
Crie um [Mensagem](/chatlayer-documentation-pt-br/buildabot/flow-logic/dialog-state/message-components.md) bloco.
{% endstep %}

{% step %}
Adicione um campo de texto e preencha-o com o`{apps.openai.gpt.text}` variável.

<figure><img src="/files/7505f2be5212ac7c9f47e4dcc4abb2264e36dc76" alt=""><figcaption><p>Adicione a variável que contém a resposta gerada pela OpenAI a um campo de texto para exibi-la na sua conversa.</p></figcaption></figure>
{% endstep %}
{% endstepper %}

Agora você já sabe como configurar um bloco de ação que gera uma resposta GPT e como exibir essa resposta dentro de um bloco.

Nas seções abaixo, vamos usar um caso de uso para exemplificar como você pode usar GPT no seu bot.

<details>

<summary>[Caso de uso] GPT para mensagens de fallback</summary>

Uma forma de usar a integração OpenAI é como uma mensagem de fallback para quando seu bot não entendeu a pergunta do usuário.

Se você ainda não tiver um bot, pode usar um dos nossos [bots de modelo](/chatlayer-documentation-pt-br/comece-rapido/bot-templates.md).

Depois que você criar um bot, entre no seu **Geral** fluxo e abra o **Não Entendido** bloco. A partir daí, vamos modificar o **Não Entendido** bloco para que ele use a integração OpenAI:

1. Exclua a mensagem de texto dentro do **Não Entendido** bloco clicando no ícone da lixeira
2. No **Ir para** campo, crie um novo bloco de ação que você chamará de "Gerar resposta GPT", depois salve suas alterações
3. Abra a **Gerar resposta GPT** bloco que você acabou de criar e [configure este bloco de ação para que ele integre o GPT](https://docs.chatlayer.ai/integrations/app-integrations/gpt-3-beta#use-gpt-3-inside-a-bot)
4. No campo Ir para, crie um bloco de mensagem do bot e chame-o de "Exibir resposta GPT", depois salve suas alterações
5. Abra a **Exibir resposta GPT** bloco e adicione a `{apps.openai.gpt.text}` variável dentro do campo de texto

<img src="/files/3027284fa998a5cfaee9107063e49b396ee3b665" alt="How your fallback flow should look like if you use GPT as a Not Understood message" data-size="original">

Se você falar com seu bot agora e perguntar algo que ele não saiba, o estado do bloco "Não Entendido" deverá ser acionado. Em seguida, a OpenAI será chamada e a resposta será exibida para você.

<img src="/files/f5e7c04f0cd74d7800cbc13b9d33b882f3c06f3e" alt="Example of a fallback flow where GPT-3 was asked to generate an apology for an inconvenience in a restaurant bot." data-size="original">

</details>

<details>

<summary>[Caso de uso] GPT para respostas contextualizadas</summary>

O GPT é capaz de ler toda a conversa entre seu cliente e o bot, o que significa que ele pode gerar texto com base no contexto da conversa.

Como exemplo de respostas contextualizadas do GPT:

1. Crie uma intenção que acionará uma resposta GPT. Neste exemplo, criamos uma **intent\_not\_delivered** intent.
2. Crie um bloco de ação que gere uma resposta GPT e conecte-o a um bloco que a exiba, como [explicado no tutorial acima](#use-gpt-3-inside-a-bot). No nosso exemplo, consultamos o seguinte texto no GPT-3:

<img src="/files/0f852c49f98957995b3390d75586b40ebc9fbd1a" alt="Example of action fields for a personalized apology response made by GPT-3" data-size="original">

3. Faça o mesmo para qualquer outro bloco que você gostaria de personalizar. No nosso exemplo, criamos uma intenção chitchat.tell\_a\_joke que aciona uma resposta gerada pelo GPT de uma piada que leva em conta o contexto acima:

<img src="/files/3a53f3579dae3b8be6257bf2a22d15eb92bdb030" alt="Example of action fields for a personalized joke made by GPT-3 and based on the context of the conversation" data-size="original">

4. Você agora pode ter interações mais contextualizadas com seus clientes!

<img src="/files/a76c1aa3f71ff85974a7fff111277a1fbc589f57" alt="Conversation sample of a flow that uses GPT-3 to generate a personalized apology then a joke" data-size="original">

</details>

## Limitações dos modelos GPT

GPT-3, ChatGPT e GPT-4 são modelos de IA generativa desenvolvidos pela OpenAI, que fica nos EUA. Como ele é generativo, não controlamos o que o GPT cria. Dependendo da entrada que recebe, a resposta pode ser muito boa, conter informações incorretas ou até ser ofensiva. Portanto, **não recomendamos o uso do GPT em produção (ou seja, em um bot voltado para clientes) sem testes completos e entendimento dos riscos**.

{% hint style="danger" %}
Não recomendamos o uso da integração OpenAI em produção (ou seja, em um bot voltado para clientes). Ainda assim, se você quiser usá-la em produção, você deve [usar sua própria chave de API da OpenAI.](#set-up-the-gpt-3-integration) Consulte também os [termos de serviço da OpenAI](https://openai.com/terms/) para entender as implicações de usar os serviços da OpenAI.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.chatlayer.ai/chatlayer-documentation-pt-br/integrateandcode/app-integrations/openai-gpt-3-chatgpt-and-gpt-4.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.