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:

'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

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.

​
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

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.

​
Usando a API Key em suas Requisições

Para usar sua API Key em integrações:

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));

​
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

​
Perguntas Frequentes

​
Próximos Passos

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

Referência de Agentes

Aprenda a gerenciar seus agentes via API

Referência de Conhecimentos

Gerencie seus bancos de conhecimento via API

Referência de Conversas

Acesse e gerencie conversas via API

Gerenciar Chaves de LLM

Configure chaves para modelos de linguagem