> ## Documentation Index
> Fetch the complete documentation index at: https://ai-kb.automationanywhere.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Modelos Predefinidos e Personalizados

> Configure modelos LLM para seus agentes - use modelos padrão ou traga suas próprias chaves de API

A EKB não apenas traz os modelos mais recentes e populares disponíveis, nós permitimos que você conecte seu próprio modelo personalizado com nossa funcionalidade "Traga Suas Próprias Chaves" (BYOK). Isso dá a você a capacidade de criar Agentes personalizados e testar como eles respondem ou completam as tarefas que você atribui, para que você possa usar o LLM que produz os melhores resultados para o seu caso de uso. Neste artigo, você aprenderá sobre os diferentes LLMs disponíveis e como conectar seu próprio LLM personalizado aos seus Agentes.

Seus agentes podem usar dois tipos de modelos:

<CardGroup cols={2}>
  <Card title="Modelos Predefinidos" icon="sparkles">
    Modelos pré-configurados disponíveis para todos os usuários — nenhuma chave de API necessária.
  </Card>

  <Card title="Modelos Personalizados (BYOK)" icon="key">
    Modelos que você configura com suas próprias chaves de API para controle total de custos e flexibilidade.
  </Card>
</CardGroup>

## Modelos Predefinidos

Os modelos predefinidos estão disponíveis por padrão e não requerem configuração de chave de API. Esses modelos são gerenciados pela EKB e estão prontos para uso.

A EKB fornece acesso a uma ampla gama de modelos dos principais provedores de IA, incluindo OpenAI, Anthropic, Google AI e mais. A lista completa de modelos disponíveis é exibida no seletor de modelos ao configurar seu agente.

### Modelos Disponíveis por Provedor

Todos os modelos disponíveis são visíveis no menu suspenso do seletor de modelos ao configurar seu agente. Os modelos são organizados por provedor e mostram seu custo, capacidades e status de disponibilidade.

| Modelo                    | Provedor  | Versão                                      | Créditos / 1M Entrada | Créditos / 1M Saída | Descontinuação          |
| ------------------------- | --------- | ------------------------------------------- | --------------------- | ------------------- | ----------------------- |
| **Haiku 4.5**             | Anthropic | `claude-haiku-4-5-20251001`                 | 1.000                 | 5.000               | Não antes de 15/10/2026 |
| **Sonnet 4.5**            | Anthropic | `claude-sonnet-4-5-20250929`                | 3.000                 | 15.000              | Não antes de 29/09/2026 |
| **Sonnet 4.6**            | Anthropic | `claude-sonnet-4-6`                         | 3.000                 | 15.000              | Não antes de 17/02/2027 |
| **DeepSeek Chat**         | DeepSeek  | `deepseek-chat`                             | 140                   | 280                 | 24/07/2026              |
| **Gemini 2.5 Flash**      | Google AI | `gemini-2.5-flash`                          | 300                   | 2.500               | Não antes de 16/10/2026 |
| **Gemini 3.1 Flash-Lite** | Google AI | `gemini-3.1-flash-lite`                     | 250                   | 1.500               | N/D                     |
| **Gemini 3.5 Flash**      | Google AI | `gemini-3.5-flash`                          | 1.500                 | 9.000               | N/D                     |
| **Llama 4 Scout**         | Groq      | `meta-llama/llama-4-scout-17b-16e-instruct` | 80                    | 300                 | N/D                     |
| **GPT 4o**                | OpenAI    | `gpt-4o`                                    | 5.000                 | 15.000              | N/D                     |
| **GPT 4o Mini**           | OpenAI    | `gpt-4o-mini`                               | 150                   | 600                 | N/D                     |
| **GPT 4.1**               | OpenAI    | `gpt-4.1-2025-04-14`                        | 2.000                 | 8.000               | N/D                     |
| **GPT 4.1 Mini**          | OpenAI    | `gpt-4.1-mini-2025-04-14`                   | 400                   | 1.600               | N/D                     |
| **GPT 4.1 Nano**          | OpenAI    | `gpt-4.1-nano-2025-04-14`                   | 100                   | 400                 | N/D                     |
| **GPT 5**                 | OpenAI    | `gpt-5`                                     | 1.250                 | 10.000              | N/D                     |
| **GPT 5 Mini**            | OpenAI    | `gpt-5-mini`                                | 250                   | 2.000               | N/D                     |
| **GPT 5 Nano**            | OpenAI    | `gpt-5-nano`                                | 50                    | 400                 | N/D                     |
| **GPT 5.1**               | OpenAI    | `gpt-5.1`                                   | 1.000                 | 1.000               | N/D                     |
| **GPT 5.2**               | OpenAI    | `gpt-5.2`                                   | 2.000                 | 15.000              | N/D                     |
| **GPT 5.4**               | OpenAI    | `gpt-5.4-2026-03-05`                        | 2.500                 | 15.000              | N/D                     |
| **GPT 5.4 Mini**          | OpenAI    | `gpt-5.4-mini-2026-03-17`                   | 750                   | 4.500               | N/D                     |
| **GPT 5.4 Nano**          | OpenAI    | `gpt-5.4-nano-2026-03-17`                   | 200                   | 1.250               | N/D                     |
| **GPT 5.5**               | OpenAI    | `gpt-5.5`                                   | 5.000                 | 30.000              | N/D                     |
| **o3 Mini**               | OpenAI    | `o3-mini`                                   | 1.100                 | 4.400               | N/D                     |

