Crea e gestisci i controlli di costo (anteprima)

I controlli dei costi consentono di impostare un budget di spesa o di token per una risorsa Foundry o un Project e di inviare avvisi o bloccare le richieste quando l'utilizzo si avvicina a tale budget. In questo articolo si creano, monitorano, modificano ed eliminano i controlli dei costi nel portale Microsoft Foundry e li si crea a livello di codice tramite l'API REST. Per informazioni su come i controlli dei costi conteggiano l'utilizzo e applicano i limiti, vedi Panoramica dei controlli dei costi.

Importante

I controlli dei costi di Foundry sono in anteprima pubblica e sono soggetti alle Condizioni supplementari per l'utilizzo delle 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.

Prerequisites

  • Una sottoscrizione Azure con una risorsa Foundry e almeno un Project che ha distribuito modelli o agenti.

  • Un ruolo che può creare controlli dei costi nell'ambito gestito:

    • Per i controlli dei costi di una risorsa Foundry: Proprietario dell'account Foundry o Proprietario foundry. Anche il proprietario e il collaboratore vanno bene.
    • Per i controlli dei costi di un Project: Foundry Account Owner, Foundry Owner o Foundry Project Manager. Anche il proprietario e il collaboratore vanno bene.

    Tutti i ruoli Foundry e Reader possono visualizzare i controlli dei costi. Per le autorizzazioni relative a questi ruoli, vedere Autorizzazioni per i dati sui costi e sui controlli dei costi.

  • Per visualizzare l'utilizzo in base a ogni budget, una risorsa di Application Insights per i controlli dei costi nella risorsa Foundry e l'accesso in lettura, ad esempio tramite lettore di monitoraggio o lettore Log Analytics. Selezionare la risorsa in Dati di utilizzo quando si crea un controllo costi. Gli avvisi e i blocchi funzionano senza di esso.

  • Per inviare avvisi, un argomento Griglia di eventi di Azure nella sottoscrizione che usa lo schema di input CloudEvents v1.0 e consente l'autenticazione basata su chiave. Per connettere un controllo dei costi al topic, è necessario il ruolo EventGrid Contributor nel topic. Per creare un topic, vedere Creare un topic personalizzato.

Importante

I ruoli RBAC 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.

Creare un controllo dei costi per una risorsa Foundry

