Update AI Builder credits documentation

Updated the document to reflect changes in AI Builder credit consumption, including the addition of Copilot Credits and adjustments to error messages and resolutions.

Author: Antoine2F

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

@@ -2,7 +2,7 @@
 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.date: 01/19/2026
 ms.custom: sap:AI Builder\Administration and Licensing
 ms.author: antode
 author: Antoine2F
@@ -21,8 +21,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 with the "All AI Builder credits in this environment have been consumed" or "Missing Copilot Credit or AI Builder credit capacity" error.
 
    > [!NOTE]
    > This error is displayed in the **Error** panel on the flow run page.
@@ -33,28 +32,30 @@ 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 "You need an AI Builder license to use this component" or "Missing Copilot Credit or AI Builder credit capacity" message 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 and/or Copilot Credits, depending on the context. These credits come from tenant-level or environment-level allocations.
+In Power Apps or Power Automate context, AI Builder actions consume AI Builder credits first, then if exhausted or absent, they consume Copilot Credits. In Microsoft Copilot Studio context (agents, agent flows), AI Builder actions consume Copilot Credits only.
 
-The environment's consumption is computed each day from the beginning of the month.  
+The environment's consumption is computed regularly, and is reset at the beginning of the month.  
 
-- 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.
+- When the computed 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 computed consumption exceeds the tenant-level or environment-level credits (125%), AI Builder actions in flows and apps are blocked, and an error message is displayed in flows and apps.
+
+Sometimes environment's consumption can be computed with an important delay (like 5 days). In such case, the decision will be made based on the last known computed consumption. This can lead to important consumption beyon the capacity before AI Builder actions are blocked or fall back to Copilot Credits. Such overage isn't billed to the customer and doesn't impact 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,9 +97,9 @@ 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.
+As AI Builder Capacity Add-on are in 'End of Sales' state, that's only possible if you already have active AI Builder Add-ons. You need to be the billing administrator of your tenant to perform these actions.
 
 1. Sign in to the [Microsoft 365 admin center](https://admin.microsoft.com/).
 1. On the left pane, select **Billing** > **Purchase services**.
@@ -110,7 +111,7 @@ You need to be the billing administrator of your tenant 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 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 +125,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).