- Criado por Iago Sousa em 07/04/2025
Envia dados e solicitações para o ChatGPT diretamente de dentro da aplicação.
Figura 1 - Bloco Enviar um prompt para ChatGPT
As informações fornecidas por meio deste bloco são de responsabilidade exclusiva da OpenAI, sendo obtidas através da API da OpenAI e o Cronapp não tem controle sobre o conteúdo retornado.
Ao disponibilizar essas informações em sua aplicação, recomendamos criar um termo de uso para se isentar de responsabilidades em casos de conteúdos inadequados, como material ilegal ou violento, que possam ser retornados pela API da OpenAI. Para mais detalhes, consulte nossos Termos e Condições de Uso e as Diretrizes de IA Cronapp.
Compatibilidade
- Bloco servidor: cronapi.chatgpt.Operations.sendPromptChatGPT()
Retorno
Retorna um objeto JSON com os dados da requisição para o ChatGPT.
Características do bloco
Para utilizar este bloco, é necessário obter a chave da API (Token) no site do OpenAI. Uma vez feito o login, acesse o menu contido no símbolo do avatar (destaque 1 da figura 2), logo ao lado direito do símbolo de engrenagem, e escolha a opção "Your Profile", ou, "Seu Perfil". Em seguida, acesse a opção "Users API Keys" (destaque 2). Será necessário confirmar seu número de telefone para criar a primeira chave da API.
Figura 2 - Obtendo o Token da API do ChatGPT
Não compartilhe sua chave de API com outras pessoas nem a exponha no navegador ou em outro código do lado cliente.
Parâmetros
Token
Parâmetro obrigatório. Chave de API utilizada para conexão com o ChatGPT.
- Posição: 1
- Inglês: Token
- Tipo: Texto / String
- Exemplo: "
SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c
"
Modelo
Parâmetro opcional. Escolha um dos vários modelos disponíveis na API. Você pode consultar a documentação de Modelos para entender quais modelos estão disponíveis e as diferenças entre eles.
- Posição: 2
- Inglês: Model
- Tipo: Texto / String
- Exemplo: "
GPT-4o
"
Duração
Parâmetro opcional. Se refere ao tempo que leva para gerar a saída de um modelo.
- Posição: 3
- Inglês: Duration
- Tipo: Decimal / Double
- Exemplo: 2.0
Temperatura
Parâmetro opcional. Define a aleatoriedade das respostas geradas pelo modelo, com 0 sendo menos aleatório (ou mais determinístico) e 2 sendo mais aleatório (menos determinístico). Ao usar valores baixos para temperatura (por exemplo, 0,2), as respostas do modelo tenderão a ser mais consistentes, mas podem parecer mais robóticas.
Valores maiores que 1,0, especialmente valores próximos a 2,0, podem levar a saídas erráticas do modelo. Se seu objetivo for saídas criativas, uma combinação de uma temperatura um pouco maior que o normal (por exemplo, 1,2) combinada com um prompt pedindo especificamente ao modelo para ser criativo pode ser sua melhor aposta, mas encorajamos a experimentação.
- Posição: 4
- Inglês: Temperature
- Tipo: Decimal / Double
- Exemplo: 2
Máximo de Tokens
Parâmetro opcional. Especifica o limite de tokens que o modelo pode gerar em uma resposta. Inclui tanto o prompt (entrada) quanto a resposta (saída). O total (entrada + saída) não deve ultrapassar o comprimento máximo do contexto do modelo. Ajustar este parâmetro controla o tamanho da resposta: valores altos resultam em respostas mais longas, enquanto valores baixos produzem respostas mais concisas.
- Posição: 5
- Inglês: Max tokens
- Tipo: Inteiro / Integer
- Exemplo: 1000
Usuário
Parâmetro opcional. Identificador exclusivo que representa seu usuário final. Recomendamos fazer hash do nome de usuário ou endereço de e-mail, para evitar o envio de qualquer informação de identificação.
- Posição: 6
- Inglês: User
- Tipo: Texto / String
- Exemplo: "meuUsuario_123"
Entrada
Parâmetro obrigatório. Mensagem que será enviada para o ChatGPT.
- Posição: 7
- Inglês: Prompt
- Tipo: Texto / String
- Exemplo: "O que é uma fonte de dados no Cronapp?"
Exemplo
No exemplo da figura abaixo, incluímos o token de acesso à API do ChatGPT e selecionamos o modelo GPT-4. Para interagir com o chat, vinculamos a função a um formulário de referência, que contém três componentes: um componente entrada de texto para enviar mensagens, uma área de texto para exibir as respostas do chat e um botão para acionar a função. A exibição da mensagem é realizada pelo bloco Alterar valor do campo, que recebe, no parâmetro "Valor", a resposta obtida do bloco Obter campo do Mapa por caminho.
Figura 3 - Exemplo de uso do bloco Enviar um prompt para ChatGPT
O resultado da execução da função pode ser conferido na figura abaixo.
Figura 3.1 - Resultado da execução da função da figura 3
Nesta página