Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Un controllo dei costi è un criterio in Microsoft Foundry che tiene traccia della spesa o dell'utilizzo dei token dei progetti, delle distribuzioni di modelli, degli agenti o delle sessioni degli agenti ospitati che scegli. Quando l'utilizzo raggiunge le soglie impostate, un controllo costi invia un avviso o blocca le nuove richieste. I controlli dei costi conteggiano l'utilizzo durante l'esecuzione delle richieste, in modo che possano agire prima che uno sforamento si rifletta sulla fattura.
Gli amministratori della piattaforma e i professionisti di FinOps usano i controlli dei costi per impostare i budget tra i team. Project lead e sviluppatori li usano per limitare la propria spesa e per controllare i limiti applicabili ai progetti.
Importante
I controlli dei costi di Foundry sono in anteprima pubblica e sono soggetti alle Condizioni d'uso supplementari per le anteprime di Microsoft Azure. Questa anteprima viene fornita senza un contratto di servizio e Microsoft non lo consiglia per i carichi di lavoro di produzione. Alcune funzionalità potrebbero non essere supportate o potrebbero avere funzionalità limitate.
Funzionamento dei controlli dei costi
Ogni controllo dei costi combina un budget, l'utilizzo a cui si applica, un periodo di reimpostazione e le azioni di soglia.
| Part | Cosa definisce | Example |
|---|---|---|
| Bilancio | Una quantità di spesa in dollari statunitensi o un numero di token. | Limite mensile di 10M token. |
| Si applica a | Utilizzo che conta per il budget: tutti gli utilizzi nella risorsa Foundry o nel Project, o nella parte selezionata con filtri, ad esempio un Project o alcuni agenti. | Tutti gli agenti in un unico progetto. |
| Condivisione del budget | Indipendentemente dal fatto che tutti i dati di utilizzo corrispondenti condividano un budget o che ogni progetto, agente o sessione abbia il proprio budget. | Ogni agente ottiene l'intero importo. |
| Periodo di ripristino | La frequenza con cui l'utilizzo con conteggio si azzera: giornaliero, settimanale o mensile. | Mensile. |
| Appuntamenti | Quando inizia e termina il controllo dei costi. Inserisci le date nel tuo fuso orario locale e Foundry le salva in formato UTC. | Inizia oggi e termina il 30 giugno. |
| Azioni di soglia | Cosa accade quando l'utilizzo raggiunge una soglia: inviare un avviso o bloccare l'utilizzo. | Inviare un avviso a 80%e bloccare l'utilizzo a 100%. |
Quando arriva una richiesta, Foundry verifica i controlli dei costi che si applicano. Se uno di essi ha raggiunto una soglia di blocco dell'utilizzo , la richiesta viene bloccata. In caso contrario, la richiesta viene eseguita e il relativo utilizzo viene conteggiato per ogni controllo dei costi corrispondente.
- Le richieste bloccate restituiscono il codice
429di stato HTTP con l'intestazionex-ms-budget-cause: budget_exceedede un messaggio di errore che inizia con "Budget superato per il controllo dei costi". Quando un agente trasmette la propria risposta in streaming, l'errore arriva invece come evento nel flusso. Per informazioni dettagliate, vedere Rispondere quando le richieste vengono bloccate. - La richiesta che supera una soglia può comunque essere completata, quindi l'utilizzo può terminare leggermente al di sopra di una soglia.
- Le richieste bloccate hanno esito positivo dopo la successiva reimpostazione, dopo aver aumentato il budget o dopo aver rimosso il controllo dei costi.
- Le modifiche apportate a un controllo costi diventano effettive entro 15 minuti.
Un controllo dei costi senza azioni di soglia tiene traccia dell'utilizzo in Application Insights senza influire sulle richieste. Usare questa configurazione per controllare la spesa prima di applicare un limite.
L'utilizzo per i controlli dei costi in una risorsa Foundry viene registrato in una risorsa di Application Insights, selezionata in Dati di utilizzo quando si crea un controllo costi. Si tratta di un'impostazione condivisa per la risorsa Foundry, quindi la modifica influisce su ogni controllo dei costi sulla risorsa. Foundry Project Managers possono visualizzarlo, ma solo un amministratore della risorsa Foundry può modificarlo. Gli avvisi e i blocchi non dipendono da esso. Ne hai bisogno per vedere quanto ogni controllo dei costi sia vicino al proprio limite.
Come i controlli dei costi determinano il prezzo
I controlli dei costi devono agire in tempo reale, ore prima che i costi siano visibili in Gestione costi di Azure. Quindi Foundry mantiene il proprio totale cumulativo per ogni controllo dei costi:
- Un budget Tokens conta i token di ogni richiesta corrispondente.
- Un budget di spesa prezzi tali token con uno snapshot dei prezzi negoziati e con i prezzi al dettaglio per i modelli che non hanno un prezzo negoziato. I prezzi negoziati sono i prezzi del contratto Azure, ad esempio un contratto Enterprise o un Contratto del cliente Microsoft. Per visualizzarli, vedere Visualizzare e scaricare i prezzi Azure dell'organizzazione.
Durante l'anteprima pubblica, questo totale non è riconciliato con la fattura. La fattura può applicare i prezzi che lo snapshot non applica, ad esempio i prezzi a livelli, che in genere riducono quanto paghi. Quindi il totale di un controllo dei costi tende a essere leggermente superiore al costo fatturato e il controllo dei costi raggiunge le soglie un po' prima. La differenza può crescere in un lungo periodo di reimpostazione, ad esempio un mese.
Usare i controlli dei costi come limiti di guardrail che entrano in funzione durante l'esecuzione delle richieste e usare le pagine dei costi e Gestione costi di Azure per tenere traccia della spesa e confrontarla.
Tip
Per agire prima di un limite rigido, associare una soglia di blocco dell'utilizzo a una soglia precedente di invia avviso, ad esempio un avviso a 80% e un blocco a 100%.
Dove si creano i controlli dei costi
Si crea un controllo dei costi in una risorsa Foundry o in un progetto. Il proprietario decide dove gestire il controllo dei costi e quale utilizzo può coprire.
| Proprietario | Dove nel portale foundry | Si applica a | In genere è usato da |
|---|---|---|---|
| Risorsa della fonderia | Gestisci>Costo>Controllo dei costi | Tutti gli utilizzi nella risorsa o nei progetti, nelle distribuzioni di modelli, negli agenti o nelle sessioni selezionati con i filtri. | Amministratori della piattaforma e professionisti finops che impostano budget tra i team. |
| Progetto | Monitor>Controllo dei costi nel Project | Utilizzo in tale progetto. È possibile restringerla con filtri, ad esempio agenti specifici. Il controllo dei costi rimane nel progetto. | Responsabili di progetto e sviluppatori che gestiscono autonomamente la spesa. |
Nella scheda Controllo costi di un progetto sono elencati anche i controlli dei costi della risorsa Foundry che si applicano al progetto, di sola lettura. Nella scheda Monitoraggio>costi di un Project la scheda budget di Project mostra il budget di spesa per l'intero Project più vicino al limite. Tale budget può essere il controllo dei costi di un progetto o il controllo dei costi di una risorsa Foundry che filtra per il progetto. I budget a livello di risorsa, i budget filtrati per le distribuzioni di modelli e i budget dei token non vengono usati come budget del progetto e i budget delle schede vengono conteggiati separatamente per agente o sessione.
Il ruolo necessario dipende dal proprietario:
| Task | Controlli dei costi delle risorse Foundry | controlli dei costi di Project |
|---|---|---|
| Visualizzazione | Tutti i ruoli Foundry e Reader | Tutti i ruoli Foundry e Reader |
| Crea, modifica ed elimina | Proprietario dell'account Foundry, Proprietario Foundry, Proprietario e Collaboratore | Foundry Account Owner, Foundry Owner, Foundry Project Manager, Owner e Contributor |
Importante
I ruoli di Controllo degli accessi in base al ruolo di Foundry sono stati recentemente rinominati. Foundry User, Foundry Owner, Foundry Account Owner e Foundry Project Manager erano precedentemente denominati Azure AI User, Azure AI Owner, Azure AI Account Owner e Azure AI Project Manager. È possibile che i nomi precedenti vengano visualizzati in alcune posizioni durante l'esecuzione della ridenominazione. Gli ID ruolo e le autorizzazioni di base sono invariati dalla ridenominazione.
Per le autorizzazioni di questi ruoli, vedere Autorizzazioni per i dati sui costi e i controlli dei costi.
A cosa si può applicare un controllo dei costi
Un controllo dei costi copre tutti gli utilizzi nella risorsa Foundry o nel Project. Per restringerla, aggiungere filtri in A cosa si applica?. Quando si aggiungono più filtri, l'utilizzo viene conteggiato solo se corrisponde a tutti i filtri.
| Filter | Cosa conta per il budget |
|---|---|
| Project | Utilizzo nei progetti selezionati. Disponibile nei controlli dei costi di una risorsa Foundry. |
| Distribuzione | Richieste alle distribuzioni del modello selezionate, incluse le richieste effettuate dagli agenti. |
| Agente | Richieste effettuate dagli agenti selezionati. Nei controlli dei costi di una risorsa Foundry aggiungere prima di tutto un filtro Progetto con un progetto. |
| Sessione | Utilizzo nelle sessioni dell'agente ospitate elencate in base all'ID, fino a 20. |
Scegliere quindi come viene condiviso il budget, in Come deve essere condiviso il budget?:
| Option | Come viene conteggiato l'utilizzo |
|---|---|
| Un budget per tutto | Tutti i conteggi di utilizzo corrispondenti vengono calcolati per il totale. |
| Budget perAgente, Sessione o Progetto | Ogni agente, sessione o Project ottiene l'intero importo. Project è disponibile nei controlli dei costi di una risorsa Foundry. Il budget per sessione si applica solo agli agenti ospitati e l'arresto e la ripresa di una sessione non reimposta l'utilizzo. |
Per coprire gli agenti in diversi progetti, creare un controllo dei costi per progetto o filtrare in base al progetto.
Tipi di budget
| Tipo di budget | Cosa misura | Cosa sapere |
|---|---|---|
| Spesa | Spesa per le richieste corrispondenti, in dollari statunitensi. | Prezzo stabilito in base all'esecuzione della richiesta. Per informazioni dettagliate, vedere Come i controlli dei costi determinano il prezzo. |
| Token | I token utilizzati dalle richieste corrispondenti. | Conta Tutti i tipi di token o Solo tipi specifici: Input, Output o entrambi. Immettere i limiti con K, M, B o T abbreviato, ad esempio 10M per 10.000.000 token. |
Dopo aver creato un controllo dei costi, non è possibile modificarne il tipo di budget o i tipi di token che conta. Per misurare qualcosa di diverso, creare un nuovo controllo dei costi.
Azioni di soglia
Le azioni di soglia definiscono cosa accade quando l'utilizzo si avvicina al budget. È possibile aggiungere ogni azione una sola volta.
| Action | Che succede | Usalo per |
|---|---|---|
| Invia avviso | Viene inviata una notifica tramite il topic di Griglia di eventi di Azure selezionato. Le richieste continuano. | Avvisa i proprietari in anticipo, ad esempio a 80%. |
| Bloccare l'utilizzo | Le nuove richieste coperte dal controllo dei costi vengono bloccate quando l'utilizzo raggiunge la soglia. | Interrompere la spesa al raggiungimento di un limite rigido. |
Impostare ogni soglia come percentuale del budget, 50%, 75%, 80%, 90%o 100%o come importo nell'unità del budget, dollari o token. L'utilizzo del blocco inizia al 100% del budget ed è possibile ridurlo. Una soglia Send alert deve essere pari o inferiore alla soglia Block usage.
Quando si salva un controllo costi con un'azione Invia avviso , Foundry crea una connessione condivisa all'argomento Griglia di eventi nella risorsa Foundry. L'argomento deve usare lo schema di input CloudEvents v1.0 e consentire l'autenticazione basata su chiave. Per notificare gli utenti, sottoscrivere l'argomento, ad esempio con un flusso di lavoro App per la logica di Azure, Funzioni di Azure o un webhook. Mentre l'utilizzo è superiore o superiore alla soglia, ogni richiesta che conta per il controllo dei costi invia un altro evento di avviso, quindi rimuovere i duplicati nell'automazione. Per il formato dell'evento, vedere Ricevere avvisi.
Stati del controllo dei costi
Gli elenchi di controllo dei costi mostrano lo stato di ogni controllo dei costi nella colonna Stato . La maggior parte degli stati deriva dall'utilizzo in Application Insights. L'utilizzo è una stima che può seguire l'imposizione di alcuni minuti, quindi questi stati vengono contrassegnati come Stimati.
| State | Meaning |
|---|---|
| Scheduled | La data di inizio è futura. Il controllo dei costi inizia a conteggiare l'utilizzo a partire da quella data. |
| In linea | L'utilizzo è inferiore al punto di soglia prossima. |
| Soglia prossima | L'utilizzo ha raggiunto la soglia Send alert più bassa o l'80% del budget se il controllo dei costi non invia avvisi. |
| Limite raggiunto | L'utilizzo ha raggiunto il budget o la soglia Blocca utilizzo. Se il controllo dei costi blocca, le nuove richieste coperte vengono bloccate fino al successivo ripristino. Se non viene bloccato, lo stato viene contrassegnato con il tag Over budget e le richieste continuano. |
| Expired | La data di fine è passata. Il controllo dei costi non conta più l'utilizzo né esegue le azioni di soglia. |
| Attivo | Il controllo dei costi è attivo, ma l'utilizzo non può essere letto, quindi l'utilizzo mostra Utilizzo sconosciuto. Questo stato non significa che le richieste siano bloccate. |
| Configurazione necessaria | Il controllo dei costi non copre ancora alcun utilizzo, quindi non tiene traccia di nulla. |
Se l'utilizzo mostra Autorizzazione richiesta o Utilizzo non disponibile, non è possibile leggere i dati di utilizzo o Application Insights non è configurato. Per le soluzioni, vedi Risolvere i problemi relativi ai controlli dei costi.
Quando si applicano diversi controlli dei costi
Una richiesta può essere conteggiata ai fini di più di un controllo dei costi. Ad esempio, un budget di spesa a livello di risorse e il limite di token di un progetto possono coprire entrambi lo stesso agente. Foundry valuta ogni controllo dei costi separatamente e blocca la richiesta se un controllo è bloccato. In pratica, il controllo dei costi più restrittivo decide se una richiesta può essere eseguita.
Elementi supportati in questa anteprima
| Area | Support |
|---|---|
| Models | Modelli GPT, ad esempio gpt-5.4-mini e modelli di serie O OpenAI. I modelli di altri provider, ad esempio Claude e DeepSeek, non sono supportati in questa anteprima. Un nuovo modello GPT rilasciato viene supportato una volta che il prezzo è disponibile per il controllo dei costi, in genere circa una settimana dopo il rilascio. Fino a quel momento, i budget di spesa non ne conteggiano l'utilizzo e tale utilizzo non viene aggiunto in un secondo momento. I budget dei token lo contano come di consueto. |
| Accesso immediato | Un controllo dei costi non può essere applicato da solo all'utilizzo di accesso immediato. Non esiste alcun filtro per modello e un filtro Deployment copre solo i deployment di modelli selezionati, mai le richieste di accesso istantaneo. Per disattivare l'accesso istantaneo o limitare i modelli consentiti, vedere Controlli aziendali. |
| Modello di router | Non completamente supportato in questa anteprima. Il costo del router del modello combina il proprio addebito con gli addebiti del modello selezionato per ogni richiesta, quindi i controlli dei costi potrebbero non contare l'utilizzo di tutti i router del modello. |
| Agents | Agenti prompt e agenti ospitati, incluse le sessioni dell'agente ospitato. |
| Tipi di distribuzione | Le distribuzioni di throughput con provisioning (PTU) non vengono conteggiate. |
| Regions | Tutte le aree, per i modelli fatturati da Foundry in tale area. |
| Cosa viene conteggiato | I token del modello e la spesa per loro. Gli addebiti degli strumenti dell'agente, ad esempio la ricerca Web e le risorse di calcolo ospitate per l'agente, non vengono conteggiati. |
| Chi viene conteggiato | I budget per utente o per gruppo Microsoft Entra non sono disponibili in questa anteprima. Per assegnare ai team budget separati, usare un budget per agente o per Project o assegnare a ogni team la propria distribuzione del modello. |
Limitations
- Durante l'anteprima pubblica, la spesa di un controllo dei costi è una stima che non viene riconciliata con la fattura. Per riconciliare la spesa, usare Gestione costi di Azure.
- Per visualizzare l'utilizzo di ogni controllo dei costi, Application Insights deve essere configurato per la risorsa Foundry ed è necessario l'accesso in lettura ai relativi dati. Invia avviso e Blocca l'utilizzo funzionano senza di esso.
- Nel controllo dei costi di una risorsa Foundry, un filtro Agent copre gli agenti in un unico progetto.
- L'applicazione delle modifiche richiede fino a 15 minuti, pertanto le richieste potrebbero superare un limite nuovo o inferiore durante tale periodo.
- Se Foundry non riesce a controllare una richiesta in base ai controlli di costo in tempo, la richiesta viene eseguita.
- Non è possibile modificare il nome o il tipo di budget di un controllo dei costi dopo averlo creato. Anche nel portale foundry i relativi tipi di token sono bloccati. La modifica della modalità di condivisione del budget o del periodo di reimpostazione avvia un nuovo conteggio di utilizzo.
- Ogni controllo dei costi ha una data di fine. Per mantenerne attivo uno, modificarne la data di fine prima che scada.
- I controlli dei costi di un Project contano le richieste di Chat Completions al progetto, ma non le bloccano. I controlli dei costi del progetto predefinito di una risorsa Foundry contano anche le richieste all'endpoint della risorsa senza bloccarle. Per bloccare queste richieste, usare un controllo dei costi nella risorsa Foundry.
- Non è possibile eliminare un Project con controlli dei costi propri. Eliminare prima i controlli dei costi del progetto.
- Con l'API REST creare controlli di costo uno alla volta. Le richieste che creano controlli di costo sulla stessa risorsa Foundry contemporaneamente possono avere esito negativo con
409. Per informazioni dettagliate, vedere Creare controlli dei costi a livello di codice.
Confrontare i controlli dei costi con altri modi per gestire la spesa
Foundry offre diversi controlli che interagiscono. Ognuno limita qualcosa di diverso.
| CTRL | Cosa limita | Può bloccare le richieste | Granularità | Dati usati | Dove la imposti |
|---|---|---|---|---|---|
| Controlli dei costi di Foundry (anteprima) | Spesa o token in ogni periodo di reimpostazione | Yes | Risorsa, progetto, distribuzione del modello, agente o sessione | Utilizzo durante l'esecuzione delle richieste, al prezzo calcolato in base a uno snapshot dei prezzi negoziati | Portale di Foundry o API REST. Vedere Creare e gestire i controlli dei costi. |
| budget Gestione costi di Azure | Costo in ogni periodo | No. I budget inviano avvisi e i gruppi di azioni possono avviare un'automazione personalizzata. | Sottoscrizione, gruppo di risorse, risorsa o ambito di fatturazione | Costo, da 8 a 24 ore dopo l'utilizzo | Portale di Azure. Vedere Creare e gestire i budget. |
| Quota | La capacità effettiva di distribuzione, in token al minuto o unità elaborate con provisioning | Le richieste che superano il limite di flusso in entrata vengono limitate | Sottoscrizione, area geografica e modello | Tempo reale | Portale Foundry. Vedere Gestire le quote. |
| Limiti dei token del gateway di intelligenza artificiale | Token al minuto e quota totale di token per periodo, che un progetto può usare in una distribuzione del modello | Sì. Le richieste oltre il limite TPM restituiscono 429 e le richieste che superano la quota restituiscono 403. |
Project e distribuzione del modello | Tempo reale | Portale Foundry. Vedere Applicare i limiti dei token. |
| Criteri di Azure | Quali modelli e tipi di distribuzione possono distribuire gli utenti | Blocca i deployment, non le richieste | Configurazione delle risorse | Non applicabile | Portale di Azure. Vedere Criteri predefiniti per la distribuzione del modello. |
Usare questi controlli insieme. La quota protegge la capacità, i controlli dei costi controllano la spesa per progetti, agenti e modelli, i budget di Gestione costi di Azure avvisano sui costi per tutti i servizi Azure e i limiti del token del gateway di intelligenza artificiale limitano i token che ogni progetto può usare in una distribuzione del modello.
Usare i controlli dei costi con un gateway di intelligenza artificiale o Gestione API di Azure
Se le app chiamano Foundry tramite un gateway di intelligenza artificiale o Gestione API di Azure, i controlli dei costi vengono comunque applicati. Foundry li controlla dopo il gateway:
- Una richiesta deve superare i limiti del gateway e ogni controllo dei costi che la copre. Una richiesta rifiutata dal gateway non raggiunge mai Foundry, quindi non viene conteggiata per un controllo dei costi.
- I controlli dei costi conteggiano le richieste in base al progetto, alla distribuzione del modello, all'agente o alla sessione rilevata da Foundry. Le impostazioni che solo il gateway conosce, ad esempio l'app chiamante o l'utente, non influiscono sui controlli dei costi.
- Per trovare il livello che ha rifiutato una richiesta, controllare la risposta. Un blocco di controllo dei costi ha l'intestazione
x-ms-budget-cause: budget_exceeded. Un limite gateway per i token restituisce429per i token al minuto o403per una quota di token, senza tale intestazione. Quando un agente trasmette la risposta, un blocco di controllo dei costi arriva come evento di errore nel flusso. Per informazioni dettagliate, vedere Rispondere quando le richieste vengono bloccate.
Usare il gateway per i limiti dei token per app o per utente e i controlli dei costi per i budget di spesa per i progetti Foundry, le distribuzioni di modelli e gli agenti.
Contenuti correlati
- Per impostare il primo budget, vedere Creare e gestire i controlli dei costi (anteprima).
- Per visualizzare ogni funzionalità di costo in un'unica posizione, vedere Cost and FinOps in Microsoft Foundry.
- Per concedere agli utenti l'accesso ai controlli dei costi, vedere Autorizzazioni per i dati dei costi e i controlli dei costi.