The five Foundry roles, and the two Azure roles that can't build
Use agents → Agent Consumer. Build → Foundry User. Lead a team and publish → Project Manager. Set up resources, no building → Account Owner. Everything → Foundry Owner.
How it works
- Decide what the principal must do: call, build, publish, set up
- Pick the smallest role that does it
- Pick the smallest scope: agent, project, or resource
Must know
- Foundry Agent Consumer: call agent endpoints only. Assignable down to one agent.
- Foundry User (was Azure AI User): build, test, evaluate in a project; read access. Least privilege for developers and for the project's managed identity.
- Foundry Project Manager: build + manage projects + assign *only* Foundry User + publish agents (the minimum role to publish).
- Foundry Account Owner: create resources and projects, manage models, assign Foundry User / ACR / monitoring roles. No data actions: can't build.
- Foundry Owner: all of the above, building included.
- Azure Owner and Contributor manage resources (Contributor can deploy models) but have no data actions.
Traps
- Owner or Contributor on the subscription still can't create an agent: add Foundry User.
- Azure AI Developer is for hubs and Azure Machine Learning, not Foundry projects.
- Don't use *Cognitive Services …* roles for Foundry, except Cognitive Services Usages Reader for quota.
- Renamed roles keep their role IDs; scripts should use the ID.
Check yourself: d1-r1 · d1-r2 · d1-r3 · Microsoft Learn