docs

Author: Paulo Lacerda

docs/deploy.md

@@ -4,6 +4,26 @@ Choose your preferred deployment method based on project requirements and enviro
 
 > You can change parameter values in `main.parameters.json` or set them with `azd env set` before running `azd provision`. This applies only to parameters that support environment variable substitution.
 
+## Prerequisites
+
+<details markdown="block">
+<summary>Expand to view prerequisites</summary>
+
+To deploy this template, the user or service principal requires the following permissions on the target Resource Group:
+
+* An Azure subscription.
+* An Azure user with **Contributor** and **User Access Admin** permissions on the target resource group.
+
+In addition, the machine or environment used for deployment should have:
+
+- Azure Developer CLI: [Install azd](https://learn.microsoft.com/en-us/azure/developer/azure-developer-cli/install-azd)
+- PowerShell 7+ (Windows only): [Install PowerShell](https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-windows?view=powershell-7.4#installing-the-msi-package)
+- Git: [Download Git](https://git-scm.com/downloads)
+- Python 3.12: [Download Python](https://www.python.org/downloads/release/python-3120/)
+- An Azure AI Services resource created or agreement to Responsible AI terms in the portal
+
+</details>
+
 ## Quick Start - Basic Deployment
 
 Quick setup for demos without network isolation.