diff --git a/docs/tools.md b/docs/tools.md index e629f8e..37d30a8 100644 --- a/docs/tools.md +++ b/docs/tools.md @@ -189,8 +189,9 @@ tools, it needs no uploaded report — it is reference material you can open at cost center / organization / enterprise budgets. - **Common use-case recipes**, including preventing overages and the noisy-neighbour problem, and isolating each cost center's usage (with overages). -- A reference for the cost centers REST API `ai_credit_pool_enabled` field, which caps - how much of the shared pool a cost center can draw before the metered phase begins. +- UI-first steps for enabling an **AI credit pool** while creating or editing a cost + center, choosing what happens at its automatically calculated limit, and separately + capping metered charges with a cost center budget. **How to read it** diff --git a/src/components/app.module.css b/src/components/app.module.css index 9407d1b..50fc52c 100644 --- a/src/components/app.module.css +++ b/src/components/app.module.css @@ -1353,8 +1353,8 @@ } } -/* Shared section header used by Common use cases, Isolating, and References so - the major blocks read consistently and have room to breathe. */ +/* Shared section header used by Common use cases and References so the major + blocks read consistently and have room to breathe. */ .sectionHeading { font-size: 18px; line-height: 1.25; @@ -1726,38 +1726,6 @@ background: var(--bgColor-muted); } -/* ai_credit_pool_enabled reference table. */ -.poolTableWrap { - overflow-x: auto; -} - -.poolTable { - width: 100%; - border-collapse: collapse; - font-size: 13px; -} - -.poolTable th, -.poolTable td { - text-align: left; - padding: 8px 10px; - border-bottom: 1px solid var(--borderColor-muted, #d8dee4); - vertical-align: top; - line-height: 1.5; -} - -.poolTable th { - color: var(--fgColor-muted); - font-weight: 600; - font-size: 12px; - text-transform: uppercase; - letter-spacing: 0.03em; -} - -.poolTable td:first-child { - white-space: nowrap; -} - /* Sources list. */ .sourceList { list-style: none; diff --git a/src/components/tools/budget-guidance.tsx b/src/components/tools/budget-guidance.tsx index 9036a9d..0b760e5 100644 --- a/src/components/tools/budget-guidance.tsx +++ b/src/components/tools/budget-guidance.tsx @@ -198,7 +198,7 @@ const GLYPH: Record = { ulb: { icon: PersonIcon, label: "User-level budget" }, costCenter: { icon: OrganizationIcon, label: "Cost center" }, enterprise: { icon: GlobeIcon, label: "Enterprise budget" }, - included: { icon: ShieldCheckIcon, label: "Included-usage control" }, + included: { icon: ShieldCheckIcon, label: "AI credit pool" }, stop: { icon: StopIcon, label: "Stop usage" }, }; @@ -222,18 +222,18 @@ const USE_CASES: UseCase[] = [ { icon: OrganizationIcon, title: "Isolate each cost center (including overages)", - controls: ["Cost centers", "Included-usage control", "Cost center budget", "Enterprise failsafe"], + controls: ["Cost centers", "AI credit pool", "Cost center budget", "Enterprise failsafe"], situation: "Give each team its own self-contained budget so heavy use by one team never eats another team's share of the pool — and each team owns its overages.", steps: [ - { glyph: "costCenter", text: "Create a cost center per team and assign users (or enterprise teams) directly, not just organizations." }, - { glyph: "included", text: "Turn on the included-usage control (set ai_credit_pool_enabled = true via the cost centers REST API) so the team can only draw the pool its own licenses fund." }, - { glyph: "included", text: "At that cap, choose to block the team or let usage continue as paid overage." }, - { glyph: "costCenter", text: "Set a cost center budget to cap the team's metered charges, and enable “Stop usage”." }, + { glyph: "costCenter", text: "Create a cost center per team and assign users or enterprise teams directly." }, + { glyph: "included", text: "When creating or editing the cost center in the billing UI, turn on “AI credit pool.” GitHub calculates the limit from its assigned Copilot licenses, so you do not enter an amount." }, + { glyph: "included", text: "Choose whether to block further included usage at the limit or continue as paid overage, if your enterprise allows overages." }, + { glyph: "costCenter", text: "Separately set a cost center budget with “Stop usage” enabled to cap metered charges after the pool is exhausted." }, { glyph: "costCenter", text: "Optionally enable cost center exclusion so the team spends independently of the enterprise budget." }, { glyph: "enterprise", text: "Keep an enterprise budget as a failsafe for anyone not in a cost center." }, ], - note: "See the ai_credit_pool_enabled reference below.", + note: "AI credit pools support directly assigned users and enterprise teams, not organization resources.", }, { icon: LawIcon, @@ -252,13 +252,13 @@ const USE_CASES: UseCase[] = [ { icon: PersonIcon, title: "Delegate oversight to organization owners", - controls: ["Cost center", "Organization assignment", "Included-usage control", "Cost center ULB", "Cost center budget", "Enterprise budget"], + controls: ["Cost center", "Organization assignment", "AI credit pool", "Cost center ULB", "Cost center budget", "Enterprise budget"], situation: "Give each organization its own spending guardrail and keep its owners informed, while enterprise billing roles retain control.", steps: [ { glyph: "costCenter", text: "An enterprise owner or billing manager creates a cost center for the organization and assigns the organization as a resource." }, { glyph: "ulb", text: "Optionally set the universal user-level budget to $0 and give this cost center a nonzero user-level budget. The cost center override lets its users consume credits while users outside a cost center remain blocked." }, - { glyph: "included", text: "For full isolation from the shared pool, replace the organization resource with direct users or an enterprise team, then enable the included-usage control. Organization resources are not supported when this control is enabled." }, + { glyph: "included", text: "For full isolation from the shared pool, replace the organization resource with direct users or an enterprise team, then turn on “AI credit pool” when editing the cost center. Organization resources are not supported while it is enabled." }, { glyph: "costCenter", text: "Set an AI-credit cost center budget and add the organization owners as threshold-alert recipients." }, { glyph: "stop", text: "Enable “Stop usage when budget limit is reached” on the cost center budget." }, { glyph: "enterprise", text: "Keep an enterprise budget as a safety net for usage not attributed to a cost center." }, @@ -394,61 +394,6 @@ function GuidanceMain() { - {/* Isolating a cost center: section header + card */} -
- - Isolating a cost center's usage - - - An included-usage control caps how much of the shared pool a - cost center can draw before the metered phase begins — the key to true team - isolation. It is set per cost center with the{" "} - ai_credit_pool_enabled field, which is currently only available - through the cost centers REST API — there is no UI for it yet. - -
-
- - - - - - - - - - - - - - - - - -
SettingEffect
- false (default) - No cap — the cost center draws freely from the shared enterprise pool.
- true - - Capped at the credits its own licenses fund. At the cap, block members or - let usage continue as paid overage. -
-
- - Set it with the{" "} - - cost centers REST API - - {" "}— it isn't in the cost center settings UI yet. Pair it with a cost center - budget to cap metered charges. - -
-
- {/* Sources */}
@@ -490,14 +435,27 @@ function GuidanceMain() {
  • + Controlling and tracking costs at scale + + + {" "}— creating cost centers and budgets in the billing UI. + +
    • +
  • + - Cost centers REST API + AI credit pools for cost centers in the billing UI{" "} + - {" "}— the ai_credit_pool_enabled field and endpoints. + {" "}— enabling and configuring a cost center's included-credit limit.