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

  1. Clique no seu seletor de organização na barra lateral
  2. Selecione Gerenciar Espaços
  3. Clique no workspace desejado
  4. 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

  1. Clique no botão Adicionar Chave
  2. Selecione o Provedor (OpenAI, Anthropic, Groq, etc.)
  3. Cole sua chave de API no campo de texto
  4. Adicione uma descrição (opcional)
  5. Para Azure, preencha também URL base e versão da API
  6. 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

  1. Segurança: Nunca compartilhe suas chaves em repositórios públicos ou mensagens
  2. Descrições claras: Use descrições que identifiquem o propósito da chave
  3. Verificação de uso: Monitore o uso das chaves nos painéis dos provedores
  4. Antes de excluir: Verifique quais agentes usam a chave para evitar interrupções

Solução de problemas

Se seu agente não responde, verifique:

  1. Se a chave expirou ou foi revogada
  2. Se você atingiu o limite de uso do seu plano
  3. 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:

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:

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: