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 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 per i modelli virtuali e i limiti di spesa (a partire da novembre 2024). Eredita l'intera configurazione dell'organizzazione, quindi non puoi aggiungervi direttamente membri o account di servizio.
Come faccio a creare 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 faccio ad aggiungere 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, selezionando la casella "Invita al progetto predefinito", oppure dopo che hanno accettato l'invito all'organizzazione.
Gli utenti invitati tramite l'API di amministrazione seguono le regole descritte dall'endpoint /organization/invites.
Se si verifica un errore quando inviti utenti a un progetto tramite l'interfaccia utente o l'API di amministrazione, 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 comportano?
Mentre le organizzazioni hanno i ruoli “proprietario” e “lettore”, i progetti hanno i ruoli “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. 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 utenti dell'organizzazione l'autorizzazione a visualizzare le informazioni sull'utilizzo. Può archiviare i progetti. |
| Lettore | Organizzazione | Può eseguire inferenze, usare 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 ad avere tutte le capacità di un Membro. Può impostare i limiti di spesa del progetto. Può archiviare il progetto. |
| Membro | Progetto | Può eseguire inferenze, usare 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, oltre ai proprietari dell'organizzazione, possono vedere i modelli ottimizzati creati nel progetto, i thread degli Assistenti creati e i file aggiunti.
I membri di un progetto possono vedere tutti gli altri membri del progetto e i rispettivi ruoli, ad esempio Proprietario o Membro.
Come faccio ad aggiornare il ruolo di un utente nel progetto o a rimuoverlo dal progetto?
Solo il proprietario di un progetto può aggiornare il ruolo di un utente nel progetto o rimuoverlo dal progetto. Per ulteriori informazioni, consulta ruoli e autorizzazioni.
Per aggiornare un utente di un progetto, vai alle impostazioni dell'organizzazione, seleziona il progetto e fai clic su Membri. Puoi impostare il ruolo di ciascun membro su 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
Facendo clic sul pulsante + Aggiungi membro, vedrai un elenco degli utenti dell'organizzazione con il ruolo Lettore. Se vuoi aggiungere un utente che non fa ancora parte dell'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 scegliere se assegnare il ruolo di Proprietario o Membro:
Quando aggiungi un membro del team, devi assegnargli il ruolo di Membro o Proprietario. I membri del progetto possono effettuare richieste API che leggono o modificano i dati, mentre i proprietari possono anche modificare le impostazioni e i limiti di spesa del progetto e gestirne i membri. Per ulteriori informazioni, consulta ruoli e autorizzazioni.
Come creare un account di servizio per un progetto
Per prima cosa, accedi al progetto per il quale vuoi creare un account di servizio selezionandolo dal menu a discesa nella barra di navigazione:
Quindi vai alle impostazioni dell'organizzazione -> Progetto -> Membri -> e 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
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 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. Queste autorizzazioni possono essere aggiornate 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 maggiori informazioni 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 faccio a gestire le chiavi API nei progetti della mia organizzazione?
Puoi creare e gestire le chiavi API di ciascun progetto nella 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 ciascuna chiave API quando crei una nuova chiave segreta oppure modificando una chiave esistente.
Sono disponibili tre livelli di autorizzazione: Tutte, Con restrizioni e Sola lettura.
Tutte — Alla chiave segreta vengono concesse autorizzazioni complete. Questa è l'impostazione predefinita.
Con restrizioni — Consente all'utente di impostare le autorizzazioni Nessuna, Lettura e Scrittura per ciascun endpoint.
Ad esempio, puoi creare una chiave API che non disponga specificamente delle autorizzazioni di lettura o scrittura per l'endpoint /v1/assistants:
Sola lettura — Le autorizzazioni di lettura vengono 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 limiti di spesa per i progetti della mia organizzazione?
Solo i proprietari di un'organizzazione e i proprietari di un progetto possono impostare e gestire i limiti di spesa del progetto. Per ulteriori informazioni, consulta ruoli e autorizzazioni. Per modificare i limiti a livello di organizzazione, nelle impostazioni dell'organizzazione fai clic su Limiti, quindi 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. Se l'utilizzo supera questo limite durante un determinato mese di calendario (UTC), le richieste API continueranno a essere elaborate senza interruzioni. Questa funzionalità aiuta a monitorare l'utilizzo mediante avvisi sui limiti di spesa, ma non impone un tetto massimo di 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.
Tieni presente che i proprietari dell'organizzazione e del progetto riceveranno sempre questi messaggi e che questa impostazione non può essere personalizzata.
Come faccio a impostare limiti di spesa per la mia organizzazione o il mio progetto?
OpenAI ora supporta limiti di spesa API mensili sia a livello di organizzazione sia di progetto. Un limite di spesa può monitorare la spesa senza applicare vincoli, oppure puoi renderlo vincolante come limite rigido, così che le richieste API non vadano a buon fine dopo il raggiungimento del limite. Per i passaggi di configurazione e il comportamento più aggiornati, consulta Limiti di spesa nella documentazione per sviluppatori.
Come faccio a eliminare o archiviare un progetto?
I progetti possono essere archiviati dalla nuova pagina con l'elenco dei progetti oppure dalle impostazioni del singolo progetto. Una volta archiviato, un progetto non può essere ripristinato. Per procedere con l'archiviazione, ti verrà chiesto di inserire il nome del progetto.
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 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 dei file per ciascun progetto?
OpenAI supporta attualmente 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".