### Seleção de Modelo

<Steps>
  <Step title="Navegue até Agentes">
    Vá para **Agentes** na barra lateral.
  </Step>

  <Step title="Abra um agente">
    Crie um novo agente ou selecione um existente.
  </Step>

  <Step title="Vá para a aba Geral">
    Abra a aba **Geral** na configuração do agente.
  </Step>

  <Step title="Selecione um modelo">
    Encontre o seletor suspenso **Modelo** ao lado do nome do agente e selecione um modelo predefinido no menu suspenso.
  </Step>
</Steps>

### Informações do Modelo

Cada modelo predefinido mostra:

| Campo              | Descrição                                                      |
| ------------------ | -------------------------------------------------------------- |
| **Nome do Modelo** | Nome exibido (ex.: "GPT 4o")                                   |
| **Provedor**       | Provedor de API (OpenAI, Anthropic, Google AI, DeepSeek, Groq) |
| **Custo**          | Créditos por 1M tokens de entrada e saída                      |
| **Descontinuação** | Data provável de descontinuação ou aposentadoria               |

## Modelos Personalizados (BYOK)

Traga Sua Própria Chave (BYOK) permite que você configure modelos personalizados usando suas próprias chaves de API. Isso dá a você:

<CardGroup cols={2}>
  <Card title="Controle de Custos" icon="circle-dollar-to-slot">
    Use suas próprias chaves de API e faturamento.
  </Card>

  <Card title="Flexibilidade de Modelos" icon="sliders">
    Acesse modelos não disponíveis na lista predefinida.
  </Card>

  <Card title="Endpoints Personalizados" icon="link">
    Conecte-se a endpoints de modelo privados ou personalizados.
  </Card>

  <Card title="Escolha do Provedor" icon="building">
    Use qualquer provedor de API compatível.
  </Card>
</CardGroup>

### Provedores Suportados

<AccordionGroup>
  <Accordion title="OpenAI">
    Suporta modelos de API OpenAI padrão, endpoints Azure OpenAI e endpoints personalizados compatíveis com OpenAI.

    | Campo              | Valor                                |
    | ------------------ | ------------------------------------ |
    | **Chave de API**   | Sua chave de API OpenAI              |
    | **URL da API**     | `https://api.openai.com/v1` (padrão) |
    | **Nome do Modelo** | ex.: `gpt-4`, `gpt-3.5-turbo`        |
  </Accordion>

  <Accordion title="Anthropic">
    Suporta modelos Claude via Anthropic API e endpoints personalizados compatíveis com Anthropic.

    | Campo              | Valor                                |
    | ------------------ | ------------------------------------ |
    | **Chave de API**   | Sua chave de API Anthropic           |
    | **URL da API**     | `https://api.anthropic.com` (padrão) |
    | **Nome do Modelo** | ex.: `claude-sonnet-4-6`             |
  </Accordion>

  <Accordion title="Google AI">
    Suporta modelos Gemini via Google AI API e endpoints personalizados do Google AI.

    | Campo              | Valor                                                 |
    | ------------------ | ----------------------------------------------------- |
    | **Chave de API**   | Sua chave de API Google AI                            |
    | **URL da API**     | `https://generativelanguage.googleapis.com/` (padrão) |
    | **Nome do Modelo** | ex.: `gemini-2.5-flash`                               |
  </Accordion>

  <Accordion title="OpenRouter">
    Fornece acesso a múltiplos provedores de modelos por meio de uma API unificada para vários modelos.

    | Campo              | Valor                                    |
    | ------------------ | ---------------------------------------- |
    | **Chave de API**   | Sua chave de API OpenRouter              |
    | **URL da API**     | Endpoint OpenRouter                      |
    | **Nome do Modelo** | Qualquer modelo disponível no OpenRouter |
  </Accordion>

  <Accordion title="AWS Bedrock">
    Suporta modelos Amazon Bedrock e vários modelos de base.

    | Campo               | Valor                           |
    | ------------------- | ------------------------------- |
    | **Credenciais AWS** | Configuradas separadamente      |
    | **URL da API**      | Endpoint Bedrock                |
    | **Nome do Modelo**  | Identificador do modelo Bedrock |
  </Accordion>

  <Accordion title="Endpoints Personalizados">
    Suporta qualquer endpoint de API compatível com OpenAI, incluindo implantações privadas e modelos auto-hospedados.

    | Campo              | Valor                                          |
    | ------------------ | ---------------------------------------------- |
    | **Chave de API**   | Sua chave de API personalizada (se necessária) |
    | **URL da API**     | URL do seu endpoint personalizado              |
    | **Nome do Modelo** | Seu identificador de modelo                    |
  </Accordion>
