How licensing works

Precursive AI is licensed per Agent. Each Zen Agent needs an active entitlement before it can run. Several Agents can share one entitlement, and then they share its limits. Each entitlement is licensed separately, based on the depth of analysis the Agent performs: what the Agent can do, how much data it can process per request and per week, and how many Insights or recommendations it can generate each week.

There is no per-user fee. A Zen Agent can share its Insights with any number of recipients and users. Each user sees the Insights that their Salesforce access allows. See Insight sharing and access control.

Zen Agent and Zen Max Agent

There are two entitlement types, designed for different use cases. The name of each entitlement shows its type.

Feature	Zen Agent	Zen Max Agent
Designed for	Focused analysis of one record at a time	Deep analysis of a whole account or portfolio across many related records
Context per request	Standard, sized for one record and its immediate related data	Much larger, sized for a full account history or portfolio
Weekly throughput	Standard weekly workloads	High-volume, data-heavy workloads
Typical use case	A Project Status Agent that reviews the key details and recent activity for one Project	An Account 360 Agent that reviews all Opportunities, Cases, emails, and call summaries for an account over the past six months

If your Agent focuses on one record and its immediate context, choose a Zen Agent entitlement. If your Agent needs a full picture of an account or portfolio, you need a Zen Max Agent entitlement.

What entitlements control

Each entitlement defines the following limits and capabilities:

• Weekly request limit: the number of AI requests the Agent can make per week. Generating an Insight counts as one request. When Actions Enabled is selected on the Agent, each active linked Action counts as one more request. For example, an Insight with recommendations from one Action uses two requests. A cached response uses no request.
• Weekly context limit: the total amount of text the Agent can read across all requests in a week, measured in tokens. Precursive AI estimates about four characters of text per token. Zen Agents are sized for standard weekly workloads, and Zen Max Agents for high-volume or data-heavy workloads.
• Context limit per request: the maximum amount of text the Agent can consider for one record. Zen Agents support focused analysis of one record and its related data. Zen Max Agents support a full account history or portfolio, with much more context per request.
• Insights Enabled and Actions Enabled: each entitlement turns these capabilities on separately. Insights covers the written analysis. Actions covers recommended actions and, in Autonomous mode, running them. An entitlement can allow either capability or both.

When the Agent reaches a weekly limit, its requests fail, and the affected Insights fail with a "Budget exceeded" error until usage resets. A single run also processes no more records than the Max Requests Per Week of the entitlement, or the Record Limit of the Agent if that is lower. Precursive AI marks the remaining records as failed.

Entitlement statuses

An entitlement has one of the following statuses:

• Active: the Agent can run, between the Valid From and Valid To dates of the entitlement.
• Suspended: the entitlement was active, but the Precursive provisioning system no longer recognizes it.
• Expired: the validity period of the entitlement has ended. Precursive AI sets this status automatically after the Valid To date.
• Revoked: Precursive canceled the entitlement.
• Invalid: Precursive AI could not read the usage limits of the entitlement. Refresh the entitlements, or contact Precursive.

When an entitlement leaves the Active status, Precursive AI deactivates every linked Zen Agent automatically. Precursive AI does not reactivate them when the entitlement is Active again, so reactivate each Agent yourself.

How entitlements are provisioned

Precursive provisions entitlements, and Precursive AI pulls them into your Salesforce org automatically. The refresh runs before each scheduled digest, unless a refresh already ran in the last 60 minutes. Admins with the Precursive AI Admin permission set can also select Refresh Entitlements in Precursive AI Settings > Entitlements at any time.

The provisioning process manages entitlement records, so nobody in your org can create or change them. If a refresh returns entitlements but not one that is Active in your org, Precursive AI suspends that entitlement automatically.

To see what is available before you configure new Agents, open Precursive AI Settings > Entitlements. The Agent Entitlements card lists every entitlement with its status, linked Zen Agent, validity dates, capabilities, and usage this week. An Active entitlement with no linked Agent shows as Available.

Link an entitlement to a Zen Agent

Each Zen Agent needs an active entitlement before it can run:

• You can save an Agent as Active only when its entitlement is Active, within its validity dates, and allows the capabilities that the Agent uses. Otherwise, Precursive AI shows an error such as "An active entitlement must be assigned before this agent can be activated."
• Without an active entitlement, Precursive AI skips scheduled runs, and Run Agent in the Precursive AI component shows this message: "This agent does not have an active entitlement. Please provision an entitlement before running."
• Preview on the Zen Agent record does not check the status of the entitlement, but it needs a linked entitlement and counts against its usage.

Builders link the entitlement in the Entitlement field of the Zen Agent. See Create Zen Agents.

Sandboxes

Your production org and your sandboxes share entitlements. Usage in a sandbox counts against the same weekly limits as production, so plan sandbox testing to leave enough capacity for production.

Monitor usage

The Usage tab of each entitlement shows its usage this week against its limits:

• Requests Used: the number of AI requests the Agent made this week, against Max Requests Per Week.
• Tokens Used: the amount of text the Agent read this week, measured in tokens, against Max Input Tokens Per Week.
• Last Usage Sync: when Precursive AI last synced the usage figures.

Precursive AI pulls usage figures from Precursive for Active entitlements about once an hour, so the figures can be up to an hour behind.

To review usage for an Agent, open the Zen Agent record, select the entitlement in the Entitlement field, and then select the Usage tab.

For questions about your entitlements, usage, or package, contact your Precursive account representative.