> For the complete documentation index, see [llms.txt](https://docs.floui.io/guia/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.floui.io/guia/conectores/categorias/servicos-externos/openai/chat-completion.md).

# 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.