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

1. Navegue até Agentes

   Vá para Agentes na barra lateral.

2. Abra um agente

   Crie um novo agente ou selecione um existente.

3. Vá para a aba Geral

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

4. 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

1. Navegue até Agentes

   Vá para Agentes na barra lateral.

2. Abra um agente

   Crie um novo agente ou selecione um existente para editar.

3. Vá para a aba Configurações

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

4. Abra Modelos Personalizados

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

5. 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.

6. 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

1. Abra a aba Geral

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

2. 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.

Nota

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

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.

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.

aviso

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

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.

aviso

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

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

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

aviso

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

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

Anthropic

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

Google AI

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

OpenRouter

1. Vá para OpenRouter.
2. Navegue até Keys.
3. Crie uma nova chave.
4. 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.