</AccordionGroup>

## Adicionando Modelos Personalizados

<Steps>
  <Step title="Navegue até Agentes">
    Vá para **Agentes** na barra lateral.
  </Step>

  <Step title="Abra um agente">
    Crie um novo agente ou selecione um existente para editar.
  </Step>

  <Step title="Vá para a aba Configurações">
    Abra a aba **Configurações** na configuração do agente.
  </Step>

  <Step title="Abra Modelos Personalizados">
    Role até a seção **Modelos Personalizados** e clique em **+Adicionar Modelo**.
  </Step>

  <Step title="Preencha os detalhes do modelo">
    O modal de configuração do modelo será aberto. Insira o seguinte:

    | Campo                            | Descrição                                                                                                                 |
    | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
    | **Nome do Modelo**               | O nome exato do modelo conforme reconhecido pela API (ex.: `gpt-4`, `claude-sonnet-4-6`)                                  |
    | **Provedor do Modelo**           | Selecione o provedor no menu suspenso (OpenAI, Anthropic, Azure, Google AI, OpenRouter, AWS Bedrock, Personalizado, etc.) |
    | **Chave de API**                 | Sua chave de API para o provedor selecionado. Armazenada com segurança.                                                   |
    | **URL da API**                   | A URL do endpoint da API                                                                                                  |
    | **Timeout**                      | Timeout para requisições de API. Padrão é 300s. Aumente para modelos de raciocínio de longa execução.                     |
    | **Máximo de Tokens de Entrada**  | Máximo de tokens de entrada. Padrão é 3000. Ajuste com base nas capacidades do seu modelo.                                |
    | **Máximo de Tokens de Resposta** | Máximo de tokens de resposta. Padrão é 1000. Ajuste com base nas suas necessidades e limites do modelo.                   |
  </Step>

  <Step title="Crie o modelo">
    Clique em **Criar**. A EKB validará a conexão da API e a configuração do modelo. Se bem-sucedido, o modelo será salvo e estará disponível para uso em seus agentes.
  </Step>
</Steps>

## Usando Modelos Personalizados

### Selecionando um Modelo Personalizado

<Steps>
  <Step title="Abra a aba Geral">
    No editor do agente, vá para a aba **Geral** e encontre a seção **Modelo**.
  </Step>

  <Step title="Escolha seu modelo personalizado">
    O menu suspenso mostra tanto modelos predefinidos quanto personalizados. Os modelos personalizados são marcados ou mostrados em uma seção separada. Selecione seu modelo personalizado.
  </Step>
</Steps>

<Note>
  Os modelos personalizados são **específicos do projeto**. Eles estão disponíveis para todos os agentes no projeto, e cada projeto pode ter seu próprio conjunto de modelos personalizados.
</Note>

## Gerenciando Modelos Personalizados

