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.
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.
📷 Inserir print: visão geral do módulo GPT Assistant na área de trabalho do fluxo
🧭 Como acessar
No menu lateral, clique em Gerenciamento de aplicativos.
Em seguida, clique em Fluxos.
Abra ou crie um fluxo e acesse a área de trabalho do fluxo.
No painel de módulos, localize a categoria IA generativa (identificada pela cor verde).
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
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.
🔍 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
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.
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.
📷 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.
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.
📷 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:
Adicione o módulo GPT Assistant ao fluxo.
No campo Integração, selecione a credencial GPT.
No campo System, escreva: "Você é um assistente de atendimento simpático, que responde de forma curta e usa emojis com moderação."
Preencha as Condições de saída com uma descrição de referência.
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.