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 while your tenant is on an AppSource free trial
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 an AppSource free trial, every catalog answer is limited to 5 agents in total. 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

While your tenant is on an AppSource free trial:

  • Every catalog answer is capped at five agents in total.
  • Each response carries a banner stating that trial mode is active and when it ends.
  • Trials run for seven days by default.

Data handling is identical between trial and paid subscriptions. Subscribing on AppSource lifts the catalog cap.

# Subscription

Both the Agent Control Pro MCP endpoint and the admin web UI are gated on your tenant having an active subscription, either paid or trial. Until the subscription is activated on AppSource, requests to either surface are rejected.

# 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.

← Overview →