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

# 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](/agent) a modelos de linguagem como GPT-4o, Claude e outros. Com o lançamento do [White Label](/introduction#configurando-white-label-plano-executivo), 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**

<Note>
  Se você acabou de criar sua conta, consulte nosso [guia de configuração inicial](/introduction#configurando-chaves-de-api-de-llm) para instruções detalhadas sobre como configurar sua primeira chave de API.
</Note>

## 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**

<CardGroup cols={3}>
  <Card title="OpenAI" icon="message-bot" href="https://platform.openai.com/api-keys" target="_blank">
    GPT-4o e GPT-4o-mini
  </Card>

  <Card title="Anthropic" icon="sparkles" href="https://console.anthropic.com/keys" target="_blank">
    Claude 3 Sonnet e Haiku
  </Card>

  <Card title="Groq" icon="bolt" href="https://console.groq.com/keys" target="_blank">
    Recomendado para transcrição de áudio
  </Card>
</CardGroup>

## 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

<Warning>
  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.
</Warning>

## Casos de uso comuns

### Múltiplos projetos ou clientes

Configure um workspace separado para cada projeto ou cliente no [plano White Label](/introduction#configurando-white-label-plano-executivo), 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

<Tip>
  Para verificar se uma chave está funcionando corretamente, você pode criar um [agente de teste](/agent) simples e enviar algumas mensagens para ele.
</Tip>

## 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](https://platform.openai.com/api-keys)
* Anthropic: [console.anthropic.com/settings/keys](https://console.anthropic.com/settings/keys)
* Groq: [console.groq.com/keys](https://console.groq.com/keys)
* OpenRouter: [openrouter.ai/settings/keys](https://openrouter.ai/settings/keys)
* DeepSeek: [platform.deepseek.com/settings/api-keys](https://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](/team/management#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](/agent)**: Cada agente usa uma chave específica para gerar respostas
* **[Transcrição de áudio](/introduction#configurando-chave-groq-para-transcrição-de-áudio)**: Necessária para processar mensagens de voz no WhatsApp
* **[Estágios de Conversação](/agent/stages/stages)**: Podem usar diferentes modelos em diferentes estágios
* **[Gerenciamento de Equipe](/team/management)**: Controle quem pode acessar e gerenciar chaves
* **[API do Super Agentes](/api-reference/authentication)**: 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

<Note>
  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](/api-reference/authentication).
</Note>

## Próximos Passos

Após configurar suas chaves de API, você pode:

<CardGroup cols={2}>
  <Card title="Criar seu Primeiro Agente" icon="robot" href="/agent">
    Crie um agente personalizado usando as chaves configuradas
  </Card>

  <Card title="Configurar Banco de Conhecimento" icon="book-blank" href="/datastore">
    Adicione conhecimento personalizado aos seus agentes
  </Card>

  <Card title="Gerenciar Equipe" icon="users" href="/team/management">
    Configure permissões para sua equipe acessar recursos
  </Card>

  <Card title="Integrar ao WhatsApp" icon="whatsapp" href="/agent/integration/whatsapp">
    Conecte seu agente ao WhatsApp para interagir com clientes
  </Card>

  <Card title="Usar a API do Super Agentes" icon="code" href="/api-reference/authentication">
    Aprenda a autenticar e usar a API do Super Agentes para integrações
  </Card>
</CardGroup>