Domande frequenti
In questa pagina
Accesso
Chi può usare Model Router? Gli Organisation Administrator, nelle strutture Technology Stack. Aprilo dal menu principale, nel gruppo AI Modules & Agents.
Fatturazione e crediti
Si tratta di un abbonamento? No, è prepagato. Ricarichi un saldo in USD e l'utilizzo lo scala al prezzo per token di ciascun modello. Non ci sono addebiti ricorrenti per l'AI oltre a ciò che usi.
Cosa succede quando il saldo si esaurisce? Le richieste di inferenza vengono bloccate con un errore di insufficient credits finché non ricarichi. Non si perde nulla (chiavi, servizi connessi, impostazioni e cronologia restano tutti invariati) e le richieste riprendono pochi istanti dopo una ricarica. Attiva la ricarica automatica per evitare interruzioni.
Posso ottenere il rimborso del saldo non utilizzato? Invia una richiesta di assistenza. I rimborsi compaiono nella cronologia delle transazioni come tipo a sé.
Ricevo delle ricevute? Sì: ogni ricarica ha un numero di ricevuta e un PDF scaricabile nel pannello dei dettagli della transazione e la ricevuta viene inviata via email ai contatti di fatturazione della tua struttura. Per scaricarne più di una contemporaneamente, seleziona le righe nella cronologia delle transazioni e fai clic su Download receipts (n). L'utilizzo non prevede ricevute: Monthly usage offre invece un rendiconto di utilizzo (PDF) e un dettaglio di utilizzo (CSV) per ogni mese. Si tratta di rendiconti di utilizzo, non di fatture. Le ricevute di Model Router compaiono anche insieme agli altri documenti di fatturazione della struttura in Invoices & Receipts di Billing & Cost Management.
Perché "Spent today" è diverso da Monthly usage? Spent today e il saldo disponibile sono in tempo reale, mentre Monthly usage viene riconciliato con il tuo saldo ogni 15 minuti. I valori coincidono alla riconciliazione successiva. La cronologia delle transazioni elenca solo ricariche e rettifiche del saldo, quindi l'utilizzo non vi compare affatto.
Come viene tariffato l'Auto Router? Non ha un prezzo proprio: paghi la tariffa del modello che sceglie per ogni richiesta. I log mostrano quale modello è stato usato.
Privacy e dati
I miei prompt o le risposte dell'AI vengono memorizzati? No. Activity e Logs registrano solo metadati: modello, token, costo, latenza, stato, chiamante. Il contenuto dei prompt e delle risposte non viene mai memorizzato dal Performance Hub.
Posso impedire che i dati personali raggiungano i modelli? Sì: attiva PII masking in Settings → Guardrails e aggiungi filtri dei contenuti personalizzati per tutto ciò che è specifico del tuo settore. Vedi Guardrails.
Posso limitare i fornitori a cui vengono inviati i miei dati? Sì: la pagina Models offre preset con un solo clic (ad es. Western providers, descritto come "data-sovereignty friendly") e interruttori per singolo modello. Chiavi e servizi connessi possono essere ulteriormente limitati. Vedi Models.
Chiavi API e integrazioni
Quale software posso connettere? Qualsiasi software che supporti l'API OpenAI e ti consenta di impostare un URL di base e una chiave API personalizzati (BYOK): gli SDK OpenAI, la maggior parte dei framework AI e molti strumenti pronti all'uso. Vedi Connettere la tua applicazione.
Posso rivedere il segreto della chiave dopo averla creata? No, viene mostrato una sola volta. Se va perso, usa Rotate sulla chiave per ottenere un nuovo segreto.
Quante chiavi dovrei creare? Una per sistema. Le etichette rendono visibile l'utilizzo di ciascun sistema in Activity e Logs e una chiave compromessa può essere ruotata senza toccare nient'altro.
Qual è la differenza tra revocare ed eliminare una chiave? La revoca disattiva la chiave immediatamente ma in modo reversibile (Re-activate la ripristina). L'eliminazione è permanente.
È possibile limitare una chiave a modelli specifici? Sì, con Restrict models for this key nella configurazione della chiave. Lo stesso vale per ogni servizio connesso.
AI Agents e Workflows
I miei AI Agents hanno bisogno di una chiave API? No. Gli agenti associati alla tua struttura si connettono automaticamente con credenziali per dispositivo gestite dal Performance Hub. Compaiono in Settings → Service Access & API Keys → Connected Services con spesa e controlli propri.
I Workflows possono usare Model Router? Sì. I Workflows possono connettersi come servizio e compaiono quindi in Connected Services accanto ai tuoi AI Agents.
Posso limitare quanto spende un singolo agente o workflow? Sì: con limiti per servizio giornalieri, mensili e complessivi, più limiti di frequenza, restrizioni sui modelli e sostituzioni dei guardrail. Vedi Connected Services.
Modelli e instradamento
Quale modello dovrebbe usare la mia integrazione?
auto (l'Auto Router) è l'impostazione predefinita consigliata: instrada ogni richiesta a un modello adatto alla sua complessità, in modo che il lavoro semplice vada a modelli veloci ed economici e le attività difficili ai modelli più potenti. In alternativa, usa qualsiasi ID di modello specifico attivato per la tua struttura.
Perché i miei log mostrano un modello diverso da quello che ho richiesto?
Hai richiesto auto: i log mostrano il modello scelto dal router e il pannello della richiesta registra auto come Requested model. È il comportamento previsto.
Posso modificare i modelli a cui instrada auto?
Sì: Edit routing nella scheda Auto Router ti consente di scegliere il modello per ciascun livello di complessità per la tua struttura, con l'opzione Reset to default disponibile. Vedi Models.
Un modello che mi interessa non è nel catalogo. Usa il link Raise a support request nella pagina Models: "Want to see a model added? Raise a support request and we'll add it if it's generally available."
Limiti
Qual è la differenza tra il saldo e un limite di spesa? Il saldo è il denaro che hai accreditato; i limiti di spesa sono tetti definiti da criteri che scegli tu. Entrambi possono bloccare le richieste: un saldo esaurito blocca finché non ricarichi; un limite raggiunto blocca finché la sua finestra non si azzera (o finché non lo modifichi). Vedi Come funziona.
Quando si azzerano esattamente i limiti giornalieri e mensili? Quello giornaliero a mezzanotte e quello mensile il 1° del mese, entrambi nel fuso orario locale della struttura. Il messaggio di errore budget exceeded indica l'ora esatta dell'azzeramento.
Il tetto massimo complessivo si azzera mai da solo? No. Conteggia la spesa dal suo ultimo azzeramento manuale. Reset hard cap riporta il contatore a $0 (l'importo del tetto resta invariato) e salva il periodo chiuso nella cronologia degli azzeramenti.
I limiti per chiave e i limiti dell'account si sommano? Sì, si applicano entrambi. Per essere eseguita, una richiesta deve rispettare i limiti dell'account e i limiti propri della chiave o del servizio chiamante (oltre al saldo).