I progetti mirano a offrire ai clienti la possibilità di organizzare il proprio lavoro. Le organizzazioni possono gestire accesso e limiti, predisporre account di servizio (tramite l'interfaccia utente) e monitorare l'utilizzo rispetto a un ambito vincolato 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 budget per progetto.
I proprietari dell'organizzazione possono visualizzare tutti i propri progetti attivi e archiviati nella pagina Progetti. Scopri di più su ruoli utente e autorizzazioni nella piattaforma API.
Chi può creare un progetto?
Solo i proprietari dell'organizzazione possono creare un progetto. Per ulteriori informazioni, consulta ruoli e autorizzazioni.
Per passare da un'organizzazione all'altra, passa il cursore sul nome della tua organizzazione in alto a sinistra nella pagina e seleziona l'organizzazione dall'elenco:
Per le organizzazioni che hanno un piano di fatturazione consolidata, le sotto-organizzazioni sono identificate separatamente. Non è possibile creare progetti all'interno delle sotto-organizzazioni.
Come funzionano i progetti?
Ogni organizzazione include un “progetto predefinito” che non può essere eliminato. Puoi configurare i limiti di frequenza, le autorizzazioni del modello virtuale e i budget di spesa (a partire da novembre 2024). Eredita la configurazione completa dell’organizzazione, quindi non puoi aggiungervi direttamente membri o account di servizio.
Come creo un progetto?
Per prima cosa, passa il mouse sul nome del progetto nell’angolo sinistro della pagina e seleziona Create project.
Fornisci un nome, una descrizione e un sito web per il tuo progetto, quindi seleziona Create.
Come faccio ad aggiungere utenti a un progetto?
I membri appena aggiunti all'organizzazione non vengono aggiunti automaticamente al “Progetto predefinito”. I nuovi membri possono essere invitati al progetto quando vengono invitati all'organizzazione (abilitando la casella "Invita al progetto predefinito") oppure dopo che il membro ha accettato l'invito all'organizzazione.
Gli utenti invitati tramite l'Admin API seguono le regole descritte dall'endpoint /organization/invites.
Se riscontri un errore quando inviti utenti a un progetto tramite l'interfaccia utente o l'Admin API, verifica innanzitutto che il progetto di destinazione esista e non sia archiviato prima di inviare di nuovo l'invito.
I proprietari dell'organizzazione vengono aggiunti automaticamente come proprietari ai nuovi progetti creati all'interno di un'organizzazione.
Quali sono i diversi ruoli utente all'interno di organizzazioni e progetti, e quali autorizzazioni comportano?
Mentre le organizzazioni hanno i ruoli di “proprietario” e “lettore”, i progetti hanno i ruoli di “proprietario” e “membro”. I membri del progetto sono analoghi ai lettori dell'organizzazione. Consulta la tabella seguente per una descrizione più dettagliata delle autorizzazioni associate a ciascun ruolo utente.
| Ruolo | Ambito | Descrizione |
|---|---|---|
| Proprietario | Organizzazione | Può creare/visualizzare tutti i progetti, tutti gli utenti e tutte le chiavi API. Ha la possibilità di monitorare tutti i progetti all'interno dell'organizzazione con la pagina Progetti . Può impostare budget dell'organizzazione e budget dei progetti. Può concedere ad altri nell'organizzazione le autorizzazioni per visualizzare le informazioni sull'utilizzo. Può archiviare progetti. |
| Lettore | Organizzazione | Può eseguire inferenze, utilizzare 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 rinominare il progetto, oltre ad avere tutte le capacità di un membro. Può impostare budget di progetto. Può archiviare il progetto. |
| Membro | Progetto | Può eseguire inferenze, utilizzare risorse e creare chiavi a livello di progetto. |
Se non sono proprietario nell'organizzazione, a cosa ho accesso?
Gli utenti che non sono proprietari nell'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 avere accesso alla pagina Progetti.
Solo i membri di un progetto (e i proprietari dell'organizzazione) possono vedere i modelli sottoposti a fine tuning creati all'interno di quel progetto, i thread degli assistenti creati o eventuali file aggiunti.
I membri di un progetto possono vedere chi sono tutti gli altri membri di quel progetto e i loro ruoli (ad es. Proprietario o Membro).
Come faccio ad aggiornare il ruolo di progetto di un utente o a rimuovere un utente da un progetto?
Solo il proprietario di un progetto può aggiornare il ruolo di progetto di un utente o rimuovere un utente da un progetto. Per ulteriori 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 ciascun membro come Membro o Proprietario. Puoi anche selezionare Rimuovi per rimuovere l'utente dal progetto.
Che cos’è un account di servizio e in cosa differisce da un normale account utente?
Un account di servizio agisce come uno pseudo-utente progettato per l’accesso ai sistemi, distinto dai singoli account utente. 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
Se fai clic sul pulsante + Add member, vedrai un elenco di utenti nella tua organizzazione con il ruolo Reader. Se vuoi aggiungere un utente che al momento non fa parte della tua organizzazione, devi prima aggiungerlo all'organizzazione (puoi lasciare deselezionata la casella «Aggiungi al progetto predefinito» se non vuoi concedere a questi utenti un accesso più ampio). Questo elenco non includerà gli account di servizio. In questo passaggio puoi scegliere se il loro ruolo sarà Owner o Member:
Quando aggiungi un membro del team, devi assegnargli il ruolo di Membro o di Proprietario. I membri del progetto possono effettuare richieste API che leggono o modificano dati, mentre i proprietari del progetto possono anche modificare le impostazioni e i budget del progetto e gestire i membri del progetto. Per ulteriori informazioni, consulta ruoli e autorizzazioni.
Come creare un account di servizio per un progetto
Per prima cosa, vai al progetto per cui vuoi creare un account di servizio scegliendolo dal menu a discesa nella barra di navigazione:
Quindi, vai alle impostazioni dell'organizzazione -> Progetto -> Membri -> fai clic su + Service account:
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
Indipendentemente dal fatto che tu crei l’account di servizio a livello di organizzazione o ne crei uno univoco per un progetto, quando crei un account di servizio puoi creare un ID univoco dell’account di servizio composto da lettere, numeri e trattini per identificarlo facilmente.
Salva la chiave API dell'account di servizio
Dopo aver selezionato il pulsante Crea, viene immediatamente creata una chiave API per l'account di servizio e la chiave segreta verrà visualizzata. Salva questa chiave segreta in un luogo sicuro e protetto. Per motivi di sicurezza, non potrai visualizzarla di nuovo tramite il tuo account OpenAI. Se perdi questa chiave segreta, dovrai generarne una nuova.
Le autorizzazioni della chiave API dell'account di servizio sono impostate per impostazione predefinita in lettura e scrittura su tutte le risorse API del progetto. Queste autorizzazioni possono essere aggiornate nelle impostazioni delle chiavi API del progetto.
Gli account di servizio sono elencati insieme ai membri del progetto nella pagina delle impostazioni dei membri del progetto. Consulta qui per saperne di più sull'aggiornamento o la rimozione dell'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 faccio a gestire le chiavi API all'interno dei progetti della mia organizzazione?
Puoi creare e gestire le chiavi API per ciascun progetto nella pagina delle impostazioni di quel progetto. Nelle impostazioni dell'organizzazione, seleziona il progetto e fai clic su Chiavi API.
Per creare una nuova chiave segreta, seleziona + Create new secret key. Puoi anche selezionare l'icona Modifica accanto a una chiave segreta per modificarne le autorizzazioni.
Puoi impostare le autorizzazioni per ciascuna delle tue chiavi API quando crei una nuova chiave segreta o modificando una chiave esistente.
Sono disponibili tre livelli di autorizzazioni: Tutte, Limitate e Sola lettura.
Tutte — Per la chiave segreta vengono impostate autorizzazioni complete. Questa è l'impostazione predefinita.
Limitate — Consente all'utente di impostare autorizzazioni Nessuna, Lettura e Scrittura per ciascun endpoint.
Ad esempio, crei una chiave API che specificamente non dispone dell'autorizzazione di lettura o scrittura per l'endpoint /v1/assistants:
Sola lettura — Le autorizzazioni di lettura sono impostate per tutti gli endpoint.
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 con ambito e accesso limitati a quel progetto e alle sue risorse.
Come faccio a impostare e gestire i limiti di richieste per i progetti della mia organizzazione?
Solo il proprietario di un'organizzazione può impostare e gestire i limiti di richieste a livello di progetto. Per ulteriori informazioni, consulta ruoli e autorizzazioni.
Nelle impostazioni dell'organizzazione, fai clic sul progetto che vuoi aggiornare e seleziona Limiti nella sezione Progetto dell'elenco di navigazione. Puoi aggiornare l'utilizzo dei modelli in questa pagina.
L'utilizzo dei modelli ti consente di configurare quali modelli possono essere usati dal progetto, mentre i limiti di richieste possono essere impostati per ciascun modello secondo necessità.
Come faccio a impostare e gestire i budget per i progetti della mia organizzazione?
Solo i proprietari di un'organizzazione e i proprietari di un progetto possono impostare e gestire i budget dei progetti. Per ulteriori 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 che vuoi aggiornare e seleziona Limiti. Puoi aggiornare il budget mensile, la soglia di notifica e l'utilizzo dei modelli.
L'impostazione di un budget mensile ti consente di stabilire soglie di spesa non vincolanti per il progetto. Quando l'utilizzo supera questo limite in un determinato mese di calendario (UTC), le richieste API continueranno a essere elaborate senza interruzioni. Questa funzionalità è pensata per aiutarti a monitorare l'utilizzo tramite avvisi di budget, ma non impone un tetto rigido alla spesa. Quando viene creato un budget di progetto, per impostazione predefinita viene creato un avviso alla soglia del 100%. È possibile impostare budget aggiuntivi a soglie diverse facendo clic su Aggiungi avviso.
Tieni presente che i proprietari dell'organizzazione e i proprietari del progetto riceveranno sempre questi messaggi e questo non può essere personalizzato.
Come faccio a eliminare o archiviare un progetto?
I progetti possono essere archiviati tramite la nuova pagina elenco dei progetti oppure nelle impostazioni di un singolo progetto. Una volta archiviato, un progetto non può essere ripristinato. Quando procedi con l'archiviazione, ti verrà chiesto di inserire il nome del progetto per continuare.
Puoi visualizzare un elenco di tutti i progetti archiviati tramite la scheda “Archiviati” nella stessa pagina elenco dei progetti.
Non è possibile eliminare i progetti: manteniamo una cronologia di tutti i progetti per garantire continuità nel monitoraggio dell'utilizzo e della fatturazione.
Esiste un limite al numero di progetti che posso avere nella mia organizzazione?
Per impostazione predefinita, le organizzazioni possono creare fino a 2.000 progetti.
Le risorse possono essere condivise tra progetti?
Le risorse del progetto, come file, assistant, archiviazione o thread, sono limitate al progetto e non possono essere accessibili da 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 file per progetto?
OpenAI supporta attualmente una quota di archiviazione di 100 GB di file per progetto.
Se questa quota viene superata, vedrai 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 vedere la dashboard di utilizzo per il mio progetto?
La visibilità della dashboard di utilizzo di un progetto non è correlata al ruolo di un utente all'interno di un progetto. È invece determinata dal tuo ruolo all'interno dell'organizzazione e dalle impostazioni in https://platform.openai.com/settings/organization/data-controls/visibility
Se non riesci a vedere una dashboard di utilizzo, è probabile che questa impostazione sia configurata su "Visibile ai proprietari dell'organizzazione".