From 0f0fc73674b16a19b79ac1641099cee01ac0f69f Mon Sep 17 00:00:00 2001 From: Luana Dos Santos Date: Wed, 22 Jul 2026 18:42:04 -0300 Subject: [PATCH 01/23] docs: doc-drift review for exp-governance- topics (W-23547085) From 68d3a1954b0f9f27ca86288bfbf8f657afc983f8 Mon Sep 17 00:00:00 2001 From: Luana Dos Santos Date: Wed, 22 Jul 2026 18:56:38 -0300 Subject: [PATCH 02/23] W-23547085 docs: fix doc drift in exp-governance- topics - cost-token-usage: restructure around budgets/optimizations tabs, fix metric labels (Cost saved, Potential savings), correct time range options (remove 6H), fix filter description - create-strategy: fix button/step labels to sentence case, rename step to General Information, add Notifications step note for Controls, add Save as draft note, fix type names to singular - manage-strategies: add Draft to status filter, add Change to Draft action for Controls, clarify Reorder condition for Automated Policies - work-with-strategies: add Gateways to governed service types Co-Authored-By: Claude Sonnet 4.6 --- .../pages/exp-governance-create-strategy.adoc | 14 ++++--- .../exp-governance-manage-strategies.adoc | 5 ++- ...-governance-view-cost-and-token-usage.adoc | 39 +++++++++++-------- .../exp-governance-work-with-strategies.adoc | 2 +- 4 files changed, 36 insertions(+), 24 deletions(-) diff --git a/modules/ROOT/pages/exp-governance-create-strategy.adoc b/modules/ROOT/pages/exp-governance-create-strategy.adoc index 0bf56732c..a8237c756 100644 --- a/modules/ROOT/pages/exp-governance-create-strategy.adoc +++ b/modules/ROOT/pages/exp-governance-create-strategy.adoc @@ -22,15 +22,17 @@ Also decide whether you need validation-only monitoring or active runtime enforc == Open the Strategy Workflow . Log in and go to *Governance* > *Governance Strategies*. -. Select *Create Governance Strategy* to start the setup flow. +. Select *Create governance strategy* to start the setup flow. -The setup flow guides you through type, scope, rules or policies, and activation. +The setup flow guides you through these steps: *Strategy Type*, *Scope*, *What to Apply*, *Name & Description*, and *Review*. + +For Controls strategies, the flow also includes a *Notifications* step between *What to Apply* and *Name & Description*. This step does not appear for Automated Policy strategies. == Select Strategy Type Select from these types: -* *Controls* validate targeted services against control rules. Use controls to monitor compliance and, when supported, block noncompliant activity. +* *Control* validates targeted services against control rules. Use controls to monitor compliance and, when supported, block noncompliant activity. * *Automated Policy* enforces runtime policy requirements across targeted services. Select the type that matches your governance objective, then proceed. @@ -72,7 +74,7 @@ Depending on the strategy type, select the controls or policies the strategy enf Available options depend on your earlier selections and your organization's enabled products. -== Name and Describe the Strategy +== General Information Enter a clear *Strategy Name*, such as "PCI Compliance Rules". Add a *Description* that states what the strategy enforces and why. @@ -80,7 +82,9 @@ Enter a clear *Strategy Name*, such as "PCI Compliance Rules". Add a *Descriptio Review your selections: strategy type, scope, rules or policies, and general information. -Select *Create and Activate Strategy*. +Select *Create and activate strategy*. + +For Controls strategies, you can also select *Save as draft* to save the strategy without activating it. Strategies are active by default. To disable a strategy, go to *Governance Strategies*. diff --git a/modules/ROOT/pages/exp-governance-manage-strategies.adoc b/modules/ROOT/pages/exp-governance-manage-strategies.adoc index 129d17a36..d1a70c82d 100644 --- a/modules/ROOT/pages/exp-governance-manage-strategies.adoc +++ b/modules/ROOT/pages/exp-governance-manage-strategies.adoc @@ -12,15 +12,16 @@ Go to *Governance* > *Governance Strategies* to view all strategies. Check the n * View details: Open a strategy to review scope, rules or policies, and metadata. * Enable or disable: Pause a strategy without deleting it. * Edit configuration: Update scope, rules, name, or description, then save. -* Reorder strategies: Change strategy order when multiple strategies govern the same services. +* Reorder strategies: To change the order of Automated Policy strategies, set the type filter to *Automated Policies* and select *Reorder*. * Delete a strategy: Permanently remove a strategy that you no longer need. +* Change to draft: For Control strategies, select *Change to Draft* to move the strategy back to a draft state without deleting it. == Filter and Search Strategies Use the controls above the table to narrow the list: * Use the strategy type filter to select *All*, *Controls*, or *Automated Policies*. -* Use the status filter to select *Any Status*, *Active*, or *Disabled*. +* Use the status filter to select *Any Status*, *Active*, *Draft*, or *Disabled*. * Enter text in the search field to match strategy names. The page updates to show only matching strategies. diff --git a/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc b/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc index 4f807c7f7..0ac6d9910 100644 --- a/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc +++ b/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc @@ -36,33 +36,40 @@ include::partial$exp-navigation-labels.adoc[tag=ExpNavigationLabels] == Open Cost Management . Log in and go to *Governance* > *Cost Management*. -. Adjust the time range and filters for the services or period you want to analyze. +. Select a tab: ++ +-- +* The *budgets* tab (default): View total managed spend and budget breakdowns. +* The *optimizations* tab: Analyze MCP server token usage and optimization opportunities. +-- +. Adjust the time range and filters for the data you want to analyze. -== Usage Metrics +== Budgets Tab -The experience organizes token and activity data into summary cards and detail views: +The *budgets* tab shows financial summaries across your configured budgets: -* *Total Tokens*: Number of tokens processed in the selected time range -* *Saved Tokens (Est.)*: Estimated tokens saved by optimization policies -* *Tool Calls*: Number of tool or function calls in the selected time range +* *Total Managed Spend*: Total spend across all configured budgets. +* *By Provider*: Spend breakdown by LLM provider. +* *By Model Proxy Key*: Spend breakdown by model proxy client key. -Each card also shows how many instances contributed to the metric. +== Optimizations Tab -== Filter and Search +The *optimizations* tab shows token cost analysis for MCP server instances: -Use controls at the top of the page to narrow the view: +* *Cost saved*: Tokens saved on optimized instances. Treat this metric as directional, not exact. +* *Potential savings*: Estimated tokens that could be saved by applying unapplied optimization opportunities. -* Search for service or instance names. -* Use *Filters* to refine your search by service type, environment, or metadata. -* Select a time range to search, such as 1 hour (1H), 6 hours (6H), 24 hours (24H), 7 days (7D), or 30 days (30D). +Each card also shows how many instances contributed to the metric. -The counter updates to show the number of matching services. +== Filter and Search -== Saved Token Estimates +Use the controls at the top of the *optimizations* tab to narrow the view: -When optimization policies are active, the system estimates saved tokens compared to unoptimized traffic. +* Search for MCP instance names. +* Use *Filters* to refine the view by *Environment* or *Provider*. +* Select a time range: *1H* (1 hour), *24H* (24 hours), *7D* (7 days), or *30D* (30 days). The default is *30D*. -Treat this metric as directional, not exact. +The counter updates to show the number of matching instances. == Cost Data Use Cases diff --git a/modules/ROOT/pages/exp-governance-work-with-strategies.adoc b/modules/ROOT/pages/exp-governance-work-with-strategies.adoc index 382d8d1a0..4bee4f9ea 100644 --- a/modules/ROOT/pages/exp-governance-work-with-strategies.adoc +++ b/modules/ROOT/pages/exp-governance-work-with-strategies.adoc @@ -1,7 +1,7 @@ = Working with Governance Strategies :keywords: governance strategies, api governance, governance workflows, mulesoft governance, strategy management, anypoint platform -Use governance strategies to apply conformance rules and policies across agents, APIs and MCP servers. When your tenant includes *Governance* and your account has the required role, you can create, manage, and monitor these strategies to validate service design compliance, automate runtime enforcement, and maintain visibility as your portfolio grows. +Use governance strategies to apply conformance rules and policies across agents, APIs, Gateways, and MCP servers. When your tenant includes *Governance* and your account has the required role, you can create, manage, and monitor these strategies to validate service design compliance, automate runtime enforcement, and maintain visibility as your portfolio grows. == Before You Begin From d56928c7b5230a1e2b481607cae310bf1aeae587 Mon Sep 17 00:00:00 2001 From: Luana Dos Santos <84200607+luanamulesoft@users.noreply.github.com> Date: Wed, 22 Jul 2026 18:57:26 -0300 Subject: [PATCH 03/23] Update exp-governance-create-strategy.adoc --- modules/ROOT/pages/exp-governance-create-strategy.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/exp-governance-create-strategy.adoc b/modules/ROOT/pages/exp-governance-create-strategy.adoc index a8237c756..d5fc5110f 100644 --- a/modules/ROOT/pages/exp-governance-create-strategy.adoc +++ b/modules/ROOT/pages/exp-governance-create-strategy.adoc @@ -22,7 +22,7 @@ Also decide whether you need validation-only monitoring or active runtime enforc == Open the Strategy Workflow . Log in and go to *Governance* > *Governance Strategies*. -. Select *Create governance strategy* to start the setup flow. +. Select *Create Governance Strategy* to start the setup flow. The setup flow guides you through these steps: *Strategy Type*, *Scope*, *What to Apply*, *Name & Description*, and *Review*. From 51d83a719933bf5b9b876c6f2f24566ade844e50 Mon Sep 17 00:00:00 2001 From: Luana Dos Santos <84200607+luanamulesoft@users.noreply.github.com> Date: Wed, 22 Jul 2026 18:58:49 -0300 Subject: [PATCH 04/23] Update exp-governance-view-cost-and-token-usage.adoc --- .../ROOT/pages/exp-governance-view-cost-and-token-usage.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc b/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc index 0ac6d9910..b8d4ddfaa 100644 --- a/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc +++ b/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc @@ -46,7 +46,7 @@ include::partial$exp-navigation-labels.adoc[tag=ExpNavigationLabels] == Budgets Tab -The *budgets* tab shows financial summaries across your configured budgets: +The *Budgets* tab shows financial summaries across your configured budgets: * *Total Managed Spend*: Total spend across all configured budgets. * *By Provider*: Spend breakdown by LLM provider. @@ -54,7 +54,7 @@ The *budgets* tab shows financial summaries across your configured budgets: == Optimizations Tab -The *optimizations* tab shows token cost analysis for MCP server instances: +The *Optimizations* tab shows token cost analysis for MCP server instances: * *Cost saved*: Tokens saved on optimized instances. Treat this metric as directional, not exact. * *Potential savings*: Estimated tokens that could be saved by applying unapplied optimization opportunities. From 9f781fa8e074dc23e9e20ca14c0edccf976f15c7 Mon Sep 17 00:00:00 2001 From: Luana Dos Santos <84200607+luanamulesoft@users.noreply.github.com> Date: Wed, 22 Jul 2026 19:01:09 -0300 Subject: [PATCH 05/23] Update exp-governance-view-cost-and-token-usage.adoc --- .../ROOT/pages/exp-governance-view-cost-and-token-usage.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc b/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc index b8d4ddfaa..83deec44a 100644 --- a/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc +++ b/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc @@ -63,7 +63,7 @@ Each card also shows how many instances contributed to the metric. == Filter and Search -Use the controls at the top of the *optimizations* tab to narrow the view: +Use the controls at the top of the *Optimizations* tab to narrow the view: * Search for MCP instance names. * Use *Filters* to refine the view by *Environment* or *Provider*. From b24f192f314dead162a633a3ecdfd92b166367f6 Mon Sep 17 00:00:00 2001 From: Luana Dos Santos <84200607+luanamulesoft@users.noreply.github.com> Date: Thu, 23 Jul 2026 12:32:22 -0300 Subject: [PATCH 06/23] Update exp-governance-create-strategy.adoc --- modules/ROOT/pages/exp-governance-create-strategy.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/exp-governance-create-strategy.adoc b/modules/ROOT/pages/exp-governance-create-strategy.adoc index d5fc5110f..5928b1311 100644 --- a/modules/ROOT/pages/exp-governance-create-strategy.adoc +++ b/modules/ROOT/pages/exp-governance-create-strategy.adoc @@ -82,7 +82,7 @@ Enter a clear *Strategy Name*, such as "PCI Compliance Rules". Add a *Descriptio Review your selections: strategy type, scope, rules or policies, and general information. -Select *Create and activate strategy*. +Select *Create and Activate Strategy*. For Controls strategies, you can also select *Save as draft* to save the strategy without activating it. From 12a5f22fe65a925cc446af4043e45eb40b27256a Mon Sep 17 00:00:00 2001 From: Luana Dos Santos <84200607+luanamulesoft@users.noreply.github.com> Date: Thu, 23 Jul 2026 12:33:33 -0300 Subject: [PATCH 07/23] Update exp-governance-view-cost-and-token-usage.adoc --- .../ROOT/pages/exp-governance-view-cost-and-token-usage.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc b/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc index 83deec44a..bda586bb2 100644 --- a/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc +++ b/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc @@ -39,8 +39,8 @@ include::partial$exp-navigation-labels.adoc[tag=ExpNavigationLabels] . Select a tab: + -- -* The *budgets* tab (default): View total managed spend and budget breakdowns. -* The *optimizations* tab: Analyze MCP server token usage and optimization opportunities. +* The *Budgets* tab (default): View total managed spend and budget breakdowns. +* The *Optimizations* tab: Analyze MCP server token usage and optimization opportunities. -- . Adjust the time range and filters for the data you want to analyze. From 38cca813951073d21190b022a1119effd67c65aa Mon Sep 17 00:00:00 2001 From: Luana Dos Santos Date: Thu, 23 Jul 2026 13:23:34 -0300 Subject: [PATCH 08/23] add new budget flow --- ...-governance-view-cost-and-token-usage.adoc | 23 ++++++++++++++++++- 1 file changed, 22 insertions(+), 1 deletion(-) diff --git a/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc b/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc index bda586bb2..4589b5025 100644 --- a/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc +++ b/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc @@ -52,6 +52,26 @@ The *Budgets* tab shows financial summaries across your configured budgets: * *By Provider*: Spend breakdown by LLM provider. * *By Model Proxy Key*: Spend breakdown by model proxy client key. +=== Add a Budget + +. In the *budgets* tab, select *New budget*. +. In the *New budget* dialog, configure the budget: ++ +-- +* *Model proxy key* (required): Select the client key to scope the budget. +* *Provider* (optional): Select an LLM provider to narrow the budget to a specific provider. +* *Model* (optional): Select a model. This field appears only after you select a provider. +* *Period*: Select *Daily*, *Weekly*, or *Monthly*. +* *Resets on*: Select the reset day. This field appears for weekly and monthly periods. +* *Metric*: Select *Spend* to set a dollar limit, or *Tokens* to set a token count limit. +* *Spend limit (USD)* or *Token limit* (required): Enter the maximum allowed value. +-- +. Select *Create budget*. + +Once a budget limit is reached, requests are blocked. Each model proxy key, provider, and model combination can have only one budget. + +For information about model wallets and how they combine authentication credentials with budget limits, see xref:exp-model-wallets-manage.adoc[]. + == Optimizations Tab The *Optimizations* tab shows token cost analysis for MCP server instances: @@ -79,7 +99,7 @@ Cost and performance data inform multiple workflows: * Performance triage: Correlate latency or error spikes with deployments or policy changes. * Planning and alignment: Share trends with finance and platform teams for forecasting. -This dashboard doesn't automatically cap usage. To limit consumption, apply governance strategies or rate-limiting policies. +To automatically cap usage, configure budgets in the *budgets* tab or through model wallets. Budgets block requests once the limit is reached. You can also apply governance strategies or rate-limiting policies. == Cost Data and Governance @@ -89,6 +109,7 @@ For runtime enforcement, attach cost-related controls or policies to a governanc == See Also +* xref:exp-model-wallets-manage.adoc[] * xref:exp-governance-work-with-strategies.adoc[] * xref:exp-governance-create-strategy.adoc[] * xref:exp-governance-manage-strategies.adoc[] From 3e05e1b0a1a538abd34c0abb1e55c42c940c22c2 Mon Sep 17 00:00:00 2001 From: Luana Dos Santos <84200607+luanamulesoft@users.noreply.github.com> Date: Thu, 23 Jul 2026 14:12:22 -0300 Subject: [PATCH 09/23] Update exp-governance-create-strategy.adoc --- modules/ROOT/pages/exp-governance-create-strategy.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/exp-governance-create-strategy.adoc b/modules/ROOT/pages/exp-governance-create-strategy.adoc index 5928b1311..ecbf24451 100644 --- a/modules/ROOT/pages/exp-governance-create-strategy.adoc +++ b/modules/ROOT/pages/exp-governance-create-strategy.adoc @@ -26,7 +26,7 @@ Also decide whether you need validation-only monitoring or active runtime enforc The setup flow guides you through these steps: *Strategy Type*, *Scope*, *What to Apply*, *Name & Description*, and *Review*. -For Controls strategies, the flow also includes a *Notifications* step between *What to Apply* and *Name & Description*. This step does not appear for Automated Policy strategies. +For Controls strategies, the flow also includes a *Notifications* step between *What to Apply* and *Name & Description*. This step doesn't appear for Automated Policy strategies. == Select Strategy Type From a9af9ed86463ee32924ab683ab75fbca94f5dd52 Mon Sep 17 00:00:00 2001 From: Luana Dos Santos <84200607+luanamulesoft@users.noreply.github.com> Date: Thu, 23 Jul 2026 14:14:30 -0300 Subject: [PATCH 10/23] Update exp-governance-create-strategy.adoc --- modules/ROOT/pages/exp-governance-create-strategy.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/exp-governance-create-strategy.adoc b/modules/ROOT/pages/exp-governance-create-strategy.adoc index ecbf24451..e7af46050 100644 --- a/modules/ROOT/pages/exp-governance-create-strategy.adoc +++ b/modules/ROOT/pages/exp-governance-create-strategy.adoc @@ -84,7 +84,7 @@ Review your selections: strategy type, scope, rules or policies, and general inf Select *Create and Activate Strategy*. -For Controls strategies, you can also select *Save as draft* to save the strategy without activating it. +For Controls strategies, you can also select *Save as Draft* to save the strategy without activating it. Strategies are active by default. To disable a strategy, go to *Governance Strategies*. From 51211c72d1cac4185ebce64f14a590f78c2d3c5e Mon Sep 17 00:00:00 2001 From: Luana Dos Santos <84200607+luanamulesoft@users.noreply.github.com> Date: Thu, 23 Jul 2026 14:15:47 -0300 Subject: [PATCH 11/23] Update exp-governance-view-cost-and-token-usage.adoc --- .../ROOT/pages/exp-governance-view-cost-and-token-usage.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc b/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc index 4589b5025..eee1bbc5e 100644 --- a/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc +++ b/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc @@ -54,8 +54,8 @@ The *Budgets* tab shows financial summaries across your configured budgets: === Add a Budget -. In the *budgets* tab, select *New budget*. -. In the *New budget* dialog, configure the budget: +. In the *Budgets* tab, select *New budget*. +. In the *New Budget* dialog, configure the budget: + -- * *Model proxy key* (required): Select the client key to scope the budget. From 1c73086b2ad875b157885b621b00828aebfbfb4b Mon Sep 17 00:00:00 2001 From: Luana Dos Santos <84200607+luanamulesoft@users.noreply.github.com> Date: Thu, 23 Jul 2026 14:16:55 -0300 Subject: [PATCH 12/23] Update exp-governance-view-cost-and-token-usage.adoc --- .../ROOT/pages/exp-governance-view-cost-and-token-usage.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc b/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc index eee1bbc5e..ce76cb803 100644 --- a/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc +++ b/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc @@ -66,7 +66,7 @@ The *Budgets* tab shows financial summaries across your configured budgets: * *Metric*: Select *Spend* to set a dollar limit, or *Tokens* to set a token count limit. * *Spend limit (USD)* or *Token limit* (required): Enter the maximum allowed value. -- -. Select *Create budget*. +. Select *Create Budget*. Once a budget limit is reached, requests are blocked. Each model proxy key, provider, and model combination can have only one budget. From 2aa095d5da86448ac715ebabd44abd8543134b6d Mon Sep 17 00:00:00 2001 From: Luana Dos Santos <84200607+luanamulesoft@users.noreply.github.com> Date: Thu, 23 Jul 2026 14:19:38 -0300 Subject: [PATCH 13/23] Update exp-governance-view-cost-and-token-usage.adoc --- .../ROOT/pages/exp-governance-view-cost-and-token-usage.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc b/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc index ce76cb803..603ac6621 100644 --- a/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc +++ b/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc @@ -99,7 +99,7 @@ Cost and performance data inform multiple workflows: * Performance triage: Correlate latency or error spikes with deployments or policy changes. * Planning and alignment: Share trends with finance and platform teams for forecasting. -To automatically cap usage, configure budgets in the *budgets* tab or through model wallets. Budgets block requests once the limit is reached. You can also apply governance strategies or rate-limiting policies. +To automatically cap usage, configure budgets in the *Budgets* tab or through model wallets. Budgets block requests once the limit is reached. You can also apply governance strategies or rate-limiting policies. == Cost Data and Governance From 322720d76d5f46065311d1b72794f4ea2b916bfb Mon Sep 17 00:00:00 2001 From: Luana Dos Santos Date: Thu, 23 Jul 2026 14:35:30 -0300 Subject: [PATCH 14/23] style: apply preliminary style check fixes to governance topics Co-Authored-By: Claude Sonnet 4.6 --- modules/ROOT/pages/exp-governance-create-strategy.adoc | 2 +- .../pages/exp-governance-view-cost-and-token-usage.adoc | 6 +++--- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/modules/ROOT/pages/exp-governance-create-strategy.adoc b/modules/ROOT/pages/exp-governance-create-strategy.adoc index e7af46050..a1f3b6863 100644 --- a/modules/ROOT/pages/exp-governance-create-strategy.adoc +++ b/modules/ROOT/pages/exp-governance-create-strategy.adoc @@ -76,7 +76,7 @@ Available options depend on your earlier selections and your organization's enab == General Information -Enter a clear *Strategy Name*, such as "PCI Compliance Rules". Add a *Description* that states what the strategy enforces and why. +Enter a clear *Strategy Name*, such as "PCI Compliance Rules." Add a *Description* that states what the strategy enforces and why. == Review and Activate diff --git a/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc b/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc index 603ac6621..17687f202 100644 --- a/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc +++ b/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc @@ -55,7 +55,7 @@ The *Budgets* tab shows financial summaries across your configured budgets: === Add a Budget . In the *Budgets* tab, select *New budget*. -. In the *New Budget* dialog, configure the budget: +. In the *New budget* dialog, configure the budget: + -- * *Model proxy key* (required): Select the client key to scope the budget. @@ -66,7 +66,7 @@ The *Budgets* tab shows financial summaries across your configured budgets: * *Metric*: Select *Spend* to set a dollar limit, or *Tokens* to set a token count limit. * *Spend limit (USD)* or *Token limit* (required): Enter the maximum allowed value. -- -. Select *Create Budget*. +. Select *Create budget*. Once a budget limit is reached, requests are blocked. Each model proxy key, provider, and model combination can have only one budget. @@ -99,7 +99,7 @@ Cost and performance data inform multiple workflows: * Performance triage: Correlate latency or error spikes with deployments or policy changes. * Planning and alignment: Share trends with finance and platform teams for forecasting. -To automatically cap usage, configure budgets in the *Budgets* tab or through model wallets. Budgets block requests once the limit is reached. You can also apply governance strategies or rate-limiting policies. +To automatically cap usage, configure budgets in the *Budgets* tab or through model wallets. Budgets block requests once the limit is reached. To limit consumption in other ways, apply governance strategies or rate-limiting policies. == Cost Data and Governance From 13659dad13d5c3181cb280e272cc2abb5749b75d Mon Sep 17 00:00:00 2001 From: Luana Dos Santos <84200607+luanamulesoft@users.noreply.github.com> Date: Thu, 23 Jul 2026 14:41:53 -0300 Subject: [PATCH 15/23] Update exp-governance-view-cost-and-token-usage.adoc --- .../ROOT/pages/exp-governance-view-cost-and-token-usage.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc b/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc index 17687f202..64aa62912 100644 --- a/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc +++ b/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc @@ -54,8 +54,8 @@ The *Budgets* tab shows financial summaries across your configured budgets: === Add a Budget -. In the *Budgets* tab, select *New budget*. -. In the *New budget* dialog, configure the budget: +. In the *Budgets* tab, select *New Budget*. +. In the *New Budget* dialog, configure the budget: + -- * *Model proxy key* (required): Select the client key to scope the budget. From 9650f800530a32a2817643ea736cddcd1b8f68e2 Mon Sep 17 00:00:00 2001 From: Luana Dos Santos <84200607+luanamulesoft@users.noreply.github.com> Date: Thu, 23 Jul 2026 14:46:54 -0300 Subject: [PATCH 16/23] Update exp-governance-view-cost-and-token-usage.adoc --- .../ROOT/pages/exp-governance-view-cost-and-token-usage.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc b/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc index 64aa62912..93132fe62 100644 --- a/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc +++ b/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc @@ -62,9 +62,9 @@ The *Budgets* tab shows financial summaries across your configured budgets: * *Provider* (optional): Select an LLM provider to narrow the budget to a specific provider. * *Model* (optional): Select a model. This field appears only after you select a provider. * *Period*: Select *Daily*, *Weekly*, or *Monthly*. -* *Resets on*: Select the reset day. This field appears for weekly and monthly periods. +* *Resets on Day of Month*: Select the reset day. This field appears for weekly and monthly periods. * *Metric*: Select *Spend* to set a dollar limit, or *Tokens* to set a token count limit. -* *Spend limit (USD)* or *Token limit* (required): Enter the maximum allowed value. +* *Spend Limit (USD)* or *Token limit* (required): Enter the maximum allowed value. -- . Select *Create budget*. From 335ba4a14a7884798382be78bdfc21ea169663b1 Mon Sep 17 00:00:00 2001 From: Luana Dos Santos Date: Thu, 23 Jul 2026 14:49:59 -0300 Subject: [PATCH 17/23] update field --- .../ROOT/pages/exp-governance-view-cost-and-token-usage.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc b/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc index 93132fe62..d81607b55 100644 --- a/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc +++ b/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc @@ -58,7 +58,7 @@ The *Budgets* tab shows financial summaries across your configured budgets: . In the *New Budget* dialog, configure the budget: + -- -* *Model proxy key* (required): Select the client key to scope the budget. +* *Model wallet* (required): Select the model wallet to scope the budget. * *Provider* (optional): Select an LLM provider to narrow the budget to a specific provider. * *Model* (optional): Select a model. This field appears only after you select a provider. * *Period*: Select *Daily*, *Weekly*, or *Monthly*. From aace05e7acb95ce20d51096c9ec36720e94de992 Mon Sep 17 00:00:00 2001 From: Luana Dos Santos <84200607+luanamulesoft@users.noreply.github.com> Date: Thu, 23 Jul 2026 14:52:01 -0300 Subject: [PATCH 18/23] Update exp-governance-view-cost-and-token-usage.adoc --- .../ROOT/pages/exp-governance-view-cost-and-token-usage.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc b/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc index d81607b55..98bf3670b 100644 --- a/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc +++ b/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc @@ -58,7 +58,7 @@ The *Budgets* tab shows financial summaries across your configured budgets: . In the *New Budget* dialog, configure the budget: + -- -* *Model wallet* (required): Select the model wallet to scope the budget. +* *Model Wallet* (required): Select the model wallet to scope the budget. * *Provider* (optional): Select an LLM provider to narrow the budget to a specific provider. * *Model* (optional): Select a model. This field appears only after you select a provider. * *Period*: Select *Daily*, *Weekly*, or *Monthly*. @@ -66,7 +66,7 @@ The *Budgets* tab shows financial summaries across your configured budgets: * *Metric*: Select *Spend* to set a dollar limit, or *Tokens* to set a token count limit. * *Spend Limit (USD)* or *Token limit* (required): Enter the maximum allowed value. -- -. Select *Create budget*. +. Select *Create Budget*. Once a budget limit is reached, requests are blocked. Each model proxy key, provider, and model combination can have only one budget. From 626c0817eac1f92681a8cb5e1a98b67248ad692d Mon Sep 17 00:00:00 2001 From: Luana Dos Santos Date: Thu, 23 Jul 2026 14:53:45 -0300 Subject: [PATCH 19/23] style: rewrite passive voice in budget limit sentence Co-Authored-By: Claude Sonnet 4.6 --- .../ROOT/pages/exp-governance-view-cost-and-token-usage.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc b/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc index 98bf3670b..783a06d44 100644 --- a/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc +++ b/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc @@ -68,7 +68,7 @@ The *Budgets* tab shows financial summaries across your configured budgets: -- . Select *Create Budget*. -Once a budget limit is reached, requests are blocked. Each model proxy key, provider, and model combination can have only one budget. +When usage reaches the budget limit, the system blocks requests. Each model proxy key, provider, and model combination supports only one budget. For information about model wallets and how they combine authentication credentials with budget limits, see xref:exp-model-wallets-manage.adoc[]. From 46efccfae5422cda04da6bb3155adb48e7124009 Mon Sep 17 00:00:00 2001 From: Luana Dos Santos <84200607+luanamulesoft@users.noreply.github.com> Date: Thu, 23 Jul 2026 14:55:21 -0300 Subject: [PATCH 20/23] Update exp-governance-view-cost-and-token-usage.adoc --- .../ROOT/pages/exp-governance-view-cost-and-token-usage.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc b/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc index 783a06d44..52bd389ca 100644 --- a/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc +++ b/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc @@ -68,7 +68,7 @@ The *Budgets* tab shows financial summaries across your configured budgets: -- . Select *Create Budget*. -When usage reaches the budget limit, the system blocks requests. Each model proxy key, provider, and model combination supports only one budget. +When usage reaches the budget limit, the system blocks requests. Each model wallet, provider, and model combination supports only one budget. For information about model wallets and how they combine authentication credentials with budget limits, see xref:exp-model-wallets-manage.adoc[]. From e8ffe05fdb2ab4e3bd190e9670be39f4d0c9fcf3 Mon Sep 17 00:00:00 2001 From: Luana Dos Santos Date: Thu, 23 Jul 2026 15:05:00 -0300 Subject: [PATCH 21/23] fix: revise Optimizations tab section to match UI Co-Authored-By: Claude Sonnet 4.6 --- .../exp-governance-view-cost-and-token-usage.adoc | 15 ++++++++++----- 1 file changed, 10 insertions(+), 5 deletions(-) diff --git a/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc b/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc index 52bd389ca..f9c7168d8 100644 --- a/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc +++ b/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc @@ -74,18 +74,23 @@ For information about model wallets and how they combine authentication credenti == Optimizations Tab -The *Optimizations* tab shows token cost analysis for MCP server instances: +The *Optimizations* tab shows cost and token savings data across model proxies, agents, and MCP servers. -* *Cost saved*: Tokens saved on optimized instances. Treat this metric as directional, not exact. -* *Potential savings*: Estimated tokens that could be saved by applying unapplied optimization opportunities. +The summary cards show: -Each card also shows how many instances contributed to the metric. +* *Agents Potential Savings*: Estimated cost savings available by applying optimization policies to agents. Shows *Cost saved* as the amount already saved. +* *MCP Servers Potential Savings*: Estimated token savings available by applying optimization policies to MCP servers. Shows *Tokens saved* as tokens already saved. + +Treat these metrics as directional, not exact. + +The *Top optimization opportunities* section highlights the instances with the highest potential savings and the specific optimization policy to apply. == Filter and Search Use the controls at the top of the *Optimizations* tab to narrow the view: -* Search for MCP instance names. +* Select a sub-tab to filter by instance type: *Model Proxies*, *Agents*, or *MCP Servers*. +* Search for instance names. * Use *Filters* to refine the view by *Environment* or *Provider*. * Select a time range: *1H* (1 hour), *24H* (24 hours), *7D* (7 days), or *30D* (30 days). The default is *30D*. From bac250e498631132a428350a5bc54463c6322407 Mon Sep 17 00:00:00 2001 From: Luana Dos Santos <84200607+luanamulesoft@users.noreply.github.com> Date: Thu, 23 Jul 2026 15:09:56 -0300 Subject: [PATCH 22/23] Update exp-governance-view-cost-and-token-usage.adoc --- .../ROOT/pages/exp-governance-view-cost-and-token-usage.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc b/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc index f9c7168d8..5e9f13c85 100644 --- a/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc +++ b/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc @@ -78,8 +78,8 @@ The *Optimizations* tab shows cost and token savings data across model proxies, The summary cards show: -* *Agents Potential Savings*: Estimated cost savings available by applying optimization policies to agents. Shows *Cost saved* as the amount already saved. -* *MCP Servers Potential Savings*: Estimated token savings available by applying optimization policies to MCP servers. Shows *Tokens saved* as tokens already saved. +* *Agents Potential Savings*: Estimated cost savings available by applying optimization policies to agents. It shows *Cost Saved* as the amount already saved. +* *MCP Servers Potential Savings*: Estimated token savings available by applying optimization policies to MCP servers. It shows *Tokens Saved* as tokens already saved. Treat these metrics as directional, not exact. From a3007fc0461e70d635dc8d51dc9926cdb0c672f0 Mon Sep 17 00:00:00 2001 From: Luana Dos Santos <84200607+luanamulesoft@users.noreply.github.com> Date: Thu, 23 Jul 2026 15:34:35 -0300 Subject: [PATCH 23/23] Update exp-governance-view-cost-and-token-usage.adoc --- .../ROOT/pages/exp-governance-view-cost-and-token-usage.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc b/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc index 5e9f13c85..ddb925587 100644 --- a/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc +++ b/modules/ROOT/pages/exp-governance-view-cost-and-token-usage.adoc @@ -64,7 +64,7 @@ The *Budgets* tab shows financial summaries across your configured budgets: * *Period*: Select *Daily*, *Weekly*, or *Monthly*. * *Resets on Day of Month*: Select the reset day. This field appears for weekly and monthly periods. * *Metric*: Select *Spend* to set a dollar limit, or *Tokens* to set a token count limit. -* *Spend Limit (USD)* or *Token limit* (required): Enter the maximum allowed value. +* *Spend Limit (USD)* or *Token Limit* (required): Enter the maximum allowed value. -- . Select *Create Budget*.