Gerenciando Chaves de API de LLM
Como configurar e gerenciar chaves de API para modelos de linguagem no Super Agentes
O que são chaves de API de LLM
As chaves de API de LLM (Large Language Models) são credenciais necessárias para conectar seus agentes a modelos de linguagem como GPT-4o, Claude e outros. Com o lançamento do White Label, as chaves são configuradas por workspace.
Como acessar as configurações de chaves
- Clique no seu seletor de organização na barra lateral
- Selecione Gerenciar Espaços
- Clique no workspace desejado
- Acesse a aba Chaves de API de LLMs
Se você acabou de criar sua conta, consulte nosso guia de configuração inicial para instruções detalhadas sobre como configurar sua primeira chave de API.
Adicionando uma nova chave
- Clique no botão Adicionar Chave
- Selecione o Provedor (OpenAI, Anthropic, Groq, etc.)
- Cole sua chave de API no campo de texto
- Adicione uma descrição (opcional)
- Para Azure, preencha também URL base e versão da API
- Clique em Salvar
Gerenciando chaves existentes
Na tabela de chaves, você pode:
- Ver o provedor associado
- Ver uma versão mascarada da chave
- Ver a descrição e data de criação
- Editar ou excluir a chave
Antes de excluir uma chave, verifique quais agentes a estão utilizando. A exclusão de uma chave em uso pode fazer com que seus agentes parem de funcionar.
Casos de uso comuns
Múltiplos projetos ou clientes
Configure um workspace separado para cada projeto ou cliente no plano White Label, cada um com suas próprias chaves.
Diferentes departamentos
Configure workspaces separados para departamentos como Atendimento, Vendas e Marketing, cada um com chaves específicas.
Ambientes de desenvolvimento
Use workspaces separados para ambientes de teste e produção, com diferentes chaves para cada um.
Dicas práticas
- Segurança: Nunca compartilhe suas chaves em repositórios públicos ou mensagens
- Descrições claras: Use descrições que identifiquem o propósito da chave
- Verificação de uso: Monitore o uso das chaves nos painéis dos provedores
- Antes de excluir: Verifique quais agentes usam a chave para evitar interrupções
Solução de problemas
Se seu agente não responde, verifique:
- Se a chave expirou ou foi revogada
- Se você atingiu o limite de uso do seu plano
- Se o modelo selecionado no agente corresponde ao provedor da chave
Para verificar se uma chave está funcionando corretamente, você pode criar um agente de teste simples e enviar algumas mensagens para ele.
Perguntas frequentes
P: Posso usar a mesma chave em diferentes workspaces?
R: Sim, cada workspace mantém sua própria cópia da chave.
P: Como escolher o provedor certo?
R: Depende do caso de uso:
- OpenAI (GPT-4o): Bom para tarefas gerais e criativas
- Anthropic (Claude): Bom para raciocínio e respostas detalhadas
- Groq: Oferece respostas muito rápidas
- Azure OpenAI: Para empresas com requisitos de conformidade
P: Como obter chaves dos provedores?
R: Links diretos estão disponíveis na interface de adição de chaves:
- OpenAI: platform.openai.com/api-keys
- Anthropic: console.anthropic.com/settings/keys
- Groq: console.groq.com/keys
- OpenRouter: openrouter.ai/settings/keys
- DeepSeek: platform.deepseek.com/settings/api-keys
P: Quais permissões são necessárias para gerenciar chaves?
R: Apenas usuários com papel de Admin podem adicionar, editar ou excluir chaves de API.
Integrações com outros recursos
O gerenciamento de chaves de API se integra com vários outros recursos da plataforma:
- Agentes: Cada agente usa uma chave específica para gerar respostas
- Transcrição de áudio: Necessária para processar mensagens de voz no WhatsApp
- Estágios de Conversação: Podem usar diferentes modelos em diferentes estágios
- Gerenciamento de Equipe: Controle quem pode acessar e gerenciar chaves
- API do Super Agentes: As chaves de API para acessar a API do Super Agentes são diferentes das chaves de LLM e são gerenciadas em outra seção
Não confunda as chaves de API de LLM (descritas nesta página) com as chaves de API do Super Agentes, que são usadas para autenticar requisições à API da plataforma. Para informações sobre as chaves de API do Super Agentes, consulte a documentação de autenticação da API.
Próximos Passos
Após configurar suas chaves de API, você pode:
Criar seu Primeiro Agente
Crie um agente personalizado usando as chaves configuradas
Configurar Banco de Conhecimento
Adicione conhecimento personalizado aos seus agentes
Gerenciar Equipe
Configure permissões para sua equipe acessar recursos
Integrar ao WhatsApp
Conecte seu agente ao WhatsApp para interagir com clientes
Usar a API do Super Agentes
Aprenda a autenticar e usar a API do Super Agentes para integrações