Ir para o conteúdo principal

Gerenciando chaves de API

Na página Coderen, gerencie as chaves de API para funcionários e alunos. Uma chave de API dá acesso ao endpoint Coderen compatível com OpenAI da AI-School.

Os usuários usam essa chave em uma ferramenta de programação externa, como Aider ou OpenCode.

Funcionários e alunos​

A página Coderen possui abas separadas para:

  • Funcionários
  • Alunos

Para os alunos, os usuários são agrupados por turma. Para os funcionários, a AI-School mostra os funcionários dentro do alcance escolar permitido.

Um usuário precisa ter uma conta vinculada antes que uma chave possa ser criada.

Criar uma chave​

  1. Localize o funcionário ou o aluno.
  2. Clique no ícone de chave.
  3. Escolha o orçamento.
  4. Opcional: escolha renovação automática.
  5. Opcional: configure um período de validade.
  6. Clique em Salvar.

A chave de API será exibida apenas uma vez. Copie a chave diretamente e compartilhe-a com o usuário de forma segura.

Chave visível apenas uma vez

Após fechar a janela, a AI-School não poderá exibir novamente a chave completa da API. Se a chave for perdida, revogue a chave antiga e crie uma nova.

Configurar orçamento​

Cada chave possui um orçamento em dólares americanos. Isso corresponde à forma como os custos do modelo são calculados.

Você pode:

  • definir um orçamento por chave
  • ativar renovação automática após uso
  • revogar a chave quando ela não for mais necessária

Na lista, você vê, por usuário, quanto orçamento foi utilizado.

Configurar o período de validade​

Você pode restringir uma chave com uma data de início e uma data de término.

Isso é útil para aulas ou projetos temporários. Por exemplo:

  • início: hoje às 10:00
  • fim: hoje às 11:00

A chave funcionará apenas dentro desse intervalo de tempo. Fora do intervalo, a chave será recusada.

Criar chaves para um grupo​

Para alunos, você pode criar chaves de uma só vez para um grupo inteiro.

  1. Abra o grupo correto.
  2. Clique em Criar chaves.
  3. Escolha orçamento, renovação automática e, opcionalmente, período de validade.
  4. Confirme a criação das chaves.

Após a criação, um documento com as chaves criadas é aberto automaticamente. Baixe ou salve este documento imediatamente, pois as chaves completas não ficarão visíveis novamente.

Revogar chaves​

Revogar uma chave significa que o usuário não poderá mais utilizá-la.

Você pode:

  • revogar uma única chave de um usuário
  • revogar chaves coletivamente para um grupo

A AI-School solicita confirmação antes de revogar as chaves.

Relatórios e auditoria​

O uso via Coderen é registrado. Assim, os administradores podem ver:

  • quem está usando a chave
  • quantas solicitações foram feitas
  • quais custos foram gerados
  • quais chats ocorreram através da chave

Esses dados ajudam a manter as aulas de programação e projetos gerenciáveis.