entity parameter in embed URL requests. You can set AI credit limits for these groups to control how much AI usage is allowed for users within each entity. This is useful when embedding Omni for multiple customers or tenants and you want to manage AI consumption on a per-entity basis.
How embed entity group limits work
Along with organization-level and user-level AI credit controls, embed entity group controls allow you to limit AI credit consumption at the entity group level. You can set group-specific limits and a default that applies to all entity groups, allowing you to control how many credits specific groups can consume. For example, you can set a higher limit for groups with more contracted usage and let other groups use the entity group default.Requirements
To manage AI credit limits for embed entity groups, you’ll need:- Organization Admin permissions
- The Embed feature enabled in your Omni instance
Setting an embed entity group default
An embed entity group default applies to all entity groups. When set, the limit will act as the default for any group that doesn’t have a specific limit.- Omni UI
- API
- Navigate to AI Hub > General.
- Click the Credits tab.
- In the Embed entity settings section, enter the number of credits in the default limit field, or leave it empty to allow unlimited credits by default.
- Click Save.
Setting per-group credit limits
Each embed entity group has its own detail page where you can configure a credit limit specific to that group. When set:- The group-level limit will override the embed entity group default
- An entity group user’s usage will count against their individual user limit (if set) and their entity group’s limit
- Omni UI
- API
- Embed
- Navigate to AI Hub > General.
- Click the Credit usage tab.
- Click the By entity toggle to display a list of entities.
- In the row for the entity group, click the Edit limit button.
- In the dialog that displays, configure the entity’s credit limit:
- To set a cap, enter a whole number (ex:
40) in the Credit limit field - To allow unrestricted usage, click the Unlimited toggle
- To reset to the embed entity group default, click Reset to default
- To set a cap, enter a whole number (ex:
- Click Save.
Monitoring entity group credit usage
- Omni UI
- API
To view entity group credit usage in the Omni UI:
- Navigate to AI Hub > General.
- Click the Credit usage tab.
- Click the By entity toggle to switch to the entity group view.
Next steps
- Managing AI credit usage — Learn about AI credits, organization-level and user-level controls, and monitoring tools
- Managing embed users — View, manage, and impersonate users in your embedded Omni application