<AccordionGroup>
  <Accordion title="Visualizando Modelos Personalizados">
    1. Vá para **Agentes** → **Editar Agente** → aba **Geral**.
    2. Clique na aba **Personalizado** na seção de Modelos de IA.
    3. Veja todos os seus modelos personalizados listados.
  </Accordion>

  <Accordion title="Editando Modelos Personalizados">
    1. Encontre o modelo na lista de modelos personalizados.
    2. Clique no ícone **Editar** (menu de três pontos).
    3. Modifique as configurações.
    4. Clique em **Salvar** para atualizar.

    <Warning>
      Editar a chave de API substituirá a chave existente. Certifique-se de ter a chave correta antes de salvar.
    </Warning>
  </Accordion>

  <Accordion title="Excluindo Modelos Personalizados">
    1. Encontre o modelo na lista de modelos personalizados.
    2. Clique no ícone **Excluir** (menu de três pontos).
    3. Confirme a exclusão.
    4. O modelo é removido do seu projeto.

    <Warning>
      Excluir um modelo personalizado afetará todos os agentes que usam esse modelo. Certifique-se de atualizar esses agentes primeiro.
    </Warning>
  </Accordion>
</AccordionGroup>

## Exemplos de Configuração de Modelo

<CodeGroup>
  ```json OpenAI Custom Model theme={null}
  {
    "model_name": "My GPT-4",
    "version": "gpt-4",
    "api_provider": "openai",
    "api_type": "openai",
    "api_key": "sk-...",
    "api_url": "https://api.openai.com/v1",
    "max_input_tokens": 60000,
    "max_response_tokens": 4096
  }
  ```

  ```json Azure OpenAI theme={null}
  {
    "model_name": "Azure GPT-4",
    "version": "gpt-4",
    "api_provider": "openai",
    "api_type": "azure",
    "api_key": "your-azure-key",
    "api_url": "https://your-resource.openai.azure.com",
    "api_version": "2024-12-01-preview",
    "max_input_tokens": 60000,
    "max_response_tokens": 4096
  }
  ```

  ```json Anthropic Claude theme={null}
  {
    "model_name": "Company Claude",
    "version": "claude-sonnet-4-6",
    "api_provider": "anthropic",
    "api_type": "anthropic",
    "api_key": "sk-ant-...",
    "api_url": "https://api.anthropic.com",
    "max_input_tokens": 60000,
    "max_response_tokens": 4000
  }
  ```

  ```json Custom Endpoint theme={null}
  {
    "model_name": "Private Model",
    "version": "custom-model-v1",
    "api_provider": "custom",
    "api_type": "custom",
    "api_key": "your-custom-key",
    "api_url": "https://your-custom-endpoint.com/v1",
    "max_input_tokens": 100000,
    "max_response_tokens": 8000,
    "auth_header_template": "{\"Authorization\": \"Bearer <API_KEY>\"}"
  }
  ```
</CodeGroup>

## Melhores Práticas

<AccordionGroup>
  <Accordion title="Segurança de Chaves de API">
    * **Nunca Compartilhe Chaves** - Mantenha as chaves de API confidenciais
    * **Use Variáveis de Ambiente** - Para desenvolvimento, use armazenamento seguro
    * **Rotacione Chaves Regularmente** - Atualize chaves periodicamente
    * **Monitore o Uso** - Rastreie o uso da API para detectar problemas
  </Accordion>

  <Accordion title="Seleção de Modelo">
    * **Adéque ao Caso de Uso** - Escolha modelos apropriados para sua tarefa
    * **Considere o Custo** - Equilibre desempenho e custo
    * **Teste o Desempenho** - Avalie a qualidade do modelo para suas necessidades
    * **Monitore os Limites** - Observe limites de tokens e cotas
  </Accordion>

  <Accordion title="Configuração">
    * **Nomes de Modelo Precisos** - Use identificadores de modelo exatos
    * **URLs Corretas** - Verifique as URLs dos endpoints de API
    * **Limites Apropriados** - Defina limites de tokens realistas
    * **Teste as Conexões** - Verifique a conectividade do modelo
  </Accordion>

  <Accordion title="Gestão de Custos">
    * **Rastreie o Uso** - Monitore uso e custos da API
    * **Defina Orçamentos** - Configure limites de gastos se disponíveis
    * **Otimize Tokens** - Use limites de tokens apropriados
    * **Revise Regularmente** - Audite o uso de modelos periodicamente
  </Accordion>
</AccordionGroup>

## Solução de Problemas

