For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

  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

🔍 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.

📷 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:

  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.