# Assistente GPT

## Objetivo

O resultado final deste tutorial, será um assistente inteligente integrado a Hyperflow, que poderá atender os seus clientes em qualquer canal que você já tiver conectado. Ou seja, este atendente poderá atender clientes no WhatsApp, Instagram, ou qualquer outro canal, basta que ele esteja ativo na plataforma Hyperflow. Para ver mais sobre os nossos canais disponíveis, acesse a página [canais-de-atendimento](https://help.hyperflow.global/docs/canais-de-atendimento "mention")

**O assistente GPT também consegue processar documentos em sua base de dados**. Ou seja, se você tiver um manual, ou regras de como ele deve funcionar em PDF, você poderá inserir este documento em sua base de conhecimento, para que ele utilize este conhecimento para responder as perguntas.

**Com isso, é possível criar assistentes para diversas áreas, como SDR, suporte, dúvidas sobre produto, vendas, entre outros**. O ideal é que o assistente tenha um conjunto de regras bem definido. Abaixo você consegue ver um arquivo contendo um exemplo de prompt para o assistente GPT.

## Requisitos

Para o funcionamento do Assistente GPT, será necessário ter uma conta na [OpenAI](https://platform.openai.com) (Empresa que possui o produto chat GPT). Além da conta, **é necessário ter um saldo para utilização do assistente**. Diferente da versão normal do Chat GPT, toda consulta ao assistente gera custo, então é necessário ter realizado uma recarga na OpenAI e possuir saldo para utilizar o assistente. Não existe custo adicional da Hyperflow para utilização desta funcionalidade.

A tabela de custos completa para utilizar o GPT, você pode consultar [neste link](https://openai.com/pricing).

Para exemplificação, se utilizar o modelo *"gpt-4-1106-preview"*, que é o recomendado para o assistente, você será cobrado aproximadamente USD 0,01 a cada 750 palavras que envia de perguntas ao GPT, e USD 0,03 a cada 750 palavras de resposta geradas pelo GPT. É possível acompanhar o custo em tempo real no painel da OpenAI. 

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FLkSO2tQqmD0pAO7aXU4u%2Fimage.png?alt=media&#x26;token=00d22253-9ac6-4617-9e65-66f4cff6a4bb" alt=""><figcaption><p>Imagem 1 - Painel da OpenAI, onde é possível conferir o saldo atual da sua conta.</p></figcaption></figure>

Além da conta da OpenAI, você precisará ter uma conta na Hyperflow, com o Desk ativo, pois lá será realizada a integração com o assistente.

## Criando o seu assistente inteligente

Antes de integrar o assistente na Hyperflow, você precisa criar as regras e conhecimento do assistente, direto pelo painel da OpenAI. Para isso, acesse o link, e após isso, clique no botão para criar um novo assistente.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2Fs1rVmuuDRqEuxXiubpI5%2Fimage.png?alt=media&#x26;token=e9c90792-209f-4038-aa92-7541b13c82e7" alt=""><figcaption><p>Imagem 2 - Botão para criar um novo assistente</p></figcaption></figure>

Ao criar o assistente, você deverá informar o nome do seu assistente, as instruções que ele deve seguir, o modelo a ser utilizado, e habilitar a opção "*Retrieval*" caso queira usar documentos em sua base de conhecimento.  No exemplo deste tutorial, estamos criando um assistente que é um pré-vendas da Hyperflow.

{% hint style="info" %}
A qualidade e a assertividade do seu assistente, depende das instruções fornecidas. Tente fornecer o maior número de informações de forma estruturada e organizada. Uso o nosso exemplo abaixo como ponto de partida para a criação das suas instruções.
{% endhint %}

Você poderá consultar as instruções, e um exemplo de como fornecer isso para o seu assistente, no arquivo abaixo 👇

{% file src="<https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FQQPUMIL2JEdZ1THGohhn%2Finstruc%CC%A7o%CC%83esManuHyperflow.txt?alt=media&token=9318fffa-bbd7-45ff-98e7-ef8b217a7d96>" %}
Arquivo 1 - Exemplo de instruções para o assistente
{% endfile %}

Para o campo "Modelo", você pode selecionar a opção "*gpt-4-1106-preview*".

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2Fef9DfEW4wRtIpV6AskUt%2Fgptregister.png?alt=media&#x26;token=e32a9add-61f2-4685-9308-30c9fa956ebd" alt=""><figcaption><p>Imagem 3 - Exemplo de criação do assistente</p></figcaption></figure>

Após a criação, você poderá clicar no botão "Test" para testar e ver o seu assistente funcionando na prática. **Durante os testes, você poderá ter insights para melhorar as instruções do seu assistente. Basta fazer algumas conversas de teste, e atualizar as instruções se necessário.**

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FAslc5a84pvcg1mEOpDEY%2Fgptteste.png?alt=media&#x26;token=2b908484-539b-4479-bc79-6e8c75430165" alt=""><figcaption><p>Imagem 4 - Interface de teste do assistente criado</p></figcaption></figure>

Após a validação do seu assistente, agora vamos conectá-lo a Hyperflow, para que ele possa interagir através dos canais digitais, e trabalhar junto com a sua equipe.

## Conectando o assistente a Hyperflow

Com o assistente criado e validado, agora basta conectar ele dentro da Hyperflow para que ele possa atender os seus clientes. Para isso, acesse o desk em <https://desk.hyperflow.global>, e configure o assistente na aba de "Agentes"

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FcbMLSCKomAjaD3up0SwD%2Fimage.png?alt=media&#x26;token=356d6181-05f9-4ff8-96eb-f0449febf77f" alt=""><figcaption><p>Imagem 5 - Criando o seu assistente inteligente dentro da Hyperflow</p></figcaption></figure>

Preencha os dados do modal de criação, informando:

* **Nome:** O nome do seu assistente
* **API KEY:** Chave de API obtida dentro do painel da OpenAI. Você pode criar uma chave em <https://platform.openai.com/api-keys>
* **Assistant ID:** ID do assistente criado na OpenAI e pode ser obtido em <https://platform.openai.com/assistants> . Este ID possui o padrão: asst\_xxxxxxxxxxxxxxxxx

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FlP29vLs2qYgOaNisuojU%2Fimage.png?alt=media&#x26;token=845219e1-be86-444e-a033-96ae7c841ae7" alt=""><figcaption></figcaption></figure>

* **Organization ID**: esse número é a identificação da sua organização. Ele pode ser obtido no link <https://platform.openai.com/settings/organization/general> e tem  o padrão org-xxxxxxxxx

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2F2Nm265D9SetrxJ8cHa05%2Fimage.png?alt=media&#x26;token=05a410f2-77bd-4846-b02b-d2509761bde5" alt=""><figcaption></figcaption></figure>

* **Departamentos:** O departamento em que o assistente irá trabalhar. O recomendo é criar um departamento específico para os assistentes inteligentes. Exemplo: Vendas (GPT).

Além destas informações, você pode definir **Gatilhos.** Com estes gatilhos, você pode definir para que sempre que o GPT ou o usuário fale um determinado texto, o atendimento seja transferido para outro departamento, ou encerrado com uma determinada classificação. Dessa forma, ao chegar no final da jornada, você já poderá classificar ou transferir o atendimento do assistente para o departamento necessário.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2F3SdiHdKU6iPVdp2bFLGC%2Fimage.png?alt=media&#x26;token=70682e53-39bd-45b2-90c0-34a0a8dcb6a2" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
Pronto! O seu assistente está configurado e pronto para uso! Agora basta transferir para este departamento, que o assistente inteligente irá assumir a conversa e responder o seu usuário!
{% endhint %}

Caso tenha qualquer outra dúvida, entre em contato com o nosso suporte, para que o nosso time possa te auxiliar na configuração do assistente inteligente


---

# 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://help.hyperflow.global/docs/assistente-gpt.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.