Envia dados e solicitações para o ChatGPT diretamente de dentro da aplicação. É necessário informar uma base de dados para a consulta acontecer.


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.sendPromptChatGPTWithDocument()

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

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?"

Uri

Parâmetro obrigatório. É usado para especificar a URL do documento ou recurso que você deseja que o modelo considere ao gerar uma resposta. Esse parâmetro permite que você forneça uma localização externa onde o documento está hospedado, e o modelo pode acessar e utilizar as informações contidas nesse documento para responder à sua consulta de maneira mais informada e contextualizada.

  • Posição: 8
  • Inglês: Uri
  • Tipo: Texto / String
  • Exemplo: "https://docs.cronapp.io/pages/viewpage.action?pageId=145490301", "src/main/resources/assets/fonte_de_dados.txt"

Exemplo

No exemplo da figura abaixo, incluímos o token de acesso da API do ChatGPT e selecionamos o modelo gpt-4o. 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.

Definimos o parâmetro "Temperatura" com o valor 0.2 para que a resposta obtida fosse a mais precisa possível. Também definimos o número máximo de tokens como 1000. A base de dados utilizada para obter a resposta do chat foi a documentação do Cronapp Criar Plugin, a partir dela, uma resposta mais precisa será obtida.


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