# Chat Completion

{% hint style="info" %}
Cadastre uma conta de serviço do tipo **Bearer Token** para realizar a conexão com o serviço de IA OpenAI.
{% endhint %}

{% tabs %}
{% tab title="Parâmetros" %}

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdF4qKN7hQvu3q16BtPoFfVqg2IW-qslrwoyFnlTGmG1omV2t6z6XF7xiincIwfjXBmv-p0K7upys_ITFD_kCO2JkvzFMolf0WXnZ0a7AZyb0sYXeMaFnF3UQW5Zf6AtqI233JqDw?key=yLogrgEbXy0K_a4zmB9ApgKO" alt=""><figcaption><p>Parâmetros de configuração</p></figcaption></figure>

| Campo                      | Tipo                 | Descrição                                                                                                                                                                                                                                  |
| -------------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Descrição                  | Campo de texto       | Descrição visual do conector no editor de fluxo.                                                                                                                                                                                           |
| Conta de serviço           | Seletor              | Permite selecionar contas de serviço do tipo Bearer Token para realizar a conexão com serviço de IA.                                                                                                                                       |
| Modelos                    | Seletor              | Lista os modelos disponíveis na API OpenAI. Necessário selecionar uma conta de serviço OpenAI valida.                                                                                                                                      |
| Mensagem                   | Tabela de parâmetros | Tabela de parâmetros para configuração do chat completion.                                                                                                                                                                                 |
| Role                       | Seletor              | Permite selecionar entre os papéis Sistema, IA, Usuário para processamento de mensagens pelo modelo selecionado.                                                                                                                           |
| Tipo da mensagem           | Seletor              | <p>Refere-se ao tipo da entrada de dados para processamento de modelo. Tipos disponíveis:</p><ul><li>Texto</li><li>Audio (URL ou Base64)</li><li>Imagem (URL ou Base64)</li></ul>                                                          |
| Mensagem                   | Campo de texto       | Prompt ou mensagem a ser processada pelo modelo selecionado.                                                                                                                                                                               |
| Temperatura                | Campo de texto       | Parametrização para controlar a variabilidade das respostas, com valores entre 0 e 2. Um valor mais baixo resulta em respostas mais focadas e determinísticas, enquanto valores mais altos incentivam respostas mais criativas e variadas. |
| Top-P                      | Campo de texto       | Parametrização para controlar a aleatoriedade das respostas, usado em conjunto ou em substituição a Temperatura.                                                                                                                           |
| Número máximo de de tokens | Campo de texto       | Limita o número de tokens na resposta, ajudando a controlar a quantidade de saída e os custos.                                                                                                                                             |
| Output Path                | Campo de texto       | Refere-se ao caminho do resultado do processamento pelo modelo na saída do conector                                                                                                                                                        |
| {% endtab %}               |                      |                                                                                                                                                                                                                                            |

{% tab title="Payload" %}

## Sucesso

Os resultados do processamento pelo modelo estarão disponíveis em formato de objeto JSON no caminho de saída do conector.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfCKRJ0NNoCWKq1RyCSjJ4McoGKwIDLCc-0A3jSUOxeiocrRysSWZudTAHUMLdkfZl70wCjMS9hPwprvnh2KfVyzQRFVjeZyPOg-oqivXNDkgHp2zKdevs7gVO8D6ooAtUJn6VAuw?key=yLogrgEbXy0K_a4zmB9ApgKO" alt=""><figcaption><p>Sucesso na requisição para serviço de IA.</p></figcaption></figure>

## Erros

Em casos de erro no caminho de saída do conector será informado o retorno da API e um booleano error com valor true, além de um objeto JSON response com dados adicionais.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXe8klARdYRKOM4M6Eq_NFSnezIXZ8I2PUykSJPG_ZzmTDG5YpTeLcmg8MEuZ2rD5oh_F6XUm5EB4kA3aVM4MmHrzJX2MkYxdu2ED38U0S4psUpZ976372tsUqxHYN5-NaOZ3_urew?key=yLogrgEbXy0K_a4zmB9ApgKO" alt=""><figcaption><p>Erro na requisição para serviço de IA.</p></figcaption></figure>

## Observação

Atente-se aos modelos utilizados no contexto do fluxo. Alguns modelos podem ter respostas diferentes conforme a parametrização do conector. Teste cenários relevantes para o seu contexto para garantir respostas esperadas.
{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.floui.io/guia/conectores/categorias/servicos-externos/openai/chat-completion.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.