Creare un controllo dei costi sulla risorsa Foundry quando un budget si estende su diversi progetti, distribuzioni di modelli, agenti o sessioni.

  1. Accedere a Microsoft Foundry. Assicurarsi che l'interruttore New Foundry sia attivato. Questi passaggi fanno riferimento a Foundry (nuovo).These steps refer to Foundry (new).

  2. Selezionare Gestisci nel riquadro di spostamento in alto a destra.

  3. Nel riquadro sinistro selezionare Costo e quindi selezionare la scheda Controllo costi .

  4. Seleziona Crea.

  5. In Che cosa si controlla?, immettere un nome di controllo Costo. Il nome identifica il controllo dei costi nell'URL e non è possibile modificarlo in un secondo momento. In Risorsa selezionare la risorsa Foundry proprietaria del controllo dei costi.

  6. Alla voce Che cosa si applica?, il controllo dei costi copre tutti gli utilizzi nella risorsa. Per restringerla, selezionare Aggiungi filtro. Selezionare quindi un tipo di filtro, Deployment, Project o Sessione e selezionarne i valori. Deployment elenca solo le distribuzioni dei modelli GPT e OpenAI serie o supportate dai controlli dei costi. È possibile usare ogni tipo di filtro una sola volta. Per Sessione immettere fino a 20 ID sessione dell'agente ospitato, separati da virgole.

    Per filtrare in base all'agente, aggiungere prima di tutto un filtro Project con un project. Quindi, aggiungi un filtro e seleziona Agent.

  7. In Come deve essere condiviso il budget?, selezionare Un budget per tutti gli elementi in modo che tutti i conteggi di utilizzo corrispondenti vengano conteggiati per un totale. In alternativa, selezionare Budget per e quindi scegliere Agente, Sessione o Project in modo che ognuno ottenga l'intero importo.

    Screenshot della pagina Crea controllo costi con il nome fraud-risk-monthly, un filtro Project impostato su rischio di frode e budget per agente selezionato.

  8. In Imposta il budget selezionare un tipo di budget:

    • Spesa: immettere un importo (USD), con un massimo di due cifre decimali.
    • Token: in Tipi di token da contare selezionare Tutti i tipi di token oppure selezionare Solo tipi specifici e quindi selezionare Input, Output o entrambi. Immettere un limite di token, facoltativamente usando le abbreviazioni K, M, B o T. Ad esempio, 10M è 10.000.000 token.
  9. In Reimpostazioni selezionare Giornaliero, Settimanale o Mensile. Il testo sotto il campo mostra quando l'utilizzo verrà reimpostato la prossima volta.

  10. Immettere una data di inizio e una data di fine nel fuso orario locale. Il testo sotto ogni data mostra l'ora UTC salvata da Foundry. La data di inizio deve essere oggi o in una data successiva. Il controllo dei costi interrompe il conteggio all'inizio della data di fine, quindi per includere un giorno, scegliere il giorno successivo come data di fine.

    Screenshot della sezione Impostare il budget con l'opzione Spend selezionata, un importo di 500 dollari USA, una reimpostazione mensile e le date di inizio e fine con gli equivalenti UTC.

  11. In Azioni soglia selezionare Aggiungi soglia e quindi selezionare un'azione:

    • Inviare un avviso invia una notifica tramite Griglia di eventi di Azure. Selezionare un topic di Griglia di eventi di Azure. Quando si esegue il salvataggio, Foundry crea una connessione condivisa al topic.
    • Blocca l'utilizzo blocca le nuove richieste interessate dal controllo dei costi quando l'utilizzo raggiunge la soglia.

    In Quando l'utilizzo raggiunge, seleziona il 50%, 75%, 80%, 90% o 100% del budget. Per immettere invece un importo, modificare Unità da % di budget all'unità del budget. È possibile aggiungere ogni azione una sola volta e un avviso deve essere pari o inferiore al blocco. Ad esempio, invia un avviso all'80% e blocca l'utilizzo al 100%. Se non si aggiungono azioni di soglia, il controllo dei costi tiene traccia dell'utilizzo senza avere alcun effetto sulle richieste.

    Tip

    Per ottenere avvisi a più di una soglia, ad esempio 50% e 75% prima di un blocco a 100%, creare un altro controllo dei costi con lo stesso budget e filtri e solo un'azione Invia avviso .

  12. In Dati di utilizzo, seleziona la risorsa di Application Insights che registra i dati di utilizzo per i controlli dei costi associati a questa risorsa di Foundry. Se ce n'è già uno collegato, la sezione lo mostra. È condiviso da ogni controllo dei costi sulla risorsa, quindi modificarlo influisce su tutti.

    Screenshot della sezione Azioni soglia con Invia avviso all'80% a un argomento di Griglia di eventi e Blocca l'utilizzo al 100% e la sezione Dati di utilizzo con una risorsa di Application Insights selezionata.

  13. Seleziona Crea.

Il controllo dei costi viene visualizzato nella scheda Controllo costi e diventa effettivo entro 15 minuti.

Creare un controllo dei costi per un progetto

Creare un controllo dei costi in un progetto quando il budget copre solo l'utilizzo del progetto.

  1. Accedere a Microsoft Foundry. Assicurarsi che l'interruttore New Foundry sia attivato. Questi passaggi fanno riferimento a Foundry (nuovo).These steps refer to Foundry (new).
  2. Selezionare Build nel riquadro di spostamento in alto a destra e quindi selezionare il Project dal selettore di Project nella parte superiore della pagina.
  3. Nel riquadro sinistro, selezionare Monitoraggio e quindi selezionare la scheda Controllo costi.
  4. Selezionare Crea per aprire il modulo.
  5. Immettere un nome di controllo Costo. L'ambito indica il Project. Il controllo dei costi copre l'utilizzo in questo Project e rimane nel Project.
  6. In A cosa si applica?, il controllo dei costi copre tutti gli utilizzi nel progetto. Per restringerla, selezionare Aggiungi filtro. Selezionare quindi un tipo di filtro, Deployment, Agente o Sessione e selezionarne i valori. Per quanto riguarda una risorsa, Deployment elenca solo i deployment di modelli GPT e OpenAI serie o supportati dai controlli dei costi.
  7. In Come deve essere condiviso il budget?, selezionare Un budget per tutti gli elementi oppure selezionare Budget per e quindi Agente o Sessione.
  8. Completare Impostare il budget e Azioni di soglia come per una risorsa.
  9. Controllare i dati di utilizzo. Mostra la risorsa di Application Insights per la risorsa Foundry. Per un Foundry Project Manager, è di sola lettura. Se non è configurato, chiedere a un amministratore della risorsa Foundry di configurarlo.
  10. Seleziona Crea. Il controllo dei costi viene visualizzato nella scheda Controllo costi del progetto e diventa effettivo entro 15 minuti.

