> For the complete documentation index, see [llms.txt](https://docs.flosum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flosum.com/devops/devops-pt-br/configuracoes/configuracoes-de-ia/adicionando-um-modelo-de-ia-personalizado.md).

# Adicionando um modelo de IA personalizado

{% hint style="warning" %}

#### Escrito para a interface antiga

Este artigo foi escrito para a interface antiga. As instruções ainda podem ser usadas, mas as capturas de tela estão desatualizadas. Em alguns casos, os itens referenciados nas instruções foram movidos ou alterados. Se você não conseguir encontrar um item, consulte o [Para onde foi](/devops/devops-pt-br/transicao-para-a-nova-ui-ux/para-onde-foi.md) artigo.
{% endhint %}

## ![](https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FG5ZbxX918xOHwbAwAJ4n%2FSummary2-Small-Icon.svg?alt=media\&token=da26a67f-ff7f-47b3-8669-06be960dc2d7) Visão geral

Este artigo explica como conectar um modelo de IA personalizado ao DevOps, substituindo os recursos de IA compartilhados da Flosum. Usar seu próprio modelo pode melhorar o desempenho, reduzir a latência e ajudar a evitar erros temporários causados por alta carga nos recursos de IA compartilhados da Flosum. Um modelo auto-hospedado também pode oferecer segurança da informação mais मजबूत do que provedores de IA em nuvem. Dependendo do provedor e do modelo que você escolher, você pode ver melhorias na velocidade e na confiabilidade. Para conectar, você precisará de um token de API do provedor escolhido. Para saber mais sobre os recursos de IA no DevOps, consulte o artigo a seguir.

* [Visão geral dos recursos de IA](/devops/devops-pt-br/configuracoes/configuracoes-de-ia/visao-geral-dos-recursos-de-ia.md)

{% hint style="info" %}

#### Melhores práticas

* Valide a configuração do seu modelo de IA personalizado em uma branch de não produção antes de implantá-la mais amplamente.
* Use um endpoint de API do provedor de modelo de IA que atenda aos seus requisitos de segurança (nuvem vs. auto-hospedado).
* Armazene seu token de API com segurança e faça sua rotação com base nos seus requisitos de segurança.
  {% endhint %}

### Modelos de IA compatíveis

* DeepSeek Chat
* DeepSeek Raciocinador
* GPT 4o
* GPT 4o Mini
* GPT 4.1
* GPT 4.1 Mini
* GPT 5
* GPT 5 Mini

## Adicionando um modelo personalizado

{% stepper %}
{% step %}

### Acessar configurações de IA

1. Clique em **Configurações** no menu da barra lateral esquerda.
2. Clique no **Geral** .
3. Clique em **Configurações de IA**.

   <div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2F4ttPCgSU5HP1IPyvoqYJ%2FAddingACustomAiModel-S01-01.png?alt=media&amp;token=f69f004f-466a-4b97-9dc3-ebf029cf924c" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### Ativar modelo personalizado

1. Ative o **modelo personalizado** alternância.

   <div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2Fofv151HeCuDIiIukdNut%2FAddingACustomAiModel-S02-01.png?alt=media&amp;token=42bcde25-985b-4d60-80d6-806305804745" alt="" width="563"><figcaption></figcaption></figure></div>
2. Clique no **Modelo** menu suspenso.

   <div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FTAmUyHgwM6MVUp12MAj9%2FAddingACustomAiModel-S02-02.png?alt=media&amp;token=ae1b724c-cf90-42aa-899c-787f4906dc4a" alt="" width="563"><figcaption></figcaption></figure></div>
3. Selecione o modelo de IA ao qual você está se conectando.

   <div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2F86nH2jjAtyuBxtWRkir8%2FAddingACustomAiModel-S02-03.png?alt=media&amp;token=8c543004-9cbe-420e-a2aa-f847dc29d8df" alt="" width="563"><figcaption></figcaption></figure></div>
4. No **URL da API** caixa de texto, insira a URL do endpoint do modelo de IA ao qual você está se conectando.

{% hint style="info" %}

#### URL da API

**Endpoint da API do DeepSeek**

Você pode se conectar a um modelo DeepSeek hospedado pela DeepSeek usando a seguinte URL:

* <https://api.deepseek.com>

**Endpoint da API da OpenAI**

Você pode se conectar a um modelo GPT hospedado pela OpenAI usando a seguinte URL:

* <https://api.openai.com/v1>

**Endpoint de API de terceiros ou auto-hospedado**

Você pode se conectar a qualquer modelo de IA de terceiros ou auto-hospedado que use um endpoint de API compatível com OpenAI. A URL da API deve estar acessível a partir dos servidores da Flosum.
{% endhint %}

5. No **Token** caixa de texto, insira seu token de API para conectar-se ao modelo de IA.

   <div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2Fs5BINaUQSDNfQjxllgfw%2FAddingACustomAiModel-S02-04.png?alt=media&amp;token=63144fa0-4e71-4090-ba50-c4868c98632d" alt="" width="563"><figcaption></figcaption></figure></div>
6. Clique em **Salvar**.

   <div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FnF10iwJbDWP9zafv50mm%2FAddingACustomAiModel-S02-05.png?alt=media&amp;token=c0c93ab0-3020-40cc-bd8a-c2bec84ec09b" alt="" width="563"><figcaption></figcaption></figure></div>
7. Se a conexão com o modelo de IA for bem-sucedida, você verá a mensagem "**Modelo de IA configurado com sucesso.**"
   {% endstep %}

{% step %}

### Usando recursos de IA

Para instruções sobre como usar os recursos de IA do DevOps, consulte os seguintes artigos:

* Criador de classe de teste de IA
* AI Code Documenter
  {% endstep %}
  {% endstepper %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.flosum.com/devops/devops-pt-br/configuracoes/configuracoes-de-ia/adicionando-um-modelo-de-ia-personalizado.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
