Panoramica
I progetti organizzano il lavoro all'interno di un'organizzazione API. Usali per gestire l'accesso, configurare i limiti dei modelli e i limiti di richieste, creare account di servizio e monitorare utilizzo, fatturazione e limiti di spesa per un insieme definito di risorse, come modelli, funzionalità, thread, assistenti, fine-tuning e spazio di archiviazione.
I proprietari dell'organizzazione possono visualizzare tutti i progetti attivi e archiviati nella pagina Progetti.
Prima di iniziare
Per creare un progetto devi avere il ruolo di proprietario dell'organizzazione. Per impostazione predefinita, le organizzazioni possono creare fino a 2.000 progetti.
Se la tua organizzazione utilizza la fatturazione consolidata, le sotto-organizzazioni compaiono separatamente nel selettore delle organizzazioni. Non puoi creare progetti all'interno di una sotto-organizzazione.
Per passare a un'altra organizzazione, apri il selettore delle organizzazioni e seleziona quella che vuoi usare.
Progetto predefinito
Ogni organizzazione include un progetto predefinito, che non può essere eliminato. Il progetto eredita l'intera configurazione dell'organizzazione. Puoi configurarne i limiti di richieste, le autorizzazioni per i modelli virtuali e i limiti di spesa.
Non puoi aggiungere membri o account di servizio direttamente al progetto predefinito. Puoi includere l'accesso al progetto predefinito quando inviti qualcuno nell'organizzazione, seguendo la procedura di invito descritta in questo articolo.
Creare un progetto
Apri il selettore dei progetti e seleziona Crea progetto.
Inserisci un nome, una descrizione e un sito web per il tuo progetto.
Seleziona Crea.
I proprietari dell'organizzazione vengono aggiunti automaticamente come proprietari ai nuovi progetti.
Comprendere ruoli e accessi
La tabella riassume i ruoli di proprietario e lettore dell'organizzazione e i ruoli di proprietario e membro del progetto citati in queste procedure. I membri del progetto hanno autorizzazioni simili a quelle dei lettori dell'organizzazione.
| Ruolo | Ambito | Autorizzazioni |
|---|---|---|
| Proprietario | Organizzazione | Creare e visualizzare tutti i progetti, gli utenti e le chiavi API. Monitorare i progetti nella pagina Progetti. Impostare i limiti di spesa dell'organizzazione e dei progetti. Concedere l'accesso alle informazioni di utilizzo degli altri utenti. Archiviare i progetti. |
| Lettore | Organizzazione | Essere aggiunto ai progetti, eseguire inferenze, usare risorse e creare chiavi in tali progetti. Non può creare progetti o gestire utenti. |
| Proprietario | Progetto | Tutte le autorizzazioni dei membri, oltre alla possibilità di aggiungere utenti, gestire membri e impostazioni del progetto, rinominarlo, impostarne i limiti di spesa e archiviarlo. |
| Membro | Progetto | Eseguire inferenze, usare risorse, creare chiavi a livello di progetto e inviare richieste API per leggere o modificare dati. |
Per i dettagli sui ruoli nell'organizzazione, consulta: ruoli dell'organizzazione. Per altri ruoli, ruoli personalizzati e l'elenco completo delle autorizzazioni, consulta la guida ai ruoli e alle autorizzazioni API.
Visibilità dei progetti
Con questi ruoli standard, gli utenti che non sono proprietari dell'organizzazione possono vedere solo i progetti di cui fanno parte. I proprietari dell'organizzazione possono vedere tutti i progetti, i membri e le chiavi API a livello di progetto e possono accedere alla pagina Progetti.
I membri del progetto possono vedere gli altri membri del proprio progetto e il ruolo di ciascuno. Solo i membri del progetto e i proprietari dell'organizzazione possono vedere i modelli sottoposti a fine-tuning, i thread degli assistenti e i file creati o aggiunti all'interno del progetto.
Puoi far parte di tutti i progetti di cui hai bisogno. Una chiave API personale creata all'interno di un progetto è limitata a quel progetto e alle sue risorse.
Limiti di accesso alle risorse
File, assistenti, spazio di archiviazione e thread sono limitati al progetto di appartenenza. I membri non amministratori che non appartengono al progetto non possono accedere alle sue risorse, e le risorse non possono essere spostate da un progetto all'altro.
Fanno eccezione i modelli sottoposti a fine-tuning nel progetto predefinito, ai quali è possibile accedere da altri progetti.
Gestire i membri del progetto
Invitare qualcuno nella tua organizzazione
Una persona deve far parte della tua organizzazione prima che tu possa aggiungerla a un progetto.
Quando inviti qualcuno nell'organizzazione, puoi includere l'accesso al progetto predefinito selezionando l'apposita opzione nel modulo di invito. Lascia l'opzione deselezionata se non vuoi concedere l'accesso al progetto predefinito. I nuovi membri dell'organizzazione non vengono aggiunti automaticamente al progetto predefinito.
Non è necessario creare un altro progetto prima di invitare qualcuno. Puoi anche aggiungere una persona a un progetto dopo che ha accettato l'invito nell'organizzazione.
Gli inviti inviati tramite l'API di amministrazione seguono le regole dell'endpoint /organization/invites.
Aggiungere un membro dell'organizzazione a un progetto
I proprietari dell'organizzazione e del progetto possono aggiungere membri:
Vai alle impostazioni dell'organizzazione.
Seleziona il progetto, quindi apri Membri.
Seleziona + Aggiungi membro.
Seleziona l'utente e assegna il ruolo di Membro o Proprietario.
L'elenco mostra gli utenti dell'organizzazione con il ruolo di Lettore. Non include gli account di servizio.
Se un invito non va a buon fine nell'interfaccia utente o nell'API di amministrazione, verifica che il progetto di destinazione esista e non sia archiviato prima di inviarlo di nuovo.
Modificare un ruolo o rimuovere un membro
I proprietari dell'organizzazione e del progetto possono modificare il ruolo di un utente nel progetto o rimuoverlo dal progetto.
Vai alle impostazioni dell'organizzazione.
Seleziona il progetto, quindi apri Membri.
Imposta il ruolo dell'utente su Membro o Proprietario, oppure seleziona Rimuovi per rimuoverlo.
Creare e gestire gli account di servizio
Un account di servizio consente l'accesso ai sistemi anziché rappresentare un singolo utente. Gli account di servizio sono limitati ai rispettivi progetti.
Per creare account di servizio sono necessarie le autorizzazioni per la gestione degli account di servizio. I proprietari dell'organizzazione e del progetto dispongono di queste autorizzazioni.
Creare un account di servizio
Scegli il progetto nel selettore dei progetti.
Vai alle impostazioni dell'organizzazione e seleziona il progetto.
Apri Membri e seleziona + Account di servizio.
Inserisci un ID univoco per l'account di servizio usando lettere, numeri e trattini.
Seleziona Crea.
Gli account di servizio creati a livello di progetto sono unici per il progetto e non possono essere utilizzati al di fuori del progetto in cui sono stati creati.
Il formato dell'ID è lo stesso, sia che crei l'account di servizio dalle impostazioni dell'organizzazione sia da quelle del progetto.
Un account di servizio creato per un progetto è specifico di quel progetto e non può essere usato al di fuori di esso.
Salvare la chiave segreta
Quando crei un account di servizio, viene subito creata una chiave API e ne viene mostrata la chiave segreta. Conserva la chiave segreta in modo sicuro. Non potrai visualizzarla di nuovo tramite il tuo account OpenAI. Se la perdi, genera una nuova chiave.
Per impostazione predefinita, la chiave dell'account di servizio ha accesso in lettura e scrittura a tutte le risorse API del progetto. Puoi modificare queste autorizzazioni in seguito nelle impostazioni Chiavi API del progetto.
Aggiornare o rimuovere un account di servizio
Gli account di servizio compaiono insieme agli utenti nelle impostazioni Membri del progetto. Gestisci il loro accesso al progetto seguendo gli stessi passaggi usati per modificare il ruolo o rimuovere gli altri membri del progetto.
Tutti gli account di servizio compaiono anche insieme agli utenti nella pagina Membri dell'organizzazione, inclusi quelli creati dalle impostazioni a livello di organizzazione e di progetto.
Dal menu Membri dell'organizzazione puoi modificare il ruolo di un account di servizio o selezionare Rimuovi.
Creare e gestire le chiavi API
Ogni progetto ha le proprie chiavi API:
Vai alle impostazioni dell'organizzazione.
Seleziona il progetto, quindi apri Chiavi API.
Seleziona + Crea nuova chiave segreta per creare una chiave, oppure seleziona l'icona di modifica accanto a una chiave esistente per modificarne le autorizzazioni.
Scegliere le autorizzazioni delle chiavi
Per le chiavi di proprietà degli utenti, puoi impostare le autorizzazioni durante la creazione della chiave o modificarle in seguito:
Tutte: autorizzazioni complete. Questa è l'impostazione predefinita.
Limitate: scegli gli ambiti di accesso per risorse o endpoint specifici. Le opzioni disponibili dipendono dalla risorsa e possono includere Nessuna, Lettura, Scrittura o autorizzazioni specifiche per la richiesta.
Sola lettura: autorizzazioni di lettura per tutti gli endpoint.
Ad esempio, una chiave con autorizzazioni limitate può escludere l'accesso in lettura e scrittura all'endpoint /v1/assistants.
Per creare chiavi per gli account di servizio sono necessarie le autorizzazioni per la gestione degli account di servizio. Se non vedi questa opzione, chiedi a un proprietario dell'organizzazione o del progetto di creare la chiave dell'account di servizio. La finestra di creazione delle chiavi non mostra questi controlli delle autorizzazioni per le chiavi degli account di servizio; puoi modificarle in seguito nelle impostazioni Chiavi API del progetto.
Configurare l'accesso ai modelli e i limiti di richieste
Per gestire i limiti di richieste dei progetti sono necessarie autorizzazioni amministrative. I proprietari dell'organizzazione dispongono di queste autorizzazioni; anche i proprietari dei progetti possono gestire i limiti di richieste dei progetti tramite l'API di gestione.
Vai alle impostazioni dell'organizzazione.
Seleziona il progetto, quindi apri Limiti.
Usa Utilizzo dei modelli per scegliere quali modelli può usare il progetto.
Imposta un limite di richieste per ogni modello in base alle tue esigenze.
Impostare limiti e avvisi di spesa
I limiti di spesa mensile per le API sono disponibili sia a livello di organizzazione sia di progetto. Per modificare un limite, devi disporre delle autorizzazioni per gestire le impostazioni dell'organizzazione o del progetto interessato.
Un limite di spesa può servire a monitorare i costi senza interrompere le richieste. Attiva Applica un limite rigido se vuoi che le richieste API non vadano a buon fine quando la spesa rilevata raggiunge il limite. Il blocco non è istantaneo, quindi la spesa registrata può superare leggermente l'importo configurato.
Gli avvisi di spesa ti informano quando viene raggiunta una soglia; non interrompono le richieste.
Impostare un limite di spesa per l'organizzazione
Vai alle impostazioni dell'organizzazione.
Apri Limiti e individua Spesa.
Impostare un limite di spesa per il progetto
Vai alle impostazioni dell'organizzazione.
Seleziona il progetto, quindi apri Limiti.
Imposta i valori di Limite di spesa mensile e Avvisa quando la spesa raggiunge.
Attiva Applica un limite rigido se vuoi interrompere il traffico API quando la spesa rilevata raggiunge il limite.
In questa pagina puoi anche modificare Utilizzo dei modelli.
Gestire gli avvisi di spesa
Quando crei un limite di spesa per un progetto, per impostazione predefinita viene creato anche un avviso al raggiungimento del 100% del limite. Seleziona Aggiungi avviso per aggiungere avvisi ad altre soglie.
I proprietari dell'organizzazione e del progetto ricevono gli avvisi di spesa del progetto. Puoi aggiungere altri destinatari email nelle impostazioni degli avvisi.
Per la procedura di configurazione aggiornata e il funzionamento del blocco, consulta la guida ai limiti di spesa.
Visualizzare utilizzo e fatturazione
I dati di utilizzo possono essere suddivisi per progetto e puoi visualizzare la fatturazione e impostare limiti di spesa per i singoli progetti.
L'accesso alla dashboard di utilizzo di un progetto dipende dal tuo ruolo nell'organizzazione e dalle impostazioni di visibilità della dashboard di utilizzo. Essere proprietario di un progetto non è di per sé sufficiente per ottenere l'accesso.
Se non riesci a visualizzare la dashboard di utilizzo di un progetto, controlla se la visibilità è impostata su Visibile ai proprietari dell'organizzazione.
Gestire lo spazio di archiviazione dei file
Ogni progetto dispone di una quota di archiviazione file di 100 GB. Se la superi, potresti visualizzare questo errore:
Hai superato la quota di archiviazione dei file. Le organizzazioni possono archiviare un massimo di 100 GB di file. Riduci le dimensioni del file o contatta l'assistenza.
Elimina i file inutilizzati per liberare spazio di archiviazione. Puoi elencare i file archiviati tramite l'API per individuare quelli che non ti servono più.
Archiviare un progetto
I proprietari dell'organizzazione e del progetto possono archiviare i progetti dalla pagina Progetti o dalle impostazioni del singolo progetto. Quando richiesto, inserisci il nome del progetto per confermare.
L'archiviazione è definitiva: un progetto archiviato non può essere ripristinato.
Per visualizzare i progetti archiviati, apri la scheda Archiviati nella pagina Progetti.
L’unica eccezione è che i fine-tune nel “progetto predefinito” possono essere accessibili da altri progetti.
Hai superato la quota di archiviazione file. Le organizzazioni sono limitate a 100 GB di file. Riduci la dimensione dei file o contatta il supporto.I progetti non possono essere eliminati. OpenAI ne conserva la cronologia per monitorare utilizzo e fatturazione.