È anche possibile iniziare dalla scheda Monitoraggio>costi. Quando il Project non dispone di budget, la scheda Budget del Project mostra Crea un controllo costi.

Creare controlli dei costi a livello di codice

I controlli dei costi sono Azure Resource Manager risorse, quindi è possibile crearli e gestirli con l'API REST, ad esempio da una pipeline di distribuzione. I controlli dei costi di una risorsa Foundry hanno il tipo Microsoft.CognitiveServices/accounts/costControlse i controlli dei costi di un progetto hanno il tipo Microsoft.CognitiveServices/accounts/projects/costControls. Sono necessari gli stessi ruoli del portale Foundry.

Inviare ogni richiesta con la versione 2026-11-15-previewdell'API . Le informazioni di riferimento sull'API REST e le librerie di gestione Azure SDK per Python, .NET, Java, JavaScript e Go coprono altre operazioni sulle risorse foundry. Non includono ancora i controlli dei costi per questa versione dell'API, quindi usare l'API REST come illustrato in questa sezione.

La tabella seguente mappa i campi nel portale Foundry al corpo della richiesta.

Portale di Foundry Corpo della richiesta Values
Nome del controllo dei costi Nome della risorsa alla fine dell'URL Da 1 a 63 lettere, numeri, trattini o caratteri di sottolineatura.
Tipo di budget category Cost per un budget di spesa in dollari statunitensi o Tokens. Non è possibile modificarlo dopo aver creato il controllo dei costi.
Importo (USD) o limite di token amount Un numero positivo. I limiti dei token sono numeri interi.
Ripristini timeGrain Daily, Weekly o Monthly.
Data di inizio e data di fine timePeriod.startDate e timePeriod.endDate Ore UTC nel formato ISO 8601 che terminano in Z, ad esempio 2026-12-01T00:00:00Z. Il controllo dei costi conta l'utilizzo dall'ora di inizio fino a poco prima dell'ora di fine. Usare un'ora di fine successiva all'ora corrente. L'API attualmente accetta un'ora di fine precedente nello stesso giorno, che salva un controllo dei costi già terminato.
Filters filter Una condizione additionalInfo con un name, il operatorIn e un elenco di values. I nomi sono project, deployment, agentsessionId, e per un Tokens budget, tokenType, i cui valori sono input o output. I valori sono nomi, ad esempio un progetto o un nome di distribuzione, non gli ID risorsa. Per filtrare in base all'agente, aggiungere anche un project filtro con esattamente un progetto. Per combinare le condizioni, elencarle in un array and e usare ogni nome una sola volta.
Budget per grouping Una voce con typeAdditionalInfoKey e nameagent, sessionIdo project. Omettilo per Un unico budget per tutto. Solo i controlli dei costi di una risorsa Foundry possono usare project.
Invia avviso notifications Una voce denominata con enabled (GreaterThanOrEqualTo o operator), true, eventGridConnectionIdthreshold, Absolute impostato su Percentage e thresholdType. Una soglia percentuale può essere fino a 100 e una soglia assoluta fino a amount.
Utilizzo del blocco providerProperties.actions Una voce denominata con typeBlock, thresholdType, threshold e operatorGreaterThanOrEqualTo. La soglia segue le stesse regole di un avviso.

Un avviso richiede l'ID risorsa di una connessione Foundry all'argomento griglia di eventi, nel formato /subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.CognitiveServices/accounts/<foundry-resource>/connections/<connection-name>. Foundry crea questa connessione nella risorsa Foundry quando si salva un controllo costi con una soglia Invia avviso nel portale Foundry. Per riutilizzarla, inviare una GET richiesta per il controllo dei costi e copiare dalla eventGridConnectionId notifica.

Nell'esempio seguente viene creato un controllo dei costi denominato fraud-risk-monthly: un budget mensile di 500 dollari usa per ogni agente nel fraud-risk progetto, dal 1° dicembre 2026 al 30 giugno 2027, con un avviso a 80% e un blocco a 100%. Salvare il corpo della richiesta come fraud-risk-monthly.json:

{
  "properties": {
    "category": "Cost",
    "amount": 500,
    "timeGrain": "Monthly",
    "timePeriod": {
      "startDate": "2026-12-01T00:00:00Z",
      "endDate": "2027-07-01T00:00:00Z"
    },
    "filter": {
      "additionalInfo": {
        "name": "project",
        "operator": "In",
        "values": ["fraud-risk"]
      }
    },
    "grouping": [
      { "name": "agent", "type": "AdditionalInfoKey" }
    ],
    "notifications": {
      "Actual_GreaterThanOrEqualTo_80_Percent": {
        "enabled": true,
        "operator": "GreaterThanOrEqualTo",
        "threshold": 80,
        "thresholdType": "Percentage",
        "eventGridConnectionId": "<event-grid-connection-id>"
      }
    },
    "providerProperties": {
      "actions": {
        "Block_GreaterThanOrEqualTo_100_Percent": {
          "type": "Block",
          "operator": "GreaterThanOrEqualTo",
          "threshold": 100,
          "thresholdType": "Percentage"
        }
      }
    }
  }
}

Inviarlo quindi con il interfaccia della riga di comando di Azure:

az rest --method put \
  --url "https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.CognitiveServices/accounts/<foundry-resource>/costControls/fraud-risk-monthly?api-version=2026-11-15-preview" \
  --body @fraud-risk-monthly.json

PUT sostituisce un controllo dei costi con lo stesso nome. Per creare il controllo dei costi solo se non esiste ancora, aggiungere --headers "If-None-Match=*".

Per il controllo dei costi di un progetto, aggiungere /projects/<project> prima /costControls nell'URL. Il controllo dei costi di un progetto copre solo quel progetto, quindi omettere il raggruppamento project. Per filtrarlo in base all'agente, aggiungere comunque un project filtro con tale progetto.

Creare controlli di costo uno alla volta. In questa anteprima, quando le richieste che creano controlli di costo sulla stessa risorsa Foundry si sovrappongono, alcune di esse possono avere esito negativo con codice 409 di stato HTTP e il codice RequestConflictdi errore . Ripetere le richieste non riuscite una alla volta. I modelli ARM e i file Bicep creano risorse in parallelo, quindi distribuisci diversi controlli dei costi in sequenza. Ad esempio, in Bicep aggiungere @batchSize(1) a un ciclo che crea controlli dei costi.

Per gestire i controlli dei costi dopo averli creati:

  • Elencare i controlli dei costi di una risorsa o di un progetto Foundry: inviare una GET richiesta all'URL costControls senza un nome.
  • Modificare un controllo dei costi: inviare di nuovo la definizione completa con PUTo inviare solo le proprietà che cambiano con PATCH.
  • Eliminare un controllo costo: inviare una DELETE richiesta al relativo URL.

I controlli dei costi creati con l'API vengono visualizzati nel portale di Foundry e diventano effettivi entro 15 minuti, come i controlli dei costi creati nel portale.

Monitora i controlli dei costi

La scheda Controllo costi in Gestisci>costi e quella nella pagina Monitoraggio di un progetto elenca i controlli dei costi con le colonne seguenti. In Gestisci>costi selezionare la sottoscrizione e la risorsa per visualizzare i controlli dei costi di una risorsa Foundry. Nella scheda di un progetto sono elencati anche i controlli dei costi della risorsa Foundry che si applicano al progetto, contrassegnati con un badge. È possibile visualizzarli lì, ma puoi modificarli in Gestisci>costi.

Column Cosa mostra
Nome criterio/policy Nome del controllo dei costi.
Si applica a L'utilizzo coperto dal controllo dei costi, ad esempio la risorsa o i progetti, gli agenti, le distribuzioni o le sessioni nei relativi filtri.
Budget Importo e periodo di reimpostazione e modalità di condivisione del budget, ad esempio Un totale o Per agente.
Risorsa La risorsa Foundry che possiede il controllo dei costi. Visualizzato in Gestisci>Costi.
Data di inizio e data di fine Quando inizia e termina il controllo dei costi.
Vicino al limite (stimato) Utilizzo stimato rispetto al budget. Per un budget per agente, sessione o progetto, viene visualizzato quello più vicino al limite.
Stato Ad esempio, In regola o Limite raggiunto. Per ogni stato, vedi Stati del controllo dei costi.

Per visualizzare le impostazioni di un controllo costi e il relativo utilizzo nel periodo corrente, selezionarne il nome. Il riquadro dei dettagli mostra l'ambito, il budget e il periodo, quando si reimposta e ciascuna azione associata alla soglia, ad esempio 100% · Blocca. L'utilizzo potrebbe impiegare circa 15 minuti prima di mostrare le richieste più recenti.

Per visualizzare i controlli dei costi che richiedono attenzione in una sottoscrizione, passare a Gestisci>panoramicadei costi>. La scheda Controlli costi mostra quanti richiedono attenzione, controllando ogni budget nel periodo di reimpostazione corrente. Selezionare Visualizza controlli dei costi per aprire l'elenco.

Gli sviluppatori possono verificare il limite applicabile al proprio progetto nella scheda Monitor>Costi. Per maggiori dettagli, vedere Controllare i limiti applicabili al proprio progetto.

Ricevi avvisi

Un'azione Invia avviso pubblica un evento nel topic di Griglia di eventi di Azure selezionato quando l'utilizzo raggiunge la soglia. Per notificare le persone o avviare un'automazione, crea una sottoscrizione di eventi sul topic. Ad esempio, instradare gli eventi a un flusso di lavoro App per la logica di Azure che invia messaggi di posta elettronica, a Funzioni di Azure o a un webhook. Per la procedura, vedere Sottoscrivere eventi tramite il portale di Azure.

Foundry pubblica gli eventi di avviso nello schema CloudEvents v1.0, con il tipo di evento costControl.alert. Per inoltrare solo gli avvisi di controllo dei costi, filtra la sottoscrizione di eventi in base a quel tipo. Ecco un evento di esempio per il fraud-risk-monthly controllo dei costi nell’esempio riportato sopra, ossia un budget di spesa per ciascun agente:

{
    "specversion": "1.0",
    "type": "costControl.alert",
    "source": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg-contoso/providers/Microsoft.CognitiveServices/accounts/contoso-foundry",
    "id": "5d0c9a3e7b14f2a86c3e91d04b7a5f2e8c61d39a0b4e7f25c8d1a6e39b0f4c72",
    "time": "2026-12-20T17:42:10.1234567+00:00",
    "subject": "Cost control warning",
    "data": {
        "unit": "usd",
        "threshold": "80.0%",
        "action": "alert",
        "severity": "warning",
        "windowEnd": "2027-01-01T00:00:00.0000000+00:00",
        "costBasis": "estimate",
        "inputTokens": 1850,
        "outputTokens": 420,
        "cachedTokens": 0,
        "reasoningTokens": 0,
        "projectName": "fraud-risk",
        "model": "gpt-5.4-mini",
        "deploymentName": "gpt-5.4-mini",
        "deploymentType": "GlobalStandard",
        "region": "eastus2",
        "agentName": "fraud-case-review",
        "agentVersion": "3",
        "startDate": "2026-12-01T00:00:00.0000000+00:00",
        "endDate": "2027-07-01T00:00:00.0000000+00:00",
        "callCost": 0.0021,
        "totalConsumed": 400.12,
        "limit": 500,
        "remaining": 99.88
    }
}
Field Che cosa contiene
source ID risorsa della risorsa Foundry proprietaria del controllo dei costi.
data.projectName, data.agentName, data.modeldata.deploymentName Il progetto, l'agente e la distribuzione della richiesta che ha attivato l'evento. I campi che non si applicano alla richiesta vengono lasciati fuori.
data.unit usd per un budget di spesa o tokens per un budget di token.
data.threshold Soglia raggiunta dall'utilizzo.
data.costBasis estimate per un budget di spesa, che Foundry fattura come descritto in Come i controlli dei costi determinano il prezzo dell'utilizzo, o usage per un budget di token.
data.totalConsumed, data.limit, data.remaining L'utilizzo è stato conteggiato finora nel periodo corrente, il budget e ciò che rimane. Per un budget di token, questi valori sono stringhe e data.tokensConsumed sostituisce data.callCost.
data.callCost e il conteggio dei token Costo e token della richiesta che ha attivato l'evento.
data.startDate, data.endDate Date di inizio e fine del controllo dei costi, in formato UTC, quando sono presenti.
data.windowEnd Quando il periodo corrente termina e viene reimpostato l'utilizzo, in formato UTC.

L'evento non include il nome del controllo costi. Per indicare i controlli dei costi sulla stessa risorsa Foundry, confrontare data.unit, data.limite data.startDateo inviare gli avvisi di ogni controllo dei costi al proprio argomento.

Mentre l'utilizzo è superiore o superiore a una soglia, Foundry invia un evento di avviso per ogni richiesta che conta per il controllo dei costi, in modo che una soglia possa inviare molti eventi. Se l'automazione invia notifiche, inviarne una per ogni soglia e periodo. Ad esempio, mantenere il primo evento per ogni source, data.limit, data.threshold e data.windowEnd, e anche data.agentName o data.projectName per un budget per agente o progetto.

Modificare o eliminare un controllo dei costi

  1. Passare alla scheda Controllo costi in cui è stato creato il controllo costi: Gestisci>costo per una risorsa o Monitora nel progetto.
  2. Selezionare il nome del controllo dei costi. Viene visualizzato un riquadro dei dettagli con ambito, dettagli, ad esempio il budget, il periodo e le soglie, e il relativo utilizzo in questo periodo.
  3. Selezionare Modifica o Elimina.
  4. Per modificare, cambia l'importo, reimposta il periodo, le date, gli elementi a cui si applica o le azioni di soglia e quindi salva le modifiche.

Le modifiche diventano effettive entro 15 minuti. Se si modifica il modo in cui il budget è condiviso o il periodo di azzeramento, l'utilizzo ricomincia a essere conteggiato da zero. Nel portale di Foundry non è possibile modificare il tipo di budget o i tipi di token dopo aver creato un controllo costi. Per misurare qualcosa di diverso, creare un nuovo controllo dei costi ed eliminare quello precedente. Quando si elimina un controllo costi, gli avvisi e i blocchi vengono interrotti.

Prima di eliminare un progetto, eliminare i controlli dei costi del progetto. In questa anteprima non è possibile eliminare un progetto con controlli dei costi: la richiesta ha esito negativo con il codice 409 di stato HTTP e il codice CostControlInUsedi errore . L'eliminazione del gruppo di risorse del progetto non viene completata finché non elimini i controlli dei costi. I controlli dei costi della risorsa Foundry non impediscono l'eliminazione di un progetto.

Rispondere quando le richieste vengono bloccate

Quando un controllo dei costi blocca l'utilizzo, le nuove richieste che vengono conteggiate ai fini di tale controllo non riescono con il codice di stato HTTP 429 e l'intestazione x-ms-budget-cause: budget_exceeded. Il messaggio di errore inizia con "Budget superato per il controllo dei costi". Ad esempio, una richiesta chat completions o responses bloccata restituisce questo errore:

{
    "error": {
        "message": "Budget exceeded for cost control.",
        "type": "too_many_requests",
        "param": null,
        "code": "budget_exceeded"
    }
}

Il codice di errore e altri campi dipendono dall'API chiamata. Alcune API, ad esempio gli agenti, possono restituire lo stesso codice di errore restituito da un rate limit. La risposta include anche queste intestazioni:

Header Value
x-ms-budget-cause budget_exceeded. Solo i blocchi di controllo dei costi hanno questa intestazione.
x-ms-applicable-policy-id ID risorsa del controllo dei costi che ha bloccato la richiesta.
x-ms-budget-window-reset Quando il budget viene reimpostato, in formato UTC.
x-ms-cost-control-type Cost per un budget di spesa o Tokens per un budget di token.

Una richiesta di completamento della chat bloccata include attualmente anche l'intestazione Retry-After: 30. Non significa che il budget consenta nuovamente l'utilizzo. Le librerie client che ritentano automaticamente le risposte 429 continuano comunque a ritentare una richiesta bloccata. Ad esempio, con le impostazioni predefinite, openAI Python libreria ritenta due volte e attende Retry-After, quindi una richiesta di completamento della chat bloccata richiede circa un minuto per avere esito negativo. Non fare affidamento sui tentativi automatici per i blocchi di controllo dei costi: disattivarli per queste chiamate, come avviene nell'esempio seguente e riprovare nel proprio codice solo per altre 429 risposte.

Alcune risposte potrebbero denominare l'intestazione x-ms-applied-cost-control-id ID anziché x-ms-applicable-policy-id. Se l'app legge l'ID del controllo dei costi, verificare la presenza di entrambi i nomi.

Richiede che il controllo dei costi non copre l'esecuzione. Quando un agente trasmette in streaming la risposta, il codice di stato HTTP è 200 e il blocco arriva come evento di errore nel flusso, con un messaggio che inizia con "Budget superato per il controllo dei costi".

