OpenAI

• Visão Geral
• Usabilidade
• Geração de Respostas
• Embeddings
• Transcrição de Voz
• Sintetização de Voz
• Configuração do Token

Visão Geral

Este documento descreve o componente da OpenAI do Construtor de Bot, oferecendo uma solução avançada para criação de fluxos inteligentes e interações naturais com usuários. O componente permite personalizar completamente o comportamento da IA por meio de parâmetros configuráveis, garantindo respostas dinâmicas e contextualizadas dentro dos fluxos do bot.

Usabilidade

Geração de Respostas

A aba de geração de respostas permitirá ao usuário definir o modelo de IA a ser utilizado, instruir comportamento da IA através do prompt, definir quantas mensagens anteriores do chat serão consideradas como contexto da resposta, limitar a quantidade de tokens gerados para controle de custo, controlar a criatividade da IA(mais objetivo, mais simpatico…) e definir o nome da variável para utilização dentro do fluxo. Além disso, poderão ser criadas funções específicas para interações definindo o identificador, descrição e os parâmetros da função para retorno.

Retorno da variável:

{
  "status": 200,
  "body": {
    "id": "resp_67ccd2bed1ec8190b14f964abc0542670bb6a6b452d3795b",
    "object": "response",
    "created_at": 1741476542,
    "status": "completed",
    "error": null,
    "incomplete_details": null,
    "instructions": null,
    "max_output_tokens": null,
    "model": "gpt-4.1-2025-04-14",
    "output": [
      {
        "type": "message",
        "id": "msg_67ccd2bf17f0819081ff3bb2cf6508e60bb6a6b452d3795b",
        "status": "completed",
        "role": "assistant",
        "content": [
          {
            "type": "output_text",
            "text": "In a peaceful grove beneath a silver moon, a unicorn named Lumina discovered a hidden pool that reflected the stars. As she dipped her horn into the water, the pool began to shimmer, revealing a pathway to a magical realm of endless night skies. Filled with wonder, Lumina whispered a wish for all who dream to find their own hidden magic, and as she glanced back, her hoofprints sparkled like stardust.",
            "annotations": []
          }
        ]
      }
    ],
    "parallel_tool_calls": true,
    "previous_response_id": null,
    "reasoning": {
      "effort": null,
      "summary": null
    },
    "store": true,
    "temperature": 1.0,
    "text": {
      "format": {
        "type": "text"
      }
    },
    "tools": [],
    "top_p": 1.0,
    "truncation": "disabled",
    "usage": {
      "input_tokens": 36,
      "input_tokens_details": {
        "cached_tokens": 0
      },
      "output_tokens": 87,
      "output_tokens_details": {
        "reasoning_tokens": 0
      },
      "total_tokens": 123
    },
    "user": null,
    "metadata": {}
  }
}

Embeddings

A aba de embeddings permitirá ao usuário definir o modelo de embeddings e os textos de entrada, tanto por meio de input manual quanto de variável e definir o nome da variável para utilização dentro do fluxo

Retorno da variável:

{
   "status": 200,
   "body": {
        "object": "list",
        "data": [
            {
                "object": "embedding",
                "embedding": [
                    0.0023064255,
                    -0.009327292,
                    .... (1536 floats total for ada-002)
                    -0.0028842222,
                ],
                "index": 0
            }
        ],
        "model": "text-embedding-ada-002",
        "usage": {
            "prompt_tokens": 8,
            "total_tokens": 8
        },
        "error": ""  
    }
}

Transcrição de Voz

A aba de transcrição de voz permitirá ao usuário definir o modelo de IA, informar a variável de voz onde se encontra o áudio para realizar a transcrição para texto e definir o nome da variável para utilização dentro do fluxo.

Retorno da variável:

{    
  "status": 200,   
  "body": {  
   "text": "Texto da transcrição", 
   "error": ""
  } 
}

Sintetização de Voz

A aba de sintetização de voz permitirá ao usuário definir o modelo de IA, informar a variável onde se encontra o texto, selecionar o modelo de voz desejado (permite demonstração) e definir o nome da variável para utilização dentro do fluxo.

Retorno da variável:

{     
  "status": 200,
  "body": {         
    "url": "https://seu_audio.wav",         
    "error": ""     
  } 
}

Configuração do Token

Para utilizar o componente da Openai, o usuário deverá realizar o cadastro do token na funcionalidade do Neppo Vault. Para isso, basta acessar a funcionalidade, expandir o diretório da Openai e clicar em “Editar Item”.

Ao clicar em “Editar Item” , exibirá uma interface para informar os dados do token no campo “Valor”. Após informar os dados e clicar no botão “Salvar”, caso os dados sejam válidos, o componente da Openai já poderá ser utilizado.