Gestione delle chiavi API
Nella pagina Coderen gestisci le chiavi API per dipendenti e studenti. Una chiave API dà accesso all'endpoint Coderen compatibile OpenAI di AI-School.
Gli utenti usano questa chiave in uno strumento di programmazione esterno, come Aider o OpenCode.
Dipendenti e studenti
La pagina Coderen ha schede separate per:
- Dipendenti
- Studenti
Per gli studenti gli utenti sono raggruppati per gruppo. Per i dipendenti AI-School mostra i dipendenti all'interno dello scope scolastico consentito.
Un utente deve avere un account associato prima che una chiave possa essere creata.
Creare una chiave
- Trova il dipendente o lo studente.
- Clicca sull'icona chiave.
- Scegli il budget.
- Scegli eventualmente il rinnovo automatico.
- Imposta eventualmente un periodo di validità.
- Clicca su Salva.
La chiave API viene mostrata una sola volta. Copia immediatamente la chiave e consegnala in modo sicuro all'utente.
Dopo la chiusura della finestra AI-School non può mostrare nuovamente l'intera chiave API. Se la chiave va persa, rigira la vecchia chiave e crea una nuova.
Impostare il budget
Ogni chiave ha un budget in dollari USA. Questo è allineato al modo in cui vengono calcolati i costi dei modelli.
Puoi:
- impostare un budget per chiave
- attivare il rinnovo automatico al consumo
- revocare la chiave quando non è più necessaria
Nell'elenco vedi per ciascun utente quanto budget è stato consumato.
Impostare il periodo di validità
Puoi limitare una chiave con una data di inizio e una data di fine.
Questo è utile per lezioni o progetti temporanei. Ad esempio:
- inizio: oggi alle 10:00
- fine: oggi alle 11:00
La chiave funzionerà solo all'interno di questa finestra temporale. Fuori dalla finestra, la chiave verrà rifiutata.
Creare chiavi per un gruppo
Per gli studenti puoi creare chiavi in una sola volta per un intero gruppo.
- Apri il gruppo corretto.
- Clicca su Crea chiavi.
- Scegli budget, rinnovo automatico e eventualmente una data di validità.
- Conferma la creazione delle chiavi.
Dopo la creazione si apre automaticamente un documento con le chiavi create. Scarica o conserva questo documento immediatamente, perché le chiavi complete non saranno più visibili in seguito.
Revocare le chiavi
Revocare una chiave significa che l'utente non potrà più usarla.
Puoi:
- revocare una singola chiave per un utente
- revocare collettivamente le chiavi per un gruppo
AI-School richiede prima la conferma prima che le chiavi vengano revocate.
Rapporti e controllo
L'uso tramite Coderen viene registrato. In questo modo gli amministratori possono vedere:
- chi usa la chiave
- quante richieste sono state fatte
- quali costi sono stati sostenuti
- quali chat sono nate tramite la chiave
Questi dati aiutano a mantenere gestibili lezioni e progetti di programmazione.