I progetti hanno lo scopo di consentire ai clienti di organizzare il proprio lavoro. Le organizzazioni possono gestire accessi e limiti, effettuare il provisioning degli account di servizio (tramite l'interfaccia utente) e monitorare l'utilizzo rispetto a un ambito circoscritto all'interno di un progetto (ad es. modelli, funzionalità, thread, assistenti, fine-tuning, archiviazione ecc.). L'attività di utilizzo può essere suddivisa per progetto e gli utenti possono visualizzare la fatturazione e impostare limiti di spesa per progetto.
I proprietari dell'organizzazione possono visualizzare tutti i propri progetti attivi e archiviati nella pagina Progetti. Scopri di più sui ruoli utente e sulle autorizzazioni nella Piattaforma API.
Chi può creare un progetto?
Solo i proprietari dell'organizzazione possono creare un progetto. Per maggiori informazioni, consulta ruoli e autorizzazioni.
Per passare da un'organizzazione all'altra, posiziona il puntatore sul nome dell'organizzazione in alto a sinistra nella pagina e seleziona l'organizzazione dall'elenco:
Per le organizzazioni con un piano di fatturazione consolidata, le organizzazioni secondarie sono indicate separatamente. Non è possibile creare progetti nelle organizzazioni secondarie.
Come funzionano i progetti?
Ogni organizzazione include un «Progetto predefinito» che non può essere eliminato. Puoi configurare i limiti di frequenza, le autorizzazioni virtuali dei modelli e i limiti di spesa (da novembre 2024). Eredita l'intera configurazione dell'organizzazione, quindi non puoi aggiungervi direttamente membri o account di servizio.
Come si crea un progetto?
Per prima cosa, posiziona il puntatore sul nome del progetto nell'angolo sinistro della pagina e seleziona Crea progetto.
Inserisci un nome, una descrizione e un sito web per il progetto, quindi seleziona Crea.
Come si aggiungono utenti a un progetto?
I nuovi membri dell'organizzazione non vengono aggiunti automaticamente al «Progetto predefinito». I nuovi membri possono essere invitati al progetto quando vengono invitati nell'organizzazione, selezionando la casella "Invita al progetto predefinito", oppure dopo che hanno accettato l'invito all'organizzazione.
Gli utenti invitati tramite l'API Admin seguono le regole definite dall'endpoint /organization/invites.
Se si verifica un errore durante l'invito di utenti a un progetto tramite l'interfaccia utente o l'API Admin, prima di inviare nuovamente l'invito verifica che il progetto di destinazione esista e non sia archiviato.
I proprietari dell'organizzazione vengono aggiunti automaticamente come proprietari ai nuovi progetti creati al suo interno.
Quali sono i diversi ruoli utente nelle organizzazioni e nei progetti e quali autorizzazioni prevedono?
Mentre le organizzazioni prevedono i ruoli «proprietario» e «lettore», i progetti prevedono i ruoli «proprietario» e «membro». I membri del progetto sono equivalenti ai lettori dell'organizzazione. La tabella seguente descrive più dettagliatamente le autorizzazioni associate a ciascun ruolo utente.
| Ruolo | Ambito | Descrizione |
|---|---|---|
| Proprietario | Organizzazione | Può creare e visualizzare tutti i progetti, gli utenti e le chiavi API. Può monitorare tutti i progetti dell'organizzazione dalla pagina Progetti . Può impostare i limiti di spesa dell'organizzazione e dei progetti. Può concedere ad altri membri dell'organizzazione l'autorizzazione a visualizzare le informazioni sull'utilizzo. Può archiviare i progetti. |
| Lettore | Organizzazione | Può eseguire inferenze, usare le risorse e creare chiavi nei propri progetti. Può essere aggiunto ai progetti. Non può creare progetti né gestire utenti. |
| Proprietario | Progetto | Può aggiungere altri utenti al progetto e rinominarlo, oltre a disporre di tutte le funzionalità di un Membro. Può impostare i limiti di spesa del progetto. Può archiviare il progetto. |
| Membro | Progetto | Può eseguire inferenze, usare le risorse e creare chiavi a livello di progetto. |
Se non sono Proprietario dell'organizzazione, a cosa posso accedere?
Gli utenti che non sono Proprietari dell'organizzazione possono vedere solo i progetti di cui sono membri. Solo il proprietario dell'organizzazione può vedere tutti i progetti, i membri e le chiavi API a livello di progetto e accedere alla pagina Progetti.
Solo i membri di un progetto e i proprietari dell'organizzazione possono vedere i modelli ottimizzati creati nel progetto, i thread degli Assistants creati e i file aggiunti.
I membri di un progetto possono vedere tutti gli altri membri del progetto e i relativi ruoli, ad esempio Proprietario o Membro.
Come si aggiorna il ruolo di un utente in un progetto o si rimuove un utente dal progetto?
Solo il proprietario di un progetto può aggiornare il ruolo di un utente o rimuoverlo dal progetto. Per maggiori informazioni, consulta ruoli e autorizzazioni.
Per aggiornare un utente in un progetto, vai alle impostazioni dell'organizzazione, seleziona il progetto e fai clic su Membri. Puoi impostare il ruolo di ogni utente su Membro o Proprietario. Puoi anche selezionare Rimuovi per rimuovere l'utente dal progetto.
Che cos'è un account di servizio e in cosa si differenzia da un normale account utente?
Un account di servizio funge da pseudo-utente progettato per l'accesso ai sistemi ed è distinto dagli account dei singoli utenti. Solo i proprietari dell'organizzazione e del progetto possono creare account di servizio.
Gli account di servizio sono limitati solo ai progetti.
Aggiungere un membro a un progetto
Facendo clic sul pulsante + Aggiungi membro, vedrai un elenco degli utenti dell'organizzazione con il ruolo Lettore. Per aggiungere un utente che non appartiene ancora all'organizzazione, devi prima aggiungerlo all'organizzazione. Puoi lasciare deselezionata la casella 'Aggiungi al progetto predefinito" se non vuoi concedergli un accesso più ampio. L'elenco non include gli account di servizio. In questa fase puoi assegnare il ruolo Proprietario o Membro:
Quando aggiungi un membro del team, devi assegnargli il ruolo Membro o Proprietario. I membri del progetto possono effettuare richieste API che leggono o modificano dati, mentre i proprietari possono anche modificare le impostazioni e i limiti di spesa del progetto, oltre a gestirne i membri. Per maggiori informazioni, consulta ruoli e autorizzazioni.
Come creare un account di servizio per un progetto
Per prima cosa, accedi al progetto per cui vuoi creare un account di servizio selezionandolo dal menu a discesa nella barra di navigazione:
Quindi vai alle impostazioni dell'organizzazione -> Progetto -> Membri -> fai clic su + Account di servizio:
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.
Assegnare un nome all'account di servizio
Che tu crei l'account di servizio a livello di organizzazione o specificamente per un progetto, puoi assegnargli un ID univoco composto da lettere, numeri e trattini, così da identificarlo facilmente.
Salvare la chiave API dell'account di servizio
Dopo aver selezionato il pulsante Crea, viene creata immediatamente una chiave API per l'account di servizio e viene visualizzata la chiave segreta. Salva questa chiave segreta in un luogo sicuro. Per motivi di sicurezza, non potrai visualizzarla di nuovo tramite il tuo account OpenAI. Se perdi questa chiave segreta, dovrai generarne una nuova.
Per impostazione predefinita, la chiave API dell'account di servizio dispone delle autorizzazioni di lettura e scrittura per tutte le risorse API del progetto. Puoi aggiornare queste autorizzazioni nelle impostazioni Chiavi API del progetto.
Gli account di servizio sono elencati insieme ai membri del progetto nella pagina delle impostazioni dei membri. Consulta questa sezione per saperne di più su come aggiornare o rimuovere l'accesso di un account di servizio nella pagina delle impostazioni dei membri del progetto.
Tutti gli account di servizio in progetti e organizzazioni verranno visualizzati insieme ai tuoi utenti umani nella pagina dei membri a livello di organizzazione.
Gli account di servizio sono gestiti come account normali. Dal menu Organizzazione -> Membri puoi rimuovere un account di servizio o aggiornare il ruolo:
Come si gestiscono le chiavi API nei progetti dell'organizzazione?
Puoi creare e gestire le chiavi API di ogni progetto dalla relativa pagina delle impostazioni. Nelle impostazioni dell'organizzazione, seleziona il progetto e fai clic su Chiavi API.
Per creare una nuova chiave segreta, seleziona + Crea nuova chiave segreta. Puoi anche selezionare l'icona Modifica accanto a una chiave segreta per modificarne le autorizzazioni.
Puoi impostare le autorizzazioni di ogni chiave API quando crei una nuova chiave segreta o modificando una chiave esistente.
Sono disponibili tre livelli di autorizzazione: Tutte, Limitate e Sola lettura.
Tutte — Alla chiave segreta vengono assegnate autorizzazioni complete. Questa è l'impostazione predefinita.
Limitate — Consente all'utente di impostare le autorizzazioni Nessuna, Lettura e Scrittura per ogni endpoint.
Ad esempio, puoi creare una chiave API priva delle autorizzazioni di lettura e scrittura per l'endpoint /v1/assistants:
Sola lettura — Per tutti gli endpoint vengono impostate autorizzazioni di lettura.
Come viene gestito l'accesso per gli utenti che appartengono a più progetti o organizzazioni?
Gli utenti possono essere membri di tutti i progetti necessari. All'interno di un progetto, gli utenti possono generare una chiave API personale il cui ambito e accesso sono limitati a quel progetto e alle relative risorse.
Come si impostano e gestiscono i limiti di frequenza per i progetti dell'organizzazione?
Solo il proprietario dell'organizzazione può impostare e gestire i limiti di frequenza a livello di progetto. Per maggiori informazioni, consulta ruoli e autorizzazioni.
Nelle impostazioni dell'organizzazione, fai clic sul progetto da aggiornare e seleziona Limiti nella sezione Progetto dell'elenco di navigazione. In questa pagina puoi aggiornare l'Utilizzo dei modelli.
Utilizzo dei modelli consente di configurare quali modelli può usare il progetto e di impostare, se necessario, i limiti di frequenza per ciascun modello.
Come si impostano e gestiscono i limiti di spesa per i progetti dell'organizzazione?
Solo i proprietari dell'organizzazione e del progetto possono impostare e gestire i limiti di spesa del progetto. Per maggiori informazioni, consulta ruoli e autorizzazioni. Per modificare i limiti a livello di organizzazione, nelle impostazioni dell'organizzazione fai clic su Limiti e scorri fino a Limiti di utilizzo.
Per impostare i limiti del progetto, nelle impostazioni dell'organizzazione fai clic sul progetto da aggiornare e seleziona Limiti. Puoi aggiornare Limite di spesa mensile, Soglia di notifica e Utilizzo dei modelli.
L'impostazione di un limite di spesa mensile consente di definire soglie di spesa non vincolanti per il progetto. Quando l'utilizzo supera questo limite durante un determinato mese di calendario (UTC), le richieste API continuano a essere elaborate senza interruzioni. Questa funzionalità aiuta a monitorare l'utilizzo tramite avvisi sui limiti di spesa, ma non impone un tetto massimo alla spesa. Quando viene creato un limite di spesa per un progetto, per impostazione predefinita viene creato un avviso alla soglia del 100%. Per impostare altri avvisi con soglie diverse, fai clic su Aggiungi avviso.
I proprietari dell'organizzazione e del progetto riceveranno sempre questi messaggi; questa impostazione non può essere personalizzata.
Come si impostano i limiti di spesa per un'organizzazione o un progetto?
OpenAI ora supporta limiti mensili di spesa API sia a livello di organizzazione sia di progetto. Un limite di spesa può monitorare le spese senza bloccarle oppure può essere applicato come limite rigido, così che le richieste API non vadano a buon fine una volta raggiunto. Per la procedura di configurazione e il comportamento più recenti, consulta Limiti di spesa nella documentazione per sviluppatori.
Come si elimina o archivia un progetto?
Puoi archiviare i progetti dalla nuova pagina con l'elenco dei progetti oppure dalle impostazioni del singolo progetto. Una volta archiviato, un progetto non può essere ripristinato. Durante l'archiviazione, ti verrà chiesto di inserire il nome del progetto per procedere.
Puoi visualizzare l'elenco di tutti i progetti archiviati nella scheda «Archiviati» della stessa pagina con l'elenco dei progetti.
Non è possibile eliminare i progetti. Conserviamo la cronologia di tutti i progetti per garantire la continuità del monitoraggio dell'utilizzo e della fatturazione.
Esiste un limite al numero di progetti che posso avere nell'organizzazione?
Per impostazione predefinita, le organizzazioni possono creare fino a 2.000 progetti.
È possibile condividere le risorse tra progetti?
Le risorse di un progetto, come file, assistenti, spazio di archiviazione o thread, sono limitate al progetto e non sono accessibili ai membri non amministratori esterni al progetto. Inoltre, le risorse non possono essere spostate tra progetti.
L’unica eccezione è che i fine-tune nel “progetto predefinito” possono essere accessibili da altri progetti.
Qual è la quota di archiviazione dei file per ogni progetto?
OpenAI attualmente supporta una quota di archiviazione di 100 GB di file per progetto.
Se questa quota viene superata, verrà visualizzato il seguente errore:
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.Ti consigliamo di eliminare i file inutilizzati archiviati nel tuo account. Come riferimento, puoi visualizzare ed elencare i file con l'API.
Sono proprietario di un progetto: perché non riesco a visualizzarne la dashboard Utilizzo?
La visibilità della dashboard Utilizzo di un progetto non dipende dal ruolo dell'utente nel progetto. Dipende invece dal tuo ruolo nell'organizzazione e dalle impostazioni disponibili all'indirizzo https://platform.openai.com/settings/organization/data-controls/visibility
Se non riesci a visualizzare una dashboard Utilizzo, è probabile che questa opzione sia impostata su "Visibile ai proprietari dell'organizzazione".