Modelos Predefinidos e Personalizados

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:

Modelos Predefinidos

Modelos pré-configurados disponíveis para todos os usuários — nenhuma chave de API necessária.

Modelos Personalizados (BYOK)

Modelos que você configura com suas próprias chaves de API para controle total de custos e flexibilidade.

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

Navegue até Agentes

Vá para Agentes na barra lateral.

Abra um agente

Crie um novo agente ou selecione um existente.

Vá para a aba Geral

Abra a aba Geral na configuração do agente.

Selecione um modelo

Encontre o seletor suspenso Modelo ao lado do nome do agente e selecione um modelo predefinido no menu suspenso.

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

Controle de Custos

Use suas próprias chaves de API e faturamento.

Flexibilidade de Modelos

Acesse modelos não disponíveis na lista predefinida.

Endpoints Personalizados

Conecte-se a endpoints de modelo privados ou personalizados.

Escolha do Provedor

Use qualquer provedor de API compatível.

Provedores Suportados

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`

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`

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`

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

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

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

Adicionando Modelos Personalizados

Navegue até Agentes

Vá para Agentes na barra lateral.

Abra um agente

Crie um novo agente ou selecione um existente para editar.

Vá para a aba Configurações

Abra a aba Configurações na configuração do agente.

Abra Modelos Personalizados

Role até a seção Modelos Personalizados e clique em +Adicionar Modelo.

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.

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.

Usando Modelos Personalizados

Selecionando um Modelo Personalizado

Abra a aba Geral

No editor do agente, vá para a aba Geral e encontre a seção Modelo.

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.

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.

Gerenciando Modelos Personalizados

Visualizando Modelos Personalizados

Vá para Agentes → Editar Agente → aba Geral.
Clique na aba Personalizado na seção de Modelos de IA.
Veja todos os seus modelos personalizados listados.

Editando Modelos Personalizados

Encontre o modelo na lista de modelos personalizados.
Clique no ícone Editar (menu de três pontos).
Modifique as configurações.
Clique em Salvar para atualizar.

Editar a chave de API substituirá a chave existente. Certifique-se de ter a chave correta antes de salvar.

Excluindo Modelos Personalizados

Encontre o modelo na lista de modelos personalizados.
Clique no ícone Excluir (menu de três pontos).
Confirme a exclusão.
O modelo é removido do seu projeto.

Excluir um modelo personalizado afetará todos os agentes que usam esse modelo. Certifique-se de atualizar esses agentes primeiro.

Exemplos de Configuração de Modelo

{
  "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
}

{
  "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
}

{
  "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
}

{
  "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>\"}"
}

Melhores Práticas

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

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

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

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

Solução de Problemas

Modelo Indisponível — Modelo personalizado não aparece no menu suspenso

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

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

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

Compatibilidade de Modelos

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.

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

OpenAI

Vá para OpenAI Platform.
Navegue até API Keys.
Crie uma nova chave secreta.
Copie a chave (começa com sk-).

Anthropic

Vá para Anthropic Console.
Navegue até API Keys.
Crie uma nova chave.
Copie a chave (começa com sk-ant-).

Google AI

Vá para Google AI Studio.
Crie uma nova chave de API.
Copie a chave.

OpenRouter

Vá para OpenRouter.
Navegue até Keys.
Crie uma nova chave.
Copie a chave.

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

Modelos Predefinidos

Custos gerenciados pela EKB
Faturados através da sua assinatura EKB
Precificação baseada em créditos
Modelo de preços transparente

Modelos Personalizados (BYOK)

Você paga diretamente ao provedor
Sem taxas adicionais da EKB
Controle total sobre custos
Faturamento direto do provedor

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.

Get Started!

Offerings

Chat

Agents

Knowledge Base

Workflows

Public Chatbot

Project Settings

My Account

Platform Admin

SDK

General Information

Modelos Predefinidos

Modelos Personalizados (BYOK)

Modelos Predefinidos

Modelos Disponíveis por Provedor

Seleção de Modelo

Informações do Modelo

Modelos Personalizados (BYOK)

Controle de Custos

Flexibilidade de Modelos

Endpoints Personalizados

Escolha do Provedor

Provedores Suportados

Adicionando Modelos Personalizados

Usando Modelos Personalizados

Selecionando um Modelo Personalizado

Gerenciando Modelos Personalizados

Exemplos de Configuração de Modelo

Melhores Práticas

Solução de Problemas

Compatibilidade de Modelos

Gerenciamento de Chaves de API

Obtendo Chaves de API

Segurança de Chaves

Considerações de Custos

Modelos Predefinidos

Modelos Personalizados (BYOK)

Modelos Predefinidos

Modelos Personalizados (BYOK)

​Modelos Predefinidos

​Modelos Disponíveis por Provedor

​Seleção de Modelo

​Informações do Modelo

​Modelos Personalizados (BYOK)

Controle de Custos

Flexibilidade de Modelos

Endpoints Personalizados

Escolha do Provedor

​Provedores Suportados

​Adicionando Modelos Personalizados

​Usando Modelos Personalizados

​Selecionando um Modelo Personalizado

​Gerenciando Modelos Personalizados

​Exemplos de Configuração de Modelo

​Melhores Práticas

​Solução de Problemas

​Compatibilidade de Modelos

​Gerenciamento de Chaves de API

​Obtendo Chaves de API

​Segurança de Chaves

​Considerações de Custos

Modelos Predefinidos

Modelos Personalizados (BYOK)

Modelos Predefinidos

Modelos Disponíveis por Provedor

Seleção de Modelo

Informações do Modelo

Modelos Personalizados (BYOK)

Provedores Suportados

Adicionando Modelos Personalizados

Usando Modelos Personalizados

Selecionando um Modelo Personalizado

Gerenciando Modelos Personalizados

Exemplos de Configuração de Modelo

Melhores Práticas

Solução de Problemas

Compatibilidade de Modelos

Gerenciamento de Chaves de API

Obtendo Chaves de API

Segurança de Chaves

Considerações de Custos