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:
Faça login na sua conta do Super Agenteses
Clique no seletor de organização na barra lateral
Selecione Gerenciar Espaços no ícone da organização
Clique no workspace onde deseja gerenciar as chaves
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:
Na tela de gerenciamento de chaves, clique no botão Criar Nova Chave
A nova chave será gerada automaticamente e aparecerá na lista de chaves disponíveis
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:
Localize a chave na lista
Clique na chave ou no ícone de prancheta ao lado dela
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:
Localize a chave na lista
Clique no ícone de lixeira ao lado da chave
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
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
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
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
Perguntas Frequentes
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.
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.
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.
As chaves são compartilhadas com outros membros do workspace?
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.
Próximos Passos
Após configurar sua autenticação, você pode começar a usar a API do Super Agenteses: