Smart Agents Credits
This page shows your credit balance, usage breakdown, and subscription status.
Merged manual: This file covers two tightly coupled pages — the Credits overview card and the Buy Credits dialog that opens from it.
Smart Agents Credits
Page type: Card Object:
Page 72778303 "Smart Agent Credits QUA"—Page.72778303.SmartAgentCredits.al
This page shows your credit balance, usage breakdown, and subscription status. It supports two billing models: Prepaid (purchase credits via Stripe) and Subscription (usage billed through Microsoft). The sections visible on screen depend on which billing model is active for your tenant.
In plain terms
This is the fuel gauge for Smart Agents. Everything an agent does costs a little, and this page is where you watch the balance and top it up.
How the cost works, plainly: AI models read and write text in chunks called tokens (roughly ¾ of a word each). The more text a request involves — the user's question, the agent's instructions, the data it pulled, its memory, and the reply — the more tokens it uses. Smart Agents converts that token usage into credits, scaled by the agent's model tier (a Premium message costs more credits than a Fast one). You never count tokens yourself — you just watch credits.
Credits are a balance you draw down as agents work and top up when they run low. The Low Credit Warning (set in Setup) acts as a reorder point — it warns you before the balance runs dry.
Two billing modes — your subscription decides which one you see:
- Prepaid — you buy a credit balance up front through Stripe and draw it down (you'll see Your Balance).
- Subscription — usage is metered and billed through Microsoft (you'll see Metered Usage).
Good to know: if a user clicks Stop while an agent is working, that request costs no credits. Big instructions, large knowledge files, and high search-result limits all raise the token count per message — so keeping them lean keeps credit spend down. Use the Usage breakdown to see which agents consume the most.
How to open it
- Role Center Smart Agents group → Credits.
- Tell Me (Alt+Q) → search "Smart Agents Credits".
Fields
Billing
| Field | Type | Description |
|---|---|---|
| Billing Mode | Text | How your credit usage is billed. Prepaid = buy credits via Stripe. Subscription = billed through Microsoft. Read-only. |
| Subscription Status | Text | The status of your Microsoft SaaS subscription. Read-only. Visible in Subscription mode only. |
Your Balance
This group is visible in Prepaid mode only.
| Field | Type | Description |
|---|---|---|
| Credits Available | Text | Your current credit balance. Read-only. |
| Approximate Value | Text | The approximate monetary value of your remaining credits. Read-only. |
Metered Usage
This group is visible in Subscription mode only.
| Field | Type | Description |
|---|---|---|
| Credits Used This Month | Text | Total credit usage reported to Microsoft for the current billing period. Read-only. |
| Billing Note | Text | Usage is billed through your Microsoft subscription. Read-only. |
Per-Seat License
This group is visible when your subscription is a per-seat plan.
| Field | Type | Description |
|---|---|---|
| Pool Total Credits | Decimal | Total credit pool available for all seats in this subscription period. Read-only. |
| Pool Consumed Credits | Decimal | Credits consumed from the pool so far this period. Read-only. |
| Pool Remaining Credits | Decimal | Credits still available in the pool (Total minus Consumed). Read-only. |
| Seat Quantity | Integer | Number of per-seat licenses purchased in this subscription. Read-only. |
| Your License | Boolean | Whether you have been assigned a per-seat license in the Microsoft 365 admin center. Read-only. |
| Last License Check | DateTime | When the backend last verified your per-seat license status. Read-only. |
Usage This Month
| Field | Type | Description |
|---|---|---|
| By Agent (sub-list) | — | A breakdown of credit usage by agent for the current month. |
Actions
| Action | What it does |
|---|---|
| Buy Credits | Purchase additional credits via Stripe payment. Opens the Buy Smart Agent Credits dialog. Visible in Prepaid mode only. |
| Manage Subscription | Manage your Microsoft SaaS subscription in the Microsoft 365 admin center. Visible in Subscription mode only. |
| Refresh | Refresh billing information from the server. |
Related pages
Notes
- The Credits Available balance is colour-coded: green when above the low-credit warning threshold, red when below it. The threshold is set in Smart Agent Setup.
- The Subscription Status field is colour-coded: green for Active, red for Suspended.
- When you click Buy Credits, a Stripe Checkout page opens in your browser. Return to Business Central after payment — use Refresh to update your balance.
Buy Smart Agent Credits
Page type: StandardDialog Object:
Page 72778308 "Smart Agent Buy Credits QUA"—Page.72778308.SmartAgentBuyCredits.al
This dialog lets you choose how many credits to purchase. It shows the unit price and the total cost before you proceed to payment. It opens when you choose Buy Credits on the Smart Agents Credits page.
In plain terms
This is the top-up dialog — it appears only in Prepaid mode. You type how many credits you want, see the price, and the app hands you off to a Stripe checkout page in your browser to pay. Think of it like buying a postage stamp roll: pick the quantity, confirm the total, pay, and the balance is added when you return. The minimum purchase is 50 credits.
How to open it
- Opened from the Buy Credits action on the Smart Agents Credits page.
Fields
Purchase Credits
| Field | Type | Description |
|---|---|---|
| Credits to Buy | Integer | Enter the number of credits you want to purchase. Minimum 50 credits. Required. |
| Price per Credit | Text | The price per credit in EUR. Read-only. |
| Total Price | Text | The total price for the selected number of credits. Read-only. |
Current Balance
| Field | Type | Description |
|---|---|---|
| Credits Available | Text | Your current credit balance before this purchase. Read-only. |
Notes
- The minimum purchase is 50 credits. Entering a lower number shows an error.
- Clicking OK opens the Stripe Checkout page in your browser to complete the payment.
- The price per credit is EUR 0.01; the total price updates automatically as you type.