Una risposta 429 può anche derivare da limiti di quota o di frequenza e riprovare con backoff è utile in questi casi. Un blocco di controllo dei costi non viene cancellato fino a quando il budget non consente di nuovo l'utilizzo. Quindi nell'app verificare la presenza dell'intestazione x-ms-budget-cause prima di riprovare. Ad esempio, con la libreria di Python OpenAI, dove client è un client per l'endpoint Foundry, disattivare i tentativi automatici con max_retries=0:

import openai

try:
    response = client.with_options(max_retries=0).responses.create(
        model="gpt-5.4-mini", input="Summarize the case notes."
    )
except openai.RateLimitError as e:
    if e.response.headers.get("x-ms-budget-cause") == "budget_exceeded":
        # A cost control blocked the request. Don't retry until the budget resets.
        reset_time = e.response.headers.get("x-ms-budget-window-reset")
        print(f"Blocked by a cost control until {reset_time}: {e.message}")
    else:
        raise  # Quota or rate limit: retry with backoff.

Per i limiti di quota e velocità, vedere Gestire le quote.

Per ripristinare l'accesso, eseguire una delle operazioni seguenti:

  • Aumentare il budget o la soglia dell'azione Blocca utilizzo .
  • Attendere il prossimo reset.
  • Modifica ciò a cui si applica il controllo dei costi.
  • Eliminare il controllo dei costi.

Risoluzione dei problemi dei controlli dei costi

Sintomo Cause Resolution
L'utilizzo rispetto al budget mostra Utilizzo non disponibile o Application Insights non è connesso. Non è configurata alcuna risorsa di Application Insights per i controlli dei costi nella risorsa Foundry. Selezionare Connetti oppure chiedere a un amministratore della risorsa Foundry di selezionare una risorsa di Application Insights in Dati di utilizzo.
L'utilizzo mostra Autorizzazione necessaria. Non è possibile leggere i dati di utilizzo nella risorsa di Application Insights. Chiedere a un amministratore l'accesso in lettura a tale risorsa di Application Insights, ad esempio Lettore di monitoraggio o Lettore di Log Analytics.
Il campo dell'argomento Griglia di eventi di Azure mostra "Schema di input non supportato Griglia di eventi di Azure". Il topic usa uno schema di input non supportato dai controlli dei costi. Selezionare o creare un argomento che usa lo schema di input CloudEvents v1.0.
Non è possibile selezionare Agent come filtro per il controllo dei costi di una risorsa Foundry. I filtri dell'agente necessitano di un filtro Project con esattamente un project. Aggiungere prima un filtro Project con un solo Project. Per coprire gli agenti in diversi Project, creare un controllo dei costi per ogni Project.
Le richieste hanno ancora esito positivo dopo aver salvato un'azione Blocca utilizzo . Le modifiche richiedono fino a 15 minuti e la richiesta che supera la soglia viene completata. Quando un agente trasmette la risposta, il blocco arriva come evento di errore nel flusso, con codice 200di stato HTTP . Attendere 15 minuti, controllare le risposte inviate in streaming per un errore "Budget exceeded for cost control" (Superato il budget per il controllo dei costi) e verificare che il controllo dei costi si applichi agli agenti, ai modelli o ai progetti che inviano le richieste.
Le richieste hanno esito negativo con 429, ma nessun controllo dei costi è vicino al limite. La distribuzione ha raggiunto la quota o il limite di frequenza. Verificare la presenza dell'intestazione x-ms-budget-cause . Solo i blocchi di controllo dei costi lo hanno. Il codice di errore da solo non può distinguere un blocco da un limite di frequenza. Per la quota, vedere Gestire le quote.
La spesa di un controllo dei costi non corrisponde al costo nel portale foundry. Durante l'anteprima pubblica, i controlli dei costi calcolano il prezzo dell'utilizzo in base a un'istantanea dei prezzi negoziati e non vengono riconciliati con la fattura. Le pagine dei costi mostrano i dati di Gestione costi di Azure da 8 a 24 ore dopo l'utilizzo. Non è necessaria alcuna correzione. Per informazioni dettagliate, vedere Come i controlli dei costi influenzano l'utilizzo del prezzo.
Il salvataggio di un'azione Invia avviso non riesce oppure non è possibile selezionare il topic. Non si ha il ruolo Collaboratore Griglia di eventi nell'argomento o l'argomento non consente l'autenticazione basata su chiave. Richiedere il collaboratore EventGrid nell'argomento e consentire l'autenticazione basata su chiave.
Gli avvisi non arrivano e l'argomento griglia di eventi non mostra eventi pubblicati. L'avviso del controllo costi usa una connessione di Griglia di eventi che non può essere usata dagli avvisi, ad esempio una AzureEventGrid connessione creata manualmente. Gli avvisi lo ignorano senza generare errori. Usa la connessione che Foundry crea quando selezioni l'argomento in Invia avviso nel portale Foundry. Con l'API REST, usare l'eventGridConnectionId di un controllo dei costi creato nel portale.
Non è possibile visualizzare la scheda Controllo costi oppure non è possibile creare controlli costi. Non si ha il ruolo richiesto. Vedere Prerequisiti e Autorizzazioni per i dati dei costi e i controlli dei costi.
Create rimane non disponibile dopo aver compilato il modulo. Un campo obbligatorio è vuoto o non valido e il relativo messaggio potrebbe essere fuori dalla visualizzazione. Le cause comuni sono una data di fine vuota, un filtro senza un valore e una soglia Invia avviso senza un topic. Scorrere ogni sezione per un messaggio. Immettere una data di fine, rimuovere filtri vuoti e selezionare un argomento che usa lo schema di input CloudEvents v1.0 o rimuovere la soglia Invia avviso .
Una distribuzione del modello non è presente nell'elenco Distribuzione . L'elenco mostra solo le distribuzioni dei modelli GPT e della serie o di OpenAI supportate dai controlli dei costi. I modelli di altri provider, ad esempio Claude, e alcuni modelli GPT appena rilasciati non sono elencati. Per limitare tali distribuzioni, usare limiti di quota o limiti di token di AI gateway. Per informazioni su ciò che è supportato, vedere Che cosa è supportato in questa anteprima.
Le richieste a un deployment non vengono conteggiate o bloccate. Il controllo dei costi non è ancora attivo per tali richieste. Le modifiche richiedono fino a 15 minuti e un modello che non ha ancora un prezzo in tale area, ad esempio un modello appena rilasciato, non viene conteggiato. Attendere 15 minuti. Controllare quindi una risposta con esito positivo: le richieste coperte da un controllo dei costi includono intestazioni come x-ms-budget-state e x-ms-applicable-policy-id. Se mancano o se x-ms-available-pre-call-budget non scende per un budget di spesa , il modello potrebbe non avere ancora un prezzo in tale area. Usare un budget di Token, una quota o i limiti dei token del gateway di intelligenza artificiale per questo fino a quando non lo fa.
Le richieste vengono ancora bloccate dopo l'aumento del budget. Le modifiche richiedono fino a 15 minuti. Un altro controllo dei costi potrebbe anche coprire le richieste, ad esempio una nella risorsa Foundry applicabile al progetto. Attendere 15 minuti. Controllare quindi la scheda Controllo costi del progetto, che elenca anche i controlli dei costi della risorsa Foundry che si applicano al progetto e l'intestazione x-ms-budget-cause della risposta bloccata.
Il controllo dei costi di un progetto non blocca le richieste di completamento della chat oppure viene raggiunto il limite prima che il progetto utilizzi tale quantità. Problemi noti in questa anteprima: i controlli dei costi di un progetto contano le richieste di completamento della chat al progetto, ma non le controllano. Le richieste all'endpoint della risorsa Foundry, ad esempio https://<foundry-resource>.openai.azure.com, vengono conteggiate anche per i controlli dei costi del progetto predefinito della risorsa, ma tali controlli costi non li controllano. Per bloccare queste richieste, usare un controllo dei costi nella risorsa Foundry, ad esempio con un filtro Deployment. Si prevede che i controlli dei costi del progetto predefinito includano l'utilizzo derivante dalle richieste all'endpoint della risorsa.
La creazione di diversi controlli di costo ha esito negativo con 409 e il codice di errore RequestConflict, ad esempio in un modello di Resource Manager o distribuzione Bicep. Le richieste che creano controlli dei costi sulla stessa risorsa Foundry si sono sovrapposte. Creare controlli di costo uno alla volta. In Bicep aggiungere @batchSize(1) a un ciclo che crea controlli dei costi. Eseguire di nuovo la distribuzione o ripetere le richieste non riuscite.
L'eliminazione di un progetto ha esito negativo con 409 e il codice di errore CostControlInUse, oppure l'eliminazione del relativo gruppo di risorse non termina. Il progetto ha controlli di costo propri. Eliminare i controlli dei costi del progetto nella scheda Controllo costi o con l'API REST e quindi eliminare il progetto. L'eliminazione di un gruppo di risorse in corso continua dopo averlo eliminato.