Vai al contenuto

Progetti IA

Un progetto IA è il contenitore organizzativo e di budget per il suo uso dell'IA nel Cloud Services Portal. Ogni progetto isola le proprie risorse (provider, modelli, budget e limiti) e tutte le chiavi API create all'interno di un progetto ereditano queste impostazioni.

I progetti IA sono indipendenti da OpenStack: non le serve un progetto, un flavor o una quota OpenStack per creare o usare un progetto IA.

Solo gli utenti con ruolo Admin possono creare progetti IA. Dopo aver creato un progetto, l'Admin invita utenti del portale esistenti a parteciparvi; questi utenti possono poi creare le proprie chiavi API nel progetto.

Prerequisiti

  • Il ruolo Admin nel Cloud Services Portal. Gli utenti normali non possono creare progetti: un Admin deve creare il progetto e invitarli prima.
  • L'autorizzazione ad accedere al menu AI.
  • (Facoltativo) Un'idea dei provider, modelli, budget e limiti a cui vuole circoscrivere il progetto: tutti questi elementi sono facoltativi e possono restare vuoti per un accesso illimitato.

Creare un progetto IA

Esistono due modi per creare un progetto IA, a seconda della sezione AI da cui si parte:

  • Da AI Projects Management: clicchi su Create AI Project. Questa procedura guidata include i campi Budget e Limits, quindi la usi quando vuole porre un tetto alle chiavi del progetto.
  • Da Key Management: clicchi su Create Project. È una procedura guidata di base senza i campi Budget e Limits, per una creazione rapida del progetto.

Creare un progetto IA

Ogni Project isola le sue risorse come bucket, oggetti e credenziali. Compili i campi obbligatori, poi scelga Create.

Campo Descrizione In Create AI Project (Projects Management) In Create Project (Key Management)
Name Indichi un nome per il progetto. ✅ ✅
Description Indichi una descrizione per questo progetto. ✅ ✅
Providers Selezioni i provider IA da impostare nel profilo. Se non impostati, tutti i provider sono disponibili. ✅ ✅
LLMs Selezioni gli LLM da impostare nel progetto. Se non impostati, tutti gli LLM sono disponibili. ✅ ✅
Budget Definisca il budget di cui disporranno le chiavi di questo progetto. Se non impostato, è illimitato. ✅ —
Limits Definisca i limiti di cui disporranno le chiavi di questo progetto. Se non impostati, sono illimitati. ✅ —

Progetto e tipo di chiave

Providers, LLMs, Budget e Limits sono definiti a livello di progetto. Le chiavi create all'interno del progetto (chiavi legate a un utente di progetto e condivise di progetto) ereditano queste restrizioni. Per dare a un altro team o a un altro agente un proprio budget o un proprio insieme di modelli, crei un progetto separato.

Le chiavi API personali e le chiavi cliente non sono legate a un progetto e quindi non ne ereditano le impostazioni. Veda Tipi di chiavi API per sapere quale tipo usare in ciascun caso.

Change Client Limits

I Client Admin possono impostare limiti a livello di cliente validi per l'intero cliente, non per i singoli progetti. Questa funzione è disponibile da entrambe le sezioni AI:

  • In AI Projects Management: clicchi su Change Client Limits.
  • In Key Management: clicchi su Change Client Limit.

Entrambi i pulsanti aprono la stessa funzione. La usi per porre un tetto al consumo a livello di cliente, al di sopra dei budget e dei limiti di ogni progetto.

Invitare utenti a un progetto

Un progetto appena creato non ha ancora utenti: solo l'Admin che lo ha creato lo vede. Per consentire ad altri utenti del portale di creare chiavi nel progetto, l'Admin deve invitarli.

  1. Vada su AI → AI Projects Management.
  2. Selezioni il progetto IA.
  3. Passi alla vista Users.
  4. Clicchi su Add User.
  5. Selezioni uno o più utenti esistenti del Cloud Services Portal.
  6. Confermi.

Invitare utenti

Gli utenti invitati vedono ora il progetto nel proprio elenco AI Projects Management e possono crearvi le proprie chiavi API (veda Chiavi API).

Gli utenti sono account del portale esistenti

AI Management non crea utenti specifici per l'IA. Gli utenti che invita sono gli stessi utenti del Cloud Services Portal gestiti sotto Organisation Management. Un utente può essere invitato a più progetti IA.

La visibilità delle chiavi dipende dal tipo di chiave

Le chiavi API esistono in quattro tipi (veda Tipi di chiavi API). All'interno di un progetto, la chiave legata a un utente di progetto di un utente è privata per quell'utente; una chiave condivisa di progetto (creata da un Client Admin) è visibile a tutti i membri del progetto. Gli Admin vedono tutte le chiavi di un progetto. Le chiavi non sono condivise tra utenti, a meno che non siano chiavi condivise di progetto. Veda Visibilità delle chiavi per i dettagli e l'approccio consigliato per le chiavi che più agenti devono condividere.

Modificare un progetto

Apra il progetto IA in AI Projects Management e lo modifichi dalla vista del progetto. Provider, modelli, budget e limiti possono essere modificati dopo la creazione.

Warning

Restringere il budget o i limiti di un progetto influisce su tutte le chiavi di quel progetto immediatamente. Se un agente sta già consumando tramite una chiave, potrebbe raggiungere il nuovo tetto a metà richiesta.

Eliminare un progetto

Apra il progetto IA in AI Projects Management e lo elimini dalla vista del progetto.

Warning

L'eliminazione di un progetto IA invalida tutte le chiavi API che gli appartengono. Qualsiasi agente che usa ancora una di queste chiavi riceverà immediatamente errori di autenticazione. Revochi o migri le chiavi prima di eliminare un progetto in uso.

Dove viene mostrato il consumo

Budget, limiti e consumo di un progetto IA sono visibili solo nel pannello AI: non compaiono nella dashboard Usage generale né nel pannello Quota. Il consumo OpenStack e il consumo IA sono tracciati separatamente.

Passi successivi