I progetti mirano a offrire ai clienti la possibilità di organizzare il proprio lavoro. Le organizzazioni possono gestire accesso e limiti, effettuare il provisioning degli account di servizio (tramite l’interfaccia utente) e monitorare l’utilizzo rispetto a un ambito limitato all’interno di un progetto (ad es. modelli, funzionalità, thread, assistant, 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 loro progetti attivi e archiviati nella pagina Projects. 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 mouse sul nome della tua organizzazione in alto a sinistra nella pagina e seleziona l’organizzazione dall’elenco:
Per le organizzazioni che utilizzano 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 aggiungo utenti a un progetto?
I nuovi membri aggiunti all’organizzazione non vengono aggiunti automaticamente al “progetto predefinito”. I nuovi membri possono essere invitati al progetto quando vengono invitati nell’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 da l’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 nelle organizzazioni e nei progetti e quali autorizzazioni comportano?
Mentre le organizzazioni hanno i ruoli ‘owner’ e ‘reader’, i progetti hanno i ruoli ‘owner’ e ‘member’. I membri del progetto sono analoghi ai reader dell’organizzazione. Consulta la tabella seguente per una descrizione più dettagliata delle autorizzazioni associate a ciascun ruolo utente.
| Ruolo | Ambito | Descrizione |
|---|---|---|
| Owner | Organizzazione | Può creare/visualizzare tutti i progetti, tutti gli utenti, tutte le chiavi API. Ha la possibilità di monitorare tutti i progetti all’interno dell’organizzazione con la pagina Projects. Può impostare i budget dell’organizzazione e dei progetti. Può concedere ad altri nell’organizzazione le autorizzazioni per visualizzare le informazioni di utilizzo. Può archiviare progetti. |
| Reader | Organizzazione | Può eseguire inferenza, usare risorse e creare chiavi nei propri progetti. Può essere aggiunto ai progetti. Non può creare progetti né gestire utenti. |
| Owner | Progetto | Può aggiungere altri utenti al progetto e rinominare il progetto, oltre a tutte le capacità di un Member. Può impostare i budget di progetto. Può archiviare il progetto. |
| Member | Progetto | Può eseguire inferenza, usare risorse e creare chiavi a livello di progetto. |
Se non sono un Owner dell’organizzazione, a cosa ho accesso?
Gli utenti che non sono Owner 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 avere accesso alla pagina Projects.
Solo i membri di un progetto (e i proprietari dell’organizzazione) possono vedere i modelli fine-tuned creati all’interno di quel progetto, i thread di eventuali Assistants creati o i file che sono stati aggiunti.
I membri di un progetto possono vedere chi sono tutti gli altri membri di quel progetto e i loro ruoli (ovvero Owner o Member).
Come aggiorno il ruolo di un utente in un progetto o rimuovo un utente da un progetto?
Solo il proprietario di un progetto può aggiornare il ruolo di un utente nel progetto 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 Members. Hai la possibilità di impostare il ruolo di ciascun membro come Member o Owner. Puoi anche selezionare Remove 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 della 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 'Add to Default Project" se non vuoi concedere a questi utenti un accesso più ampio). Questo elenco non includerà gli account di servizio. Durante questo passaggio puoi scegliere se assegnare il ruolo Owner o Member:
Quando aggiungi un membro del team, devi assegnargli il ruolo di Member o Owner. 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:
Poi vai alle impostazioni dell’organizzazione -> Project -> Members -> 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.
Salvare la chiave API dell’account di servizio
Dopo aver selezionato il pulsante Create, 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 più visualizzarla 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 su lettura e scrittura di tutte le risorse API del progetto. Queste autorizzazioni possono essere aggiornate nelle impostazioni API Keys del progetto.
Gli account di servizio sono elencati insieme ai membri del progetto nella pagina delle impostazioni dei membri del progetto. Fai riferimento qui 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, sia dei progetti sia delle organizzazioni, verranno mostrati insieme agli utenti umani nella pagina membri a livello di organizzazione.
Gli account di servizio vengono gestiti come gli account normali. Da Organization -> menu Members puoi Remove un account di servizio o aggiornarne il ruolo:
Come gestisco le chiavi API nei 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 API Keys.
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: All, Restricted e Read Only.
All — Le autorizzazioni complete sono impostate per la chiave segreta. Questa è l’impostazione predefinita.
Restricted — Consente all’utente di impostare autorizzazioni None, Read e Write per ciascun endpoint.
Ad esempio, puoi creare una chiave API che specificamente non ha l’autorizzazione di Read o Write per l’endpoint /v1/assistants:
Read Only — 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 imposto e gestisco i limiti di frequenza per i progetti della mia organizzazione?
Solo il proprietario di un’organizzazione può impostare e gestire i limiti di frequenza a livello di progetto. Per ulteriori informazioni, consulta ruoli e autorizzazioni.
Nelle impostazioni dell’organizzazione, fai clic sul progetto che vuoi aggiornare e seleziona Limits nella sezione Project dell’elenco di navigazione. In questa pagina puoi aggiornare Model Usage.
Model usage ti consente di configurare quali modelli possono essere usati dal progetto e i limiti di frequenza possono essere impostati per ciascun modello secondo necessità.
Come imposto e gestisco 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 di progetto. Per ulteriori informazioni, consulta ruoli e autorizzazioni. Per modificare i limiti a livello di organizzazione, nelle impostazioni dell’organizzazione, fai clic su Limits, quindi scorri fino a Usage limits.
Per impostare i limiti del progetto, nelle impostazioni dell’organizzazione, fai clic sul progetto che vuoi aggiornare e seleziona Limits. Puoi aggiornare Monthly budget, Notification threshold e Model Usage.
L’impostazione di un budget mensile ti consente di stabilire soglie di spesa flessibili per il tuo 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à è progettata per aiutarti a monitorare l’utilizzo tramite avvisi di budget, ma non applica un limite rigido alla spesa. Quando viene creato un budget di progetto, per impostazione predefinita verrà creato un avviso alla soglia del 100%. È possibile impostare budget aggiuntivi con soglie diverse facendo clic su Add Alert.
Tieni presente che il proprietario o i proprietari dell’organizzazione e il proprietario o i proprietari del progetto riceveranno sempre questi messaggi e ciò non può essere personalizzato.
Come faccio a eliminare o archiviare un progetto?
I progetti possono essere archiviati tramite la nuova pagina elenco progetti o 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 “Archived” nella stessa pagina elenco progetti.
Non è possibile eliminare i progetti; manteniamo una cronologia di tutti i progetti per garantire la continuità del monitoraggio di utilizzo e 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 Usage del mio progetto?
La visibilità della dashboard Usage di un progetto non è legata al ruolo di un utente all’interno del 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 Usage, probabilmente questa impostazione è configurata su "Visible to organization owners".