AI Management
Il menu AI del Cloud Services Portal le consente di usare il nostro Everyware AI API senza dover gestire infrastruttura propria. Da questo pannello crea progetti IA autonomi, genera chiavi API per i suoi agenti e le sue applicazioni e controlla quali provider, modelli, budget e limiti si applicano a ogni chiave.
In questo modo l'uso dell'IA resta indipendente dai suoi progetti OpenStack: non le serve un progetto, un flavor o una quota OpenStack per iniziare a inviare prompt al gateway. Le chiavi sono compatibili con OpenAI e funzionano con qualsiasi SDK o agente che parla l'interfaccia REST OpenAI.
Everyware AI API vs. AI Management
Questa sezione documenta la funzionalità del portale: creare progetti e chiavi nel Cloud Services Portal.
Per la piattaforma in sé (modelli disponibili, endpoint, streaming, tool calling), veda AI Platform. Per la specifica REST completa, veda API Reference.
Panoramica degli elementi
Lavorare con il pannello AI ruota attorno a un piccolo insieme di concetti. Capire come interagiscono Client Admin, progetto IA, utenti del portale invitati e chiavi API è la chiave per usare il servizio in modo efficiente.
Come minimo, per chiamare Everyware AI API le serve:
- Un Client Admin che crea il progetto IA e vi invita gli utenti.
- Un progetto IA come contenitore organizzativo e di budget.
- Un utente del portale invitato al progetto.
- Una chiave API (secret
sk-bf-…) creata da quell'utente all'interno del progetto.
Il diagramma seguente mostra come gli elementi sono correlati.
| Elemento | Nome | Descrizione |
|---|---|---|
| (A) | Client Admin | Un utente del portale con ruolo Admin. Solo gli Admin possono creare progetti IA e invitarvi altri utenti. |
| (B) | Progetto IA | Isola le risorse del progetto (provider, modelli, budget e limiti) ed è indipendente da OpenStack. Creato dall'Admin. |
| (C) | Utente del portale | Un utente esistente del Cloud Services Portal che l'Admin ha invitato al progetto. Un utente può essere membro di più progetti. |
| (D) | Chiave API | Una credenziale denominata (sk-bf-…) per chiamare il gateway. Esiste in quattro tipi di chiavi API (personale, legata a un utente di progetto (privata), condivisa di progetto e cliente) che differiscono per il legame e per chi può vederle. Veda Tipi di chiavi API. |
| (E) | Provider / LLM | Restrizione facoltativa a livello di progetto. Se lasciata vuota, tutti i provider e i modelli sono disponibili per le chiavi del progetto. |
| (F) | Budget e limiti | Tetti di consumo facoltativi definiti sul progetto ed ereditati dalle sue chiavi. Vuoto significa illimitato. |
In breve:
- Un Client Admin (A) crea uno o più progetti IA (B).
- L'Admin invita utenti del portale esistenti (C) in ogni progetto.
- Ogni progetto IA (B) isola i propri provider/LLM (E) e il proprio budget e limiti (F).
- Un utente del portale invitato (C) crea una o più chiavi API (D) all'interno di un progetto; le chiavi ereditano le restrizioni del progetto.
- Gli agenti usano una chiave API (D) per chiamare Everyware AI API direttamente: nessun progetto OpenStack richiesto.
Panoramica della dashboard
L'area AI si raggiunge tramite la voce AI nell'elenco delle funzionalità a sinistra del Cloud Services Portal. È divisa in due sezioni: AI Projects Management e Key Management.
AI Projects Management
Questa sezione mostra le sue chiavi API raggruppate per progetto IA. Selezioni un progetto per lavorare con le sue chiavi e i suoi utenti.
| Elemento | Descrizione |
|---|---|
| Elenco dei progetti | Selezioni un progetto IA per visualizzare le sue chiavi e i suoi utenti. |
| Chiavi | Le chiavi API del progetto selezionato. Qui può creare, visualizzare, revocare e disattivare chiavi. La visibilità dipende dal tipo di chiave. Veda Visibilità delle chiavi. |
| Utenti | Gli utenti del portale invitati al progetto selezionato. Gli Admin possono invitare e rimuovere utenti qui. |
| Create AI Project | Apre la procedura guidata di creazione del progetto con i campi Budget e Limits. Veda Creare un progetto IA. |
| Change Client Limits | Gli Admin impostano limiti a livello di cliente validi per l'intero cliente, non per i singoli progetti. |
Key Management
Questa sezione mostra tutte le chiavi API del cliente in un elenco piatto e filtrabile (filtrabile per utente e/o progetto IA). È anche il luogo in cui crea nuove chiavi.
| Elemento | Descrizione |
|---|---|
| Elenco delle chiavi | Tutte le chiavi del cliente, filtrabili per utente e progetto IA. Gli Admin possono elencare, rimuovere e disattivare chiavi qui. Veda Gestire le chiavi (Admin). |
| Create Project | Apre una procedura guidata di creazione progetto di base senza i campi Budget e Limits. |
| Change Client Limit | La stessa funzione di limiti a livello di cliente di AI Projects Management. |
| Create Key | Apre la finestra di dialogo di creazione della chiave. Il tipo di chiave si sceglie tramite il campo Project e la casella User-bound. Veda Creare una chiave API. |
Dove viene mostrato il consumo
Budget, limiti e consumo dei progetti 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.
Prerequisiti
La creazione di un progetto IA richiede il ruolo Admin nel Cloud Services Portal. Gli utenti normali del portale non possono creare progetti: un Admin deve creare il progetto e invitarli prima.
Per usare il pannello AI le serve:
- Un account valido nel Cloud Services Portal.
- Per creare un progetto: il ruolo Admin e l'autorizzazione ad accedere al menu AI.
- Per creare chiavi: essere stato invitato ad almeno un progetto IA da un Admin.
- (Facoltativo) Un agente, script o SDK locale che parla l'interfaccia REST compatibile con OpenAI, se vuole provare subito una chiave.
Passi successivi
- Creare un progetto IA : gli admin configurano provider, modelli, budget, limiti e invitano gli utenti.
- Generare una chiave API : gli utenti invitati creano una chiave e la usano nel proprio agente.
- AI Platform : modelli, endpoint e casi d'uso.
- API Reference : specifica REST completa.