Witivio Documentation

# Agent Control Pro Limits

Knowing what Agent Control Pro can and cannot do helps you interpret its answers correctly. These limits keep governance answers fast and trustworthy.

# At a glance

Setting Limit
Catalog page cap 5 pages / 1,000 agents per call
Free trial catalog cap 5 agents per catalog answer in Copilot Chat, on either kind of free trial (the admin portal is not capped)
Portal free trial length 7 days, then access ends by itself
AppSource trial length The end date Microsoft sends, or 7 days if none is sent; access continues until Microsoft reports the subscription ended
Top-N list default Top 20 agents
Usage rows top default 200 agents per query (configurable)
Report retention Latest upload only (re-uploading replaces the previous file)
Live usage ingestion Not yet available; manual CSV upload required (live ingestion is on the roadmap)
Per-user role gating Not supported; any authenticated administrator in a consented tenant sees the same view

# Catalog

  • Paging cap: a single catalog call reads up to 5 pages, or 1,000 agents. This applies to every tenant, trial or paid.
  • Top-N default: list answers return the top 20 agents unless you ask for more.
Do not confuse the two catalog caps. The catalog page cap (5 pages, up to 1,000 agents per call) is a paging limit that applies to every tenant. The free trial catalog cap is different: while your tenant is on a free trial of either kind, every catalog answer in Copilot Chat is limited to 5 agents in total, and the admin portal is not capped. The assistant states explicitly that the trial limit was applied and recommends purchasing a subscription on AppSource, rather than presenting a truncated list as your full inventory. If your inventory looks unexpectedly short during a trial, this cap is why.

# Reports

  • Retention: only the latest upload is kept, for both the Copilot usage report and the Power Platform billing report. Re-uploading replaces the previous file.
  • Usage rows default: row-level queries return 200 agents per query by default, and this is configurable.
  • No live ingestion: Microsoft Graph does not yet expose the Copilot usage report as a live API surface, so the manual CSV upload is required. Live ingestion is on the roadmap.
Agent Control Pro emails the subscription purchaser twice a month (the first and third Monday, 8:00 AM UTC) to say how old your current upload is, so you can tell at a glance whether adoption answers are still trustworthy.

# Free trial

There are two kinds of free trial, and they end in different ways.

Portal trial. You start this one yourself: open the Subscription page of your Agent Control Pro portal and select Start a free trial. There is no credit card and no AppSource purchase, and each tenant gets one portal trial. It runs for seven days from the moment you start it, then access ends by itself. After that, administrators who sign in are sent back to the trial page and only a purchase reopens access.

AppSource trial. You start this one from the Agent Control Pro offer on Microsoft AppSource. Microsoft owns the end date, and Agent Control Pro shows the date Microsoft sends (seven days is used only when Microsoft sends no date). Access does not stop on that date. An AppSource subscription keeps granting access until Microsoft reports that it ended, either because you moved to a paid plan or because the subscription was canceled or suspended. That is deliberate: a late notification from Microsoft must never lock out a tenant that has just started paying.

While either trial is active:

  • Every catalog answer in Copilot Chat is capped at five agents in total. The admin portal is not capped.
  • Each assistant response carries a banner stating that trial mode is active, when it ends, and how many days remain.

Data handling is identical between trial and paid subscriptions. Subscribing on AppSource lifts the catalog cap. If an AppSource trial runs past its end date, the banner and the five-agent cap are no longer applied, even though access continues.

# Subscription

Both the Agent Control Pro MCP endpoint and the admin web UI are gated on your tenant having a subscription that currently grants access, paid or trial. Until it does, MCP requests are rejected, and an administrator who signs in to the portal is sent to the free trial page, where the two options are starting the portal trial or opening the AppSource offer.

# Administration

  • No per-user role gating. Any authenticated administrator in a consented tenant sees the same governance view of the same tenant. There is no per-user role configuration and no per-user dashboard.
  • Read-only. Agent Control Pro never modifies, retires, or deletes agents. You act in the native Microsoft 365 admin tools.

# Detection

  • Deterministic matching only. Duplicate detection compares agent names, descriptions, and instructions using deterministic matching, with conservative thresholds. You see fewer false positives at the cost of some near-duplicates being missed. Multilingual and embedding-based matching is on the roadmap.
  • Activity window: the active and dormant cutoff is 30 days of activity.
  • Org-wide candidate threshold: 50 or more active users.

# Need more detail?

For anything not covered here, see the Agent Control Pro fundamentals for how classifications and thresholds are applied, the Q&A for common questions, or the architecture and security page for data handling and Microsoft Graph limits.

← What's new →