<AccordionGroup>
  <Accordion title="Modelo Indisponível — Modelo personalizado não aparece no menu suspenso">
    **Causas possíveis:**

    * Modelo não salvo corretamente
    * Chave de API inválida
    * Erro de configuração do modelo

    **Soluções:**

    * Verifique se o modelo foi salvo com sucesso
    * Verifique se a chave de API está correta
    * Revise a configuração do modelo
    * Atualize a página
  </Accordion>

  <Accordion title="Erros de Chave de API — Chave de API inválida ou erros de autenticação">
    **Causas possíveis:**

    * Chave de API incorreta
    * Chave de API expirada
    * Provedor de API errado selecionado
    * A chave não tem as permissões necessárias

    **Soluções:**

    * Verifique se a chave de API está correta
    * Verifique se a chave não expirou
    * Confirme se o provedor correto foi selecionado
    * Garanta que a chave tenha as permissões necessárias
  </Accordion>

  <Accordion title="Falhas de Conexão — Não é possível conectar ao endpoint do modelo">
    **Causas possíveis:**

    * URL de API incorreta
    * Problemas de conectividade de rede
    * Endpoint inacessível
    * Firewall bloqueando a conexão

    **Soluções:**

    * Verifique se a URL da API está correta
    * Verifique a conectividade de rede
    * Garanta que o endpoint está acessível
    * Revise as regras de firewall
  </Accordion>

  <Accordion title="Erros de Limite de Tokens — Limite de tokens excedido">
    **Causas possíveis:**

    * Entrada longa demais
    * Limite de resposta alto demais
    * Limites do modelo excedidos

    **Soluções:**

    * Reduza o comprimento da entrada
    * Reduza o máximo de tokens de resposta
    * Verifique os limites reais do modelo
    * Divida entradas grandes
  </Accordion>
</AccordionGroup>

## Compatibilidade de Modelos

<Warning>
  Ao usar a Base de Conhecimento v2, apenas modelos **OpenAI** (openai, azure) e **Anthropic** são suportados. Outros provedores não são compatíveis com a Base de Conhecimento v2.
</Warning>

Diferentes modelos suportam diferentes funcionalidades:

| Funcionalidade       | Modelos Suportados                        |
| -------------------- | ----------------------------------------- |
| **Streaming**        | A maioria dos modelos                     |
| **Function Calling** | Modelos OpenAI e Anthropic                |
| **Visão**            | GPT-4o, Claude 4 Sonnet, Gemini 2.5 Flash |
| **Contexto Longo**   | Claude Sonnet 4.6, GPT 4.1                |

## Gerenciamento de Chaves de API

### Obtendo Chaves de API

<AccordionGroup>
  <Accordion title="OpenAI">
    1. Vá para [OpenAI Platform](https://platform.openai.com).
    2. Navegue até **API Keys**.
    3. Crie uma nova chave secreta.
    4. Copie a chave (começa com `sk-`).
  </Accordion>

  <Accordion title="Anthropic">
    1. Vá para [Anthropic Console](https://console.anthropic.com).
    2. Navegue até **API Keys**.
    3. Crie uma nova chave.
    4. Copie a chave (começa com `sk-ant-`).
  </Accordion>

  <Accordion title="Google AI">
    1. Vá para [Google AI Studio](https://makersuite.google.com/app/apikey).
    2. Crie uma nova chave de API.
    3. Copie a chave.
  </Accordion>

  <Accordion title="OpenRouter">
    1. Vá para [OpenRouter](https://openrouter.ai).
    2. Navegue até **Keys**.
    3. Crie uma nova chave.
    4. Copie a chave.
  </Accordion>
</AccordionGroup>

### Segurança de Chaves

* **Armazene com Segurança** - As chaves são criptografadas no banco de dados
* **Não Compartilhe** - Nunca compartilhe chaves de API
* **Rotacione Regularmente** - Atualize chaves periodicamente
* **Monitore o Uso** - Observe uso não autorizado

## Considerações de Custos

<CardGroup cols={2}>
  <Card title="Modelos Predefinidos" icon="sparkles">
    * Custos gerenciados pela EKB
    * Faturados através da sua assinatura EKB
    * Precificação baseada em créditos
    * Modelo de preços transparente
  </Card>

  <Card title="Modelos Personalizados (BYOK)" icon="key">
    * Você paga diretamente ao provedor
    * Sem taxas adicionais da EKB
    * Controle total sobre custos
    * Faturamento direto do provedor
  </Card>
</CardGroup>

**Dicas de otimização de custos:**

* **Escolha o modelo certo** - Use o modelo apropriado para sua tarefa.
* **Otimize prompts** - Reduza o uso de tokens quando possível.
* **Defina limites** - Configure o máximo de tokens adequadamente.
* **Monitore o uso** - Rastreie o uso da API regularmente.