Microsoft Copilot Studio — minimum Dataverse security role¶
Trust3 discovers Copilot Studio agents through Dataverse with read-only access. You can assign the built-in Service Reader role to the application user, or create a narrower custom role with only the table privileges Trust3 needs.
Use Service Reader when you want the fastest setup. Use the custom role below when you want least privilege.
For Entra app registration, client secret, and application user setup, see Microsoft Copilot Studio Prerequisites.
Create the custom role¶
- Open the Power Platform admin center.
- Go to Manage > Environments and select the target environment.
- Open Settings > Users + permissions > Security roles.
- Select New role.
-
In the Create New Role dialog, fill in the required fields, for example:
Field Example value Role Name Trust3 Copilot Inventory ReaderBusiness unit Same business unit as your environment Description Read-only Dataverse access for Trust3 Copilot inventory Applies To Trust3 AI Assets Collector Summary of Core Table Privileges Read Organization on Team, User, Agent ( bot), and Agent component (botcomponent) -
Leave Member's privilege inheritance at the default (Direct User (Basic) access level and Team privileges) unless your organization requires a different setting.
- You can clear Include App Opener privileges for running Model-Driven apps — Trust3 does not need Model-Driven app access.
- Select Save.
Add the table privileges¶
- Open the new role.
- In the tables view, open the filter dropdown and select Show all tables.
-
Search for each of these tables and set Read to Organization. Leave Create, Write, Delete, and other privileges as None.
Table (UI name) System name Team teamUser systemuserAgent botAgent component botcomponentUI names
In Power Platform, Copilot Studio bots appear as Agent and Agent component. Older docs may still say Bot / Bot Component; the system names remain
botandbotcomponent. -
Select Save.
New roles can include other default privileges. Remove any privileges that are not in the required list so the role stays limited to Team, User, Agent, and Agent component.
Optional: After cleanup, select Show only assigned tables to verify that only the four assigned tables are displayed.
Assign the role to the application user¶
- In the same environment, open Settings > Users + permissions > Application users.
- Open the Trust3 application user (or create it by following Microsoft Copilot Studio Prerequisites).
- Edit security roles.
- Assign either:
- Service Reader, or
- your custom role (for example Trust3 Copilot Inventory Reader)
- Save the application user.
After role changes, wait 5–10 minutes for Power Platform permissions to propagate, then rerun collection.
Summary¶
| Option | When to use |
|---|---|
| Service Reader | Quick setup; broader built-in read access than Trust3 requires |
| Custom role (Team, User, Agent, Agent component — Read / Organization only) | Least privilege for Copilot Studio inventory |