Merge pull request #10544 from MicrosoftDocs/Antoine2F-patch-missingsymphonyupdate

AB#9490: Update AI Builder credits documentation

Author: haywoodsloan

support/power-platform/ai-builder/power-automate/all-ai-builder-credits-have-been-consumed.md

@@ -1,11 +1,9 @@
 ---
 title: All AI Builder credits have been consumed
 description: Provides a resolution for the issue that all AI Builder credits have been consumed in Microsoft Power Platform.
-ms.reviewer: chplanty, cdbellar
-ms.date: 09/18/2023
+ms.reviewer: antode, chplanty, cdbellar, v-shaywood
+ms.date: 01/19/2026
 ms.custom: sap:AI Builder\Administration and Licensing
-ms.author: antode
-author: Antoine2F
 ---
 # All AI Builder credits have been consumed
 
@@ -21,8 +19,7 @@ Here are the different symptoms of this issue:
 
 1. A banner shows the "Some environments have consumed all or almost all AI Builder credits" message on the **Capacity** page in the Power Platform admin center.
 1. A banner shows the "You've consumed all your AI Builder credits" message on the AI Builder page.
-1. Maker actions (Model creation, Model edit, and Quick test) are blocked on the AI Builder page.
-1. A flow stops with the "All AI Builder credits in this environment have been consumed" error.
+1. A flow stops and returns the error message "All AI Builder credits in this environment have been consumed" or "Missing Copilot Credit or AI Builder credit capacity".
 
    > [!NOTE]
    > This error is displayed in the **Error** panel on the flow run page.
@@ -33,28 +30,32 @@ Here are the different symptoms of this issue:
    - Code="QuotaExceeded"
    - Message="Credit usage exceeds allocation."
 
-1. In Power Apps, a banner shows the "You need an AI Builder license to use this component" message when you try to perform an AI Builder action.
+1. In Power Apps, a banner shows the message "You need an AI Builder license to use this component" or "Missing Copilot Credit or AI Builder credit capacity" when you try to perform an AI Builder action.
 
 ## Cause
 
-This issue occurs because AI Builder actions consume AI Builder credits. These credits come from tenant-level or environment-level allocations.
+This issue occurs because AI Builder actions consume AI Builder credits or Copilot Credits, depending on the context. These credits come from tenant-level or environment-level allocations.
 
-The environment's consumption is computed each day from the beginning of the month.  
+- _Power Apps_ or _Power Automate_: AI Builder actions consume AI Builder credits first. If those credits are exhausted or unavailable, the actions consume Copilot Credits instead.
+- _Microsoft Copilot Studio_ (agents and agent flows): AI Builder actions consume Copilot Credits only.
 
-- When the consumption is close to the allocated credits, a banner is displayed on the **Capacity** page in the Power Platform admin center, and a notification email is sent to the administrator.
-- When the consumption starts exceeding the tenant-level or environment-level credits ("simple overage"), a banner is displayed on the AI Builder page, and Maker actions are blocked. In "simple overage", AI Builder actions in flows and apps are still allowed and continue consuming credits.
-- When the consumption is much higher than the tenant-level or environment-level credits ("important overage"), AI Builder actions in flows and apps are blocked, and an error might occur in flows and apps.
+The environment's consumption is calculated regularly and resets at the beginning of the month.
+
+- When the calculated consumption is close to the allocated credits, a banner appears on the **Capacity** page in the Power Platform admin center, and a notification email is sent to the administrator.
+- When the calculated consumption exceeds the tenant-level or environment-level credits (125%), AI Builder actions in flows and apps are blocked, and an error message appears.
+
+Sometimes the environment's consumption calculation is delayed (up to five days). In this case, the system uses the last known calculated consumption. This delay can lead to significant consumption beyond your capacity before AI Builder actions are blocked or fall back to Copilot Credits. This overage isn't billed to you and doesn't affect other environments.
 
 ## Resolution
 
-To solve this issue, add more credits to your environment.
+To solve this issue, add more AI Builder credits or Copilot Credits to your environment.
 
 If credits come from the tenant level (unassigned credits), you need to add credits at the tenant level. This can be done by deallocating credits from other environments or by purchasing more.
 
 If credits come from the environment level, you need to allocate more credits to your environment. This can be done by using the existing tenant-level environment or by adding credits at the tenant level first (using purchase or environment deallocation).
 
 > [!NOTE]
-> If the **Allow users to consume unassigned credit** setting is disabled, the unassigned credits can't be used. You can go to the Power Platform admin center, select **Settings**, and then open the **AI Builder credit** page to enable this setting.
+> For AI Builder credits, if the **Allow users to consume unassigned credit** setting is disabled, the unassigned credits can't be used. You can go to the Power Platform admin center, select **Settings**, and then open the **AI Builder credit** page to enable this setting.
 
 #### How to determine the source and number of allocated, unassigned, and owned credits
 
@@ -69,7 +70,7 @@ You need to be the administrator of your environment to perform these actions.
     1. On the right pane, select **Summary**.
     1. At the bottom of the pane, in the **Add-ons** section, the **AI Builder credits** indicates the total number of credits allocated to environments among the total of owned credits. The amount of tenant-level credits (unassigned credits) is the difference between these numbers.
 
-#### How to change the number of environment-allocated credits
+#### How to change the number of environment-allocated AI Builder credits
 
 You need to be the administrator of your environment to perform these actions.
 
@@ -81,7 +82,7 @@ You need to be the administrator of your environment to perform these actions.
 1. In the right-side panel, select your environment.
 1. Modify the number of AI Builder credits. If the remaining credits aren't enough, you can deallocate credits from other environments or purchase more.
 
-#### How to change the number of tenant-level credits (unassigned credits) by deallocating credits from environments
+#### How to change the number of tenant-level AI Builder credits (unassigned credits) by deallocating credits from environments
 
 You need to be the administrator of your environment to perform these actions.
 
@@ -96,21 +97,24 @@ You need to be the administrator of your environment to perform these actions.
 > [!NOTE]
 > If the **Allow users to consume unassigned credit** setting is disabled, the unassigned credits can't be used. You can go to the Power Platform admin center, select **Settings**, and then open the **AI Builder credit** page to enable this setting.
 
-#### How to change the number of tenant-level credits (unassigned credits) by purchasing more AI Builder credits
+#### How to change the number of tenant-level AI Builder credits (unassigned credits) by purchasing more AI Builder credits
 
-You need to be the billing administrator of your tenant to perform these actions.
+> [!IMPORTANT]
+> AI Builder Capacity Add-ons are in "End of Sales" state. You can only purchase more if you already have active AI Builder Add-ons.
+
+You must be the billing administrator of your tenant to perform these steps.
 
 1. Sign in to the [Microsoft 365 admin center](https://admin.microsoft.com/).
 1. On the left pane, select **Billing** > **Purchase services**.
 1. Search for AI Builder.
 1. Select **AI Builder Capacity Add-on T1**, **AI Builder Capacity Add-on T2 (min 10 packs)**, or **AI Builder Capacity Add-on T3 (min 50 packs)**, depending on how many packs you need. Each pack provides 1 million AI Builder credits.
 1. Follow the purchase process.
-1. Once purchased, follow the steps in [How to change the number of environment-allocated credits](#how-to-change-the-number-of-environment-allocated-credits) if the credits come from the environment level.
+1. Once purchased, follow the steps in [How to change the number of environment-allocated AI Builder credits](#how-to-change-the-number-of-environment-allocated-ai-builder-credits) if the credits come from the environment level.
 
 > [!NOTE]
 > If the **Allow users to consume unassigned credit** setting is disabled, the unassigned credits can't be used. You can go to the Power Platform admin center, select **Settings**, and then open the **AI Builder credit** page to enable this setting.
 
-#### How to evaluate the amount of credits to add
+#### How to evaluate the amount of AI Builder credits to add
 
 You need to be the administrator of your environment to perform these actions.
 
@@ -124,20 +128,6 @@ You need to be the administrator of your environment to perform these actions.
 1. Open the .csv file in Excel. It contains the AI Builder credit consumption per day, user, and environment.
 1. By adding all your environment's consumption for the current month, you can evaluate how many credits this environment needs for the entire month.
 
-## AI Builder purchase takes time, and I urgently need to unblock my flow or app. What can I do?
-
-You can find the **Request extension** button to add 200,000 extension credits for the current month.
-
-- On the AI Builder page, you might find the **Request extension** button in the "You've consumed all your AI Builder credits" overage banner.
-- In the Power Platform admin center, you might find the **Request extension** button in the "Some environments have consumed all or almost all AI Builder credits" banner.
-
-> [!NOTE]
->
-> - These credits can't be allocated or assigned and can be used directly by any environment in overage.
-> - The number of extension requests per month and per year is limited.
-> - Each extension request sends a notification email to the Power Platform admin informing that extension credits have been requested and granted.
-> - If the **Allow users to consume unassigned credit** setting is disabled in the Power Platform admin center, the environment without assigned credits is blocked, and extension credits won't help. You can go to the Power Platform admin center, select **Settings**, and then open the **AI Builder credit** page to enable this setting.
-
 ## Resources
 
 For more information, see [AI Builder licensing](/ai-builder/administer-licensing).