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

# Autenticação

> Como autenticar uma requisição à API do SuperAgentes

Para acessar conteúdos privados, como **agentes** e **conhecimentos**, você precisa se autenticar na API do Super Agenteses. Para isso você deve passar sua **API Key** através do header **Authorization** da sua requisição:

```bash theme={null}
'Authorization': 'Bearer <API_KEY>'
```

## O que são Chaves do Super Agentes

As chaves do Super Agentes são credenciais de autenticação que permitem que aplicações externas se comuniquem com a API do Super Agenteses. Estas chaves são essenciais para:

* Integrar o Super Agenteses com outras ferramentas e plataformas
* Desenvolver aplicações personalizadas que utilizam os recursos do Super Agenteses
* Automatizar processos usando a API do Super Agenteses

## Obtendo sua API Key

Você pode obter sua API Key seguindo estes passos:

1. Faça login na sua conta do Super Agenteses
2. Clique no seletor de organização na barra lateral
3. Selecione **Gerenciar Espaços** no ícone da organização
4. Clique no workspace onde deseja gerenciar as chaves
5. Na página do workspace, clique na aba **Chaves do Super Agentes**

## Gerenciando suas Chaves de API

### Criando uma Nova Chave

Para criar uma nova chave do Super Agentes:

1. Na tela de gerenciamento de chaves, clique no botão **Criar Nova Chave**
2. A nova chave será gerada automaticamente e aparecerá na lista de chaves disponíveis
3. Clique na chave ou no ícone de cópia para copiá-la para a área de transferência

<Tip>
  Copie e armazene sua chave em um local seguro imediatamente após a criação. Embora você possa visualizar a chave completa a qualquer momento na interface, é uma boa prática de segurança manter um backup.
</Tip>

### Copiando uma Chave Existente

Para copiar uma chave existente:

1. Localize a chave na lista
2. Clique na chave ou no ícone de prancheta ao lado dela
3. A chave será copiada para a área de transferência e uma mensagem de confirmação aparecerá

### Excluindo uma Chave

Para remover uma chave que não é mais necessária:

1. Localize a chave na lista
2. Clique no ícone de lixeira ao lado da chave
3. Confirme a exclusão na caixa de diálogo que aparece

<Warning>
  Você deve manter pelo menos uma chave de API ativa em seu workspace. O sistema não permitirá que você exclua a última chave restante.
</Warning>

## Usando a API Key em suas Requisições

Para usar sua API Key em integrações:

<CodeGroup>
  ```javascript JavaScript theme={null}
  const apiKey = 'sua_api_key_aqui';

  fetch('https://dash.superagentes.ai/api/agents', {
    method: 'GET',
    headers: {
      'Authorization': `Bearer ${apiKey}`,
      'Content-Type': 'application/json'
    }
  })
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Erro:', error));
  ```

  ```python Python theme={null}
  import requests

  api_key = 'sua_api_key_aqui'
  headers = {
      'Authorization': f'Bearer {api_key}',
      'Content-Type': 'application/json'
  }

  response = requests.get('https://dash.superagentes.ai/api/agents', headers=headers)
  print(response.json())
  ```

  ```curl cURL theme={null}
  curl -X GET \
    -H "Authorization: Bearer sua_api_key_aqui" \
    -H "Content-Type: application/json" \
    https://dash.superagentes.ai/api/agents
  ```
</CodeGroup>

## Práticas Recomendadas de Segurança

### Segurança

* **Não compartilhe suas chaves**: Trate as chaves do Super Agentes como senhas
* **Use diferentes chaves**: Crie chaves separadas para diferentes integrações ou ambientes
* **Rotação regular**: Atualize suas chaves periodicamente criando novas e excluindo as antigas
* **Monitoramento**: Verifique regularmente o uso das suas chaves para detectar atividades suspeitas

### Gerenciamento

* **Limite de chaves**: Embora não haja um limite técnico para o número de chaves, mantenha apenas as necessárias
* **Documentação**: Mantenha um registro de onde cada chave está sendo utilizada
* **Teste antes de excluir**: Antes de excluir uma chave, certifique-se de que ela não está sendo usada em nenhuma integração ativa

## Solução de Problemas

<AccordionGroup>
  <Accordion title="Erro 401 Unauthorized">
    Este erro indica que sua API Key é inválida ou não foi fornecida corretamente.

    **Soluções:**

    * Verifique se a chave está sendo enviada no formato correto: `Bearer sua_api_key_aqui`
    * Confirme se a chave não foi excluída ou revogada
    * Crie uma nova chave e tente novamente
  </Accordion>

  <Accordion title="Erro 403 Forbidden">
    Este erro indica que sua API Key é válida, mas não tem permissões para acessar o recurso solicitado.

    **Soluções:**

    * Verifique se você tem as permissões necessárias no workspace
    * Confirme se o recurso que está tentando acessar existe e está disponível para sua conta
  </Accordion>

  <Accordion title="Problemas ao criar ou excluir chaves">
    **Possíveis causas e soluções:**

    * **Permissões**: Verifique se você tem permissões de administrador no workspace
    * **Última chave**: Você não pode excluir a última chave restante no workspace
    * **Conexão**: Certifique-se de que sua conexão com a internet está estável
    * **Recarregue a página**: Às vezes, recarregar a página pode resolver problemas temporários
  </Accordion>
</AccordionGroup>

## Perguntas Frequentes

<AccordionGroup>
  <Accordion title="Quantas chaves de API posso criar?">
    Não há limite técnico para o número de chaves que você pode criar, mas é recomendável manter apenas as necessárias para suas integrações.
  </Accordion>

  <Accordion title="Posso recuperar uma chave excluída?">
    Não, uma vez excluída, a chave não pode ser recuperada. Você precisará criar uma nova chave e atualizar suas integrações.
  </Accordion>

  <Accordion title="As chaves expiram automaticamente?">
    Não, as chaves do Super Agentes não expiram automaticamente. Elas permanecerão válidas até serem excluídas manualmente.
  </Accordion>

  <Accordion title="As chaves são compartilhadas com outros membros do workspace?">
    Sim, todos os membros com acesso ao workspace podem ver e gerenciar as chaves do Super Agentes.
  </Accordion>

  <Accordion title="Posso restringir o que uma chave pode acessar?">
    Atualmente, todas as chaves do Super Agentes têm o mesmo nível de acesso. Não é possível definir permissões específicas para chaves individuais.
  </Accordion>
</AccordionGroup>

## Próximos Passos

Após configurar sua autenticação, você pode começar a usar a API do Super Agenteses:

<CardGroup cols={2}>
  <Card title="Referência de Agentes" icon="robot" href="/api-reference/agents/schema">
    Aprenda a gerenciar seus agentes via API
  </Card>

  <Card title="Referência de Conhecimentos" icon="book-blank" href="/api-reference/datastores/schema">
    Gerencie seus bancos de conhecimento via API
  </Card>

  <Card title="Referência de Conversas" icon="comments" href="/api-reference/conversations/conversations">
    Acesse e gerencie conversas via API
  </Card>

  <Card title="Gerenciar Chaves de LLM" icon="key" href="/api-keys/management">
    Configure chaves para modelos de linguagem
  </Card>
</CardGroup>