> For the complete documentation index, see [llms.txt](https://help.hyperflow.global/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.hyperflow.global/docs/builder-hyperflow/gerenciamento-de-aplicativos/fluxos/ia-generativa/gpt-assistant.md).

# GPT Assistant

O módulo **GPT Assistant** envia uma instrução de comportamento (como se você estivesse explicando detalhadamente para uma pessoa como ela deve agir) para a inteligência artificial da OpenAI, e retorna a resposta completa gerada.

{% hint style="info" %}
Diferente do módulo **GPT Question** (que envia uma pergunta pontual e retorna só o texto da resposta), o GPT Assistant é pensado para definir um comportamento/instrução, e devolve a resposta no formato completo retornado pela OpenAI, não apenas o texto.
{% endhint %}

> 📷 Inserir print: visão geral do módulo GPT Assistant na área de trabalho do fluxo

## 🧭 Como acessar

1. No menu lateral, clique em **Gerenciamento de aplicativos**.
2. Em seguida, clique em **Fluxos**.
3. Abra ou crie um fluxo e acesse a área de trabalho do fluxo.
4. No painel de módulos, localize a categoria **IA generativa** (identificada pela cor verde).
5. Arraste o módulo **GPT Assistant** para a área de trabalho do fluxo.

> 📷 Inserir print: painel de módulos com a categoria IA generativa expandida e o módulo GPT Assistant visível

{% hint style="warning" %}
**Antes de usar este módulo:** é necessário ter uma integração do tipo **GPT** já cadastrada em **Integrações**, com a chave de acesso (API key) da sua conta na OpenAI.
{% endhint %}

## 🔍 Conhecendo o módulo

Ao clicar duas vezes no módulo na área de trabalho do fluxo, um painel de configuração é aberto na lateral da tela.

> 📷 Inserir print: painel de configuração do módulo GPT Assistant aberto

### ⚙️ Configuração

| Campo      | O que preencher                                                                                                                                              |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Integração | Selecione a credencial GPT já cadastrada em Integrações.                                                                                                     |
| Modelo     | Escolha o modelo de inteligência artificial a ser usado.                                                                                                     |
| System     | Escreva a instrução de comportamento que a inteligência artificial deve seguir (ex.: "Você é um assistente educado que responde de forma breve e objetiva"). |

> 📷 Inserir print: campos Integração, Modelo e System preenchidos

### 📋 Condições de saída

Os campos **Condições de saída — Sucesso** e **Condições de saída — Erro** são de preenchimento obrigatório para salvar o módulo.

{% hint style="warning" %}
No momento, o conteúdo desses dois campos não influencia qual saída é realmente ativada — a escolha entre Sucesso e Erro depende apenas de a chamada à inteligência artificial ter sido concluída ou não. Preencha-os com uma descrição de referência (por exemplo, "Resposta gerada com sucesso" e "Erro ao gerar resposta"), já que são obrigatórios para salvar.
{% endhint %}

> 📷 Inserir print: campos de Condições de saída preenchidos

### 🔀 Saídas do módulo

O módulo tem duas saídas:

* **Sucesso** — segue com a resposta completa da chamada disponível para os próximos módulos do fluxo.
* **Erro** — segue quando não é possível obter uma resposta.

{% hint style="info" %}
A resposta entregue na saída **Sucesso** vem no formato completo retornado pela OpenAI, e não apenas como um texto simples — pode ser necessário localizar o texto gerado dentro dessa estrutura para usá-lo em outro módulo.
{% endhint %}

> 📷 Inserir print: módulo na área de trabalho do fluxo mostrando as duas saídas disponíveis

## 💡 Caso de uso

**Cenário:** uma empresa quer que a inteligência artificial sempre responda seguindo um tom de voz específico, definido por uma instrução de comportamento.

**Configuração:**

1. Adicione o módulo **GPT Assistant** ao fluxo.
2. No campo **Integração**, selecione a credencial GPT.
3. No campo **System**, escreva: "Você é um assistente de atendimento simpático, que responde de forma curta e usa emojis com moderação."
4. Preencha as **Condições de saída** com uma descrição de referência.
5. Conecte a saída **Sucesso** para dar continuidade ao atendimento.

**Resultado:** as respostas geradas seguem o tom de voz definido na instrução.

## 📌 Dicas úteis

* Use este módulo quando quiser definir um comportamento ou personalidade para a inteligência artificial, em vez de fazer uma pergunta pontual (para isso, use o **GPT Question**).
* Este módulo não guarda memória de conversas anteriores.
* Como a resposta vem no formato completo da OpenAI, teste o resultado antes de usar diretamente em uma mensagem ao cliente.

## 📝 Resumo

* O módulo **GPT Assistant** envia uma instrução de comportamento para a inteligência artificial da OpenAI.
* Os campos principais são **Integração**, **Modelo** e **System**.
* Os campos de **Condições de saída** são obrigatórios para salvar, mas não determinam qual saída é ativada.
* A saída **Sucesso** entrega a resposta completa da chamada, não apenas